À 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 :

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.

Rechercher des fichiers

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 function

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.

Aucune image trouvée pour ce fichier

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:

author:stuart
author:"Stuart McGarrity"

Auteur avec une note moyenne de 1 à 5

authoraverage:

authoraverage:5

Membre de la communauté dont le profil public comporte ce nom d'organisation ou d'entreprise

organization:

organization:mathworks

Type de contenu

type:

type:function

Numéro d'identification du fichier, qui apparaît en haut de la page Détails du fichier

id:

id:21832

Licence incluant cette chaîne de caractères

license:

license:bsd

Notation moyenne de la communauté

rating :

rating:5

Soumissions publiées avec un tag comportant cette

tag :

tag:statistics
tag:"image processing"

Recherche de fichiers avec DOI ou citation personnalisée

citation_type:

citation_type:doi

citation_type:custom

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:graphics tag:vector permet de trouver tous les fichiers avec les tags graphics et vector.
  • Pour exclure des fichiers, insérez un signe moins (-) avant la syntaxe de l'instruction. Par exemple, la syntaxe -tag:game exclut tous les fichiers avec le tag game.

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.

Évaluations

Vous pouvez évaluer les fichiers sur une échelle de 1 (note la plus basse) à 5 étoiles (note la plus élevée). Lorsque vous évaluez des fichiers, ajoutez des informations pour expliquer votre notation, et partagez des notes d'usage avec l'auteur et les autres membres de la communauté.

 

Ajouter des évaluations à des fichiers soumis.

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

Vous pouvez échanger autour des questions, réponses ou commentaires relatifs à une soumission avec d'autres membres de la communauté. Vous pouvez utiliser les commentaires pour remercier d'autres contributeurs d'avoir répondu à vos questions ou ajouter des informations utiles.

 

Discussions sur des fichiers soumis.

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.

Reconnaissance de la communauté

File Exchange établit un classement des fichiers les plus populaires, sur la base du nombre de téléchargements dans les 30 derniers jours. Votre reconnaissance par la communauté croît avec la popularité de vos fichiers.

Décompte des téléchargements

Pour calculer de manière pertinente le nombre de téléchargements, File Exchange compte les téléchargements multiples à partir d'une même adresse IP comme un seul téléchargement.


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.


Bâtir votre réputation

Vous êtes récompensé de votre contribution active et de votre participation sur File Exchange par des points. Le nombre de points gagnés dépend des actions menées. Votre réputation croît avec votre nombre de points gagnés.

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.