À propos de File Exchange
File Exchange vous permet de trouver et de partager des applications personnalisées, des classes, des exemples de code, des pilotes, des fonctions, des modèles Simulink, des scripts et des vidéos. Vous pouvez utiliser File Exchange pour :
- Soumettre des fichiers
- Vous connecter à des dépôts GitHub
- Partager un site web contenant votre code MATLAB
- Obtenir des informations relatives aux licences
- Spécifier des instructions pour référencer vos travaux
- Trouver des fichiers à partir des types de contenu, dans la zone de recherche ou en utilisant des instructions de recherche
- Annoter des soumissions en ajoutant des tags pour de futures recherches, rédiger des évaluations et participer à des discussions sur la base de votre expérience
- Vous faire connaître de la communauté en soumettant des fichiers que les membres pourront utiliser, marquer et évaluer
- Gagner des badges
- Bâtir votre réputation
- Questions et commentaires
L'utilisation de File Exchange est soumise aux Conditions générales d'utilisation de MATLAB.
Soumettre des fichiers
Vous pouvez soumettre des fichiers d'une taille maximale de 250 Mo. Pour soumettre un fichier, connectez-vous à votre Profil de communauté. Si vous n'avez pas de profil, vous devrez en créer un. Sur la page de votre compte, cliquez sur « Publier » pour télécharger un fichier depuis votre ordinateur ou créer une connexion vers un dépôt GitHub.
Connexion aux dépôts GitHub
Une connexion entre File Exchange et GitHub permet aux contributeurs de développer des projets software dans un environnement unique sans avoir à télécharger des fichiers sur les deux sites. En tant que contributeur, vous bénéficiez de tous les avantages du développement collaboratif dans GitHub, et les membres de la communauté ont accès à la dernière version de vos projets, aussi bien à partir de File Exchange que de GitHub. Les membres de la communauté qui téléchargent des fichiers connectés à GitHub portent la responsabilité de la validation du contenu et des licences de ces fichiers.
Si une connexion à un dépôt GitHub a été établie, File Exchange stocke le contenu du dépôt sur des serveurs MathWorks pour le mettre à disposition dans File Exchange et Add-On Explorer. Les fichiers stockés sur les serveurs MathWorks sont en lecture seule et sont mis à jour automatiquement pour refléter les modifications réalisées dans GitHub. Ce stockage de contenu permet à MathWorks de proposer des fonctionnalités très pratiques comme la prévisualisation de code MATLAB.
Pour connecter votre dépôt à GitHub, sélectionnez l'une des options suivantes :
- GitHub Releases – Cette approche est recommandée pour la connexion. Lorsque votre dépôt est prêt pour la distribution, utilisez les GitHub Releases pour packager votre code. En utilisant Github Releases, votre soumission File Exchange sera automatiquement mise à jour lorsque vous créerez une nouvelle release dans GitHub
Lorsque vous créez une GitHub Release :
- - Si vous packagez votre code sous forme de toolbox, attachez votre toolbox (fichier .mltbx) à la release. File Exchange proposera ensuite la toolbox en téléchargement. Si vous n'attachez pas de fichier .mltbx à la release, File Exchange utilisera le fichier zip de la release.
- - Voici quelques remarques utiles pour la labellisation des versions :
- - Nommez la version suivant le format : major.minor.patch.extension (patch et extension sont facultatifs).
- - Les segments du numéro de version doivent comporter moins de six chiffres.
- - Les libellés alphanumériques ne sont pas reconnus (par exemple, 2-beta).
- - Lorsque vous attachez un fichier .mltbx à la release, utilisez pour le package un numéro de version identique à celui de la release GitHub.
- - Vous trouverez plus d'informations sur les GitHub Releases dans la documentation GitHub.
- Default Branch – Avec cette méthode, File Exchange utilise la branche par défaut du dépôt (généralement « main » ou « master ») pour afficher la prévisualisation des fichiers et fournir le package à télécharger. Les changements réalisés sur la branche par défaut sont disponibles dans les 24 heures. En fonction de votre processus de développement, rendre la branche par défaut disponible dans File Exchange peut donner à vos utilisateurs un accès à un code instable. Nous recommandons d'utiliser des GitHub Releases pour garantir une distribution de code stable.
- Si vous utilisez Git LFS, packagez votre code sous forme de toolbox et joignez le fichier .mltbx à la release GitHub de votre dépôt. Git LFS n'est pas supporté pour les connexions de type "Default Branch" dans File Exchange.
Simplifiez la recherche et l'utilisation des fichiers
- Veillez à ce que vos titres et descriptions soient clairs et concis, et contiennent les informations pertinentes.
- Relisez vos soumissions pour en vérifier la lisibilité et contrôler l'absence de fautes.
- Utilisez des tags qui optimisent les recherches : consultez la rubrique Création de tags.
- Lorsque vous ajoutez des images, assurez-vous que les images portent le même nom de fichier et se trouvent dans le même répertoire que votre code.
- Faites référence aux fichiers qui ont inspiré votre soumission. Les références apparaissent sur la page associée au fichier et sur la page associée au fichier cité.
Partager un site web contenant votre code MATLAB
Vous pouvez partager le site web contenant votre projet MATLAB en utilisant l'option « Link to an External Website » (Lien vers un site web externe) lors de votre contribution dans File Exchange. Avec cette option :
- La page des détails associée à votre soumission contient le lien vers votre site web.
- La communauté peut commenter votre projet sur cette page.
- Le code de votre site web ne peut pas être téléchargé directement depuis File Exchange.
Informations relatives aux licences
Les informations de licence clarifient les droits dont vous disposez en tant qu'auteur et en tant qu'utilisateur du code disponible sur File Exchange. Ces informations indiquent comment le code peut être utilisé et couvrent des questions courantes comme les droits de modification, de distribution et d'utilisation commerciale.
La licence BSD est la seule licence supportée pour le code posté directement sur File Exchange, et elle est ajoutée automatiquement au contenu que vous soumettez directement dans File Exchange en cliquant sur « Upload Files » (Télécharger des fichiers). D'autres types de licence sont autorisées dans le cadre de contributions à la communauté utilisant les options « Connect to GitHub » (Lier à GitHub) ou « Link to an External Website » (Lien vers un site web externe). Certaines soumissions de collaborateurs de MathWorks, y compris les Hardware Support Packages, peuvent être couvertes par la licence MathWorks Limited License. Les soumissions File Exchange sous licence sont assorties d'un lien « View License » (Voir la licence). Vous trouverez de plus amples informations sur ce sujet dans la FAQ sur les licences dans File Exchange.
Spécifier des instructions pour les références à vos travaux
Les instructions pour citation aident les membres de la communauté à faire référence à votre travail lorsqu'ils l'utilisent dans leurs propres recherches ou dans des travaux dérivés. Vous pouvez par exemple souhaiter que d'autres personnes fassent référence à votre page de détails File Exchange, à un article de recherche que vous avez écrit, à un groupe auquel vous êtes affilié, ou à une combinaison d'artefacts.
Les nouvelles entrées File Exchange sont créées avec des instructions de citation par défaut, que vous pouvez supprimer. Par ailleurs, vous pouvez :
- Donner des instructions de citation en saisissant un texte personnalisé
- Spécifier un DOI, que vous devrez générer ailleurs, comme expliqué sur la page DOI.org
- Créer plusieurs instructions de citation
Rechercher des fichiers
File Exchange offre une vaste bibliothèque de fichiers en ligne. Pour trouver des fichiers, vous pouvez :
- Parcourir les fichiers associés à un type de contenu attribué
- Faire une recherche
- Spécifier une recherche en utilisant des instructions
Une fois le fichier trouvé, vous pouvez l'ouvrir pour en voir les détails, ajouter des tags,, une évaluation ou des commentaires, ou encore télécharger la soumission.
Recherche de fichiers liés au calcul numérique. Notez les zones (à gauche) pour les différents filtres.
Naviguer à partir des types de contenu
File Exchange attribue des types de contenu aux fichiers en fonction des informations associées à la soumission.
| Ce type est attribué au contenu | lorsque les fichiers ont cette extension | et que la soumission comporte ces éléments |
|---|---|---|
Application |
.mlappinstall |
- |
Pilote |
.mdd |
- |
Exemple |
.m |
sous-répertoire /html fichier .html avec le même nom que le fichier MATLAB .m |
Fonction |
.m |
appel |
Modèle Simulink |
.mdl |
- |
Vidéo |
.avi, .mp4, .wmv, .mpg, .mov, .swf, .mpeg |
- |
Conseil : Lorsque vous soumettez des fichiers, si un fichier de votre soumission s'affiche avec un message « Preview image not found » (Aperçu de l'image non trouvé) au lieu de l'aperçu de l'image, ajoutez une image avec le même nom de fichier que votre code dans le même répertoire et File Exchange affichera l'image avec votre fichier. Exemple : pour un fichier nommé « foo.mdl », l'ajout d'une capture d'écran nommée foo.gif déclenchera l'affichage d'une capture de votre modèle Simulink plutôt que ce message.
Obtenir des informations relatives aux licences
Les informations de licence clarifient les droits dont vous disposez en tant qu'auteur et en tant qu'utilisateur du code disponible sur File Exchange. Les informations de licence indiquent comment le fichier peut être utilisé et couvrent les questions courantes comme les droits de modification, de distribution et d'utilisation commerciale.
La licence BSD est la seule licence supportée pour le code posté directement sur File Exchange, et elle est ajoutée automatiquement au contenu que vous soumettez directement dans File Exchange en cliquant sur « Upload Files » (Télécharger des fichiers). D'autres types de licence sont autorisées dans le cadre de contributions à la communauté utilisant les options « Connect to GitHub » (Lier à GitHub) ou « Link to an External Website » (Lien vers un site web externe). Certaines soumissions de collaborateurs de MathWorks, y compris les Hardware Support Packages, peuvent être couvertes par la licence MathWorks Limited License. Les soumissions File Exchange sous licence sont assorties d'un lien « View License » (Voir la licence). Vous trouverez de plus amples informations sur ce sujet dans la FAQ sur les licences dans File Exchange.
Rechercher des fichiers en utilisant des instructions
L'utilisation d'instructions facilite la recherche de fichiers dans File Exchange. Vous pouvez indiquer des instructions dans la zone de recherche.
| Résultat de la recherche | Instruction | Exemples |
|---|---|---|
Auteur avec ce nom |
author: |
|
Auteur avec une note moyenne de 1 à 5 |
authoraverage: |
|
Membre de la communauté dont le profil public comporte ce nom d'organisation ou d'entreprise |
organization: |
|
Type de contenu |
type: |
|
Numéro d'identification du fichier, qui apparaît en haut de la page Détails du fichier |
id: |
|
Licence incluant cette chaîne de caractères |
license: |
|
Notation moyenne de la communauté |
rating : |
|
Soumissions publiées avec un tag comportant cette |
tag : |
|
Recherche de fichiers avec DOI ou citation personnalisée |
citation_type: |
Utilisation des instructions
- Pour rechercher une expression composée de plusieurs mots, mettez-la entre guillemets ; par exemple,
author:"Helen Chen". - Combinez plusieurs instructions pour affiner votre recherche. N'oubliez pas de mettre un espace entre deux instructions. File Exchange recherche tous les fichiers correspondant à l'ensemble des instructions spécifiées.
- Pour lancer une recherche avec plus d'une valeur pour la même instruction, définissez une instruction pour chacune des valeurs souhaitées. Par exemple, la syntaxe
tag:graphicstag:vectorpermet de trouver tous les fichiers avec les tagsgraphicsetvector. - Pour exclure des fichiers, insérez un signe moins (-) avant la syntaxe de l'instruction. Par exemple, la syntaxe
-tag:gameexclut tous les fichiers avec le taggame.
Annoter des fichiers en ajoutant des tags
Les tags offrent des informations de type bookmark pour aider à trouver ou retrouver des fichiers intéressants. Grâce aux tags, vous pouvez parcourir les fichiers soumis en utilisant les mots-clés qui leur ont été attribués. Les membres de la communauté possédant un profil peuvent taguer n'importe quel fichier. Tous les tags sont publics ; tout le monde peut les voir.
Depuis votre profil, vous pouvez voir les tags que vous avez choisi d'appliquer à certains fichiers. Dans un fichier, vous pouvez voir les tags appliqués par les membres de la communauté. En attribuant des tags, vous donnez aux membres de la communauté un aperçu de vos centres d'intérêt, ce qui facilite la collaboration et l'échange d'idées.
Vous pouvez ajouter des tags lorsque vous soumettez de nouveaux fichiers ou que vous consultez des fichiers existants. Utilisez des virgules pour séparer les tags et des guillemets pour spécifier des tags comportant plusieurs mots.
Création de tags
- Les tags doivent être courts mais suffisamment descriptifs.
- Utilisez une terminologie appropriée et cohérente, notamment des termes que les membres de la communauté sont le plus susceptibles d'utiliser, par exemple vidéo, image ou graphique.
- Taguez des éléments importants, comme les concepts, les fonctions et les noms propres.
- Choisissez des noms plutôt que des verbes.
- N'utilisez pas d'abréviations ou d'acronymes, sauf s'ils sont d'un usage courant.
- Vérifiez l'orthographe.
Ajouter des évaluations à des fichiers soumis.
Ajout d'évaluations à des fichiers
- Soyez honnête et respectueux de l'auteur du fichier et des autres membres de la communauté.
- Soyez précis sur ce que vous aimez et n'aimez pas dans la soumission.
- Donnez des exemples pour illustrer votre point de vue.
- Partagez vos expériences avec des soumissions similaires.
- Les commentaires à caractère blasphématoire, vulgaire ou offensant seront supprimés du site.
Discussions sur des fichiers soumis.
Conseils pour tirer le meilleur parti des discussions
- Utilisez les discussions pour demander des éclaircissements sur une question, une réponse ou un commentaire.
- Rédigez des commentaires courts et pertinents.
- Soyez honnête et respectueux dans vos réponses à l'ensemble des contributeurs.
- Les réponses à caractère blasphématoire, vulgaire ou offensant seront supprimées du site.
Gagner des badges
Votre participation sur File Exchange peut vous faire gagner des badges. Les badges que vous obtenez apparaissent sur la page de votre profil dans la communauté.
Exemples de badges à gagner :
- Première soumission
- Première évaluation
- Choix de l'éditeur
- Meilleurs téléchargements personnels
- … et bien d'autres
Rendez-vous sur la page Badges de la communauté pour visualiser les types de badges que vous pouvez gagner.
| Action | Points supplémentaires gagnés |
|---|---|
La soumission est présentée dans le blog « Sélection de la semaine » |
+50 points |
Les soumissions vous rapportent un badge annuel |
+50 points |
La soumission est notée avec 5 étoiles |
+5 points |
La soumission est notée avec 4 étoiles |
+4 points |
La soumission est téléchargée 10 fois |
+1 point si la soumission n'a pas été mise à jour au cours des trois derniers mois +2 points si la soumission a été mise à jour dans les trois derniers mois |
Consultez le tableau des leaders pour voir les contributeurs avec la réputation la plus élevée !
Questions et commentaires
Pour toute question ou tout commentaire relatif à File Exchange, utilisez le forum des commentaires. Sélectionnez « MATLAB Central » comme catégorie. Saisissez les questions et commentaires relatifs aux fonctionnalités d'une soumission File Exchange spécifique dans les commentaires ou discussions associés à cette soumission.
Posez vos questions sur MATLAB et Simulink aux experts de la communauté dans MATLAB Answers. Pour une aide sur les licences ou tout autre produit ou service MathWorks, contactez le support.
