Über File Exchange – MATLAB Central

File Exchange ermöglicht es Ihnen, benutzerdefinierte Anwendungen, Klassen, Code-Beispiele, Treiber, Funktionen, Simulink-Modelle, Skripts und Videos zu suchen und zu teilen. Mit File Exchange können Sie Folgendes tun:

Einreichen von Dateien
Verbinden mit GitHub Repositorys
Teilen einer Website mit Ihrem MATLAB Programmcode
Bereitstellen von Lizenzinformationen
Bereitstellen von Anleitungen zur Quellenangabe für andere
Suchen von Dateien mithilfe von Inhaltstypen, dem Suchfenster und Suchdirektiven
Kommentieren von Einreichungen durch Hinzufügen von Tags für zukünftige Suchen, Überprüfen der Einreichungen und Diskutieren der Einreichungen basierend auf Ihrer Nutzung
Gewinnen von Anerkennung in der Community, indem Sie Dateien einreichen, die Mitglieder verwenden, kennzeichnen und bewerten
Verdienen von Badges
Aufbau eines guten Rufs
Klären von Fragen sowie Übermitteln und Erhalten von Feedback

Ihre Nutzung von File Exchange unterliegt den Nutzungsbedingungen von MATLAB Central.

Einreichen von Dateien

Sie können Dateien mit einer Größe von bis zu 250 MB einreichen. Melden Sie sich mit Ihrem Community-Profil an, um Dateien einzureichen. Falls Sie kein Profil haben, müssen Sie zuerst eines erstellen. Klicken Sie auf Ihrer Account-Seite auf „Publish“ (Veröffentlichen), um eine Datei von einem Computer hochzuladen oder zum GitHub-Repository zu verlinken.

Verbinden mit GitHub-Repositorys

Die Verbindung zwischen File Exchange und GitHub ermöglicht es Mitwirkenden, Softwareprojekte in einer einzigen Umgebung zu entwickeln, ohne Dateien auf File Exchange und GitHub hochladen zu müssen. Mitwirkende profitieren von sämtlichen Vorteilen der kollaborativen Entwicklung in GitHub, während Community-Mitglieder Zugang zu den neusten Versionen Ihrer Projekte erhalten – unabhängig davon, ob sie in File Exchange oder GitHub beginnen. Community-Mitglieder, die mit GitHub verbundene Dateien herunterladen, sind für die Validierung des Inhalts und die Lizenzierung dieser Dateien verantwortlich.

Bei der Verbindung zu einem GitHub-Repository speichert File Exchange die Repository-Inhalte auf MathWorks-Servern, um sie in File Exchange und Add-On Explorer bereitzustellen. Die auf dem MathWorks-Server gespeicherten Dateien sind schreibgeschützt und werden automatisch aktualisiert, um Änderungen in GitHub widerzuspiegeln. Das Speichern der Repository-Inhalte in MathWorks ermöglicht die Bereitstellung komfortabler Funktionen, beispielsweise die Vorschau von MATLAB Programmcode.

Wählen Sie eine der folgenden Optionen aus, um Ihr Repository mit GitHub zu verbinden:

GitHub Releases – GitHub Releases wird als Verbindung empfohlen. Wenn Sie bereit sind, Ihr Repository zu teilen, verwenden Sie GitHub Releases zum Paketieren Ihres Codes. Bei der Nutzung von GitHub Releases werden die eingereichten File Exchange-Dateien automatisch aktualisiert, sobald Sie einen neuen Release in GitHub erstellen.

So erstellen Sie einen GitHub Release:

– Wenn Sie Ihren Code als Toolbox paketieren, fügen Sie Ihre Toolbox (.mltbx-Datei) zum Release hinzu. File Exchange stellt die Toolbox dann als Download bereit. Wenn Sie keine .mltbx-Datei zum Release hinzufügen, verwendet File Exchange das Zip-Release-Asset.
– Befolgen Sie diese Tipps beim Kennzeichnen von Versionen:
– Geben Sie eine Version in folgendem Format ein: major.minor.patch.extension (Patch und Extension sind optional).
– Segmente mit Versionsnummern müssen weniger als sechs Ziffern haben.
– Alphanumerische Kennzeichnungen werden nicht erkannt (z. B. 2-Beta)
– Wenn Sie eine .mltbx.Datei zum Release hinzufügen, verwenden Sie dieselbe Versionsnummer für das Paket und für den GitHub-Release.
– Weitere Informationen zu GitHub Releases finden Sie in der GitHub-Dokumentation .

Default Branch – mit dieser Methode verwendet File Exchange den Default-Zweig des Repositorys (normalerweise „main“ oder „master“) zur Anzeige der Dateivorschau und zur Bereitstellung des Pakets für den Download. Die Änderungen, die Sie im Default-Zweig übergeben, sind innerhalb von 24 Stunden verfügbar. Je nach Entwicklungsprozess kann die Bereitstellung des Default-Zweigs in File Exchange dazu führen, dass die Anwender instabilen Code erhalten. Wir empfehlen, die Option „GitHub Releases“ für eine stabile Distribution Ihres Codes zu verwenden.

Wenn Sie Git LFS verwenden, paketieren Sie Ihren Code als Toolbox und fügen Sie die .mltbx-Datei zum GitHub-Release Ihres Repositorys hinzu. Git LFS wird für Default-Zweig-Verbindungen in File Exchange nicht unterstützt.

Einfaches Auffinden und Verwenden von Dateien

Stellen Sie sicher, dass Ihre Titel und Beschreibungen kurz und klar, aber aussagekräftig sind.
Prüfen Sie Ihre Einreichungen auf Lesbarkeit und verwenden Sie die Rechtschreibprüfung.
Verwenden Sie Tags, um gezielte Suchen zu unterstützen, siehe Tags erstellen.
Wenn Sie Bilder hinzufügen, vergewissern Sie sich, dass Sie denselben Dateinamen verwenden und sich diese im selben Verzeichnis befinden wie Ihr Code.
Verweisen Sie auf Dateien, die Sie inspiriert haben, eigene Dateien einzureichen. Quellenangaben werden sowohl auf der Seite mit Ihrer Datei als auch auf der Dateiseite angezeigt, auf die Sie verwiesen haben.

Teilen einer Website mit Ihrem MATLAB Programmcode

Wenn Sie beim Hochladen einer Datei auf File Exchange die Option „Link to an External Website“ (Mit einer externen Website verlinken) verwenden, können Sie Ihre Website mit Ihrem MATLAB-relevanten Projekt teilen. Mit dieser Option:

enthält die Detailseite für Ihre Einreichung den Link zu Ihrer Website.
kann die Community auf der Detailseite Feedback zur Ihrem Projekt hinterlassen.
kann Code auf Ihrer Website nicht direkt über File Exchange heruntergeladen werden.

Lizenzinformationen

Die Lizenzierung definiert die Rechte, die Sie als Autor und als Anwender des auf File Exchange verfügbaren Codes haben. Die Lizenzierung legt im Detail fest, wie der Code verwendet werden kann, und behandelt gängige Fragen im Hinblick auf Rechte für die Modifizierung, Distribution und kommerzielle Verwendung.

Eine BSD-Lizenz ist die einzige verfügbare Lizenz für Code, der direkt in File Exchange gepostet wird. Sie wird automatisch zu dem Community-Inhalt hinzugefügt, den Sie direkt mithilfe der Funktion Upload Files (Dateien hochladen) einreichen. Andere Lizenztypen sind für Community-Einreichungen zulässig, die Sie über Connect to GitHub (Mit GitHub verbinden) oder Link to an External Website (Mit einer externen Website verlinken) einreichen. Einige Einreichungen von MathWorks Personal, einschließlich Hardware-Support-Pakete, können unter der MathWorks Limited License lizenziert werden. Lizenzierte File Exchange-Einreichungen verfügen über einen View License-Link (Lizenz ansehen). Weitere Informationen zur Lizenzierung auf File Exchange finden Sie in den File Exchange Licensing FAQ.

Bereitstellen von Anleitungen zur Quellenangabe für andere

Anleitungen für Quellenangaben helfen Community-Mitgliedern, auf Ihre Arbeit zu verweisen, wenn sie diese bei ihren eigenen Nachforschungen oder in abgeleiteten Arbeiten verwenden. Vielleicht möchten Sie, dass andere Ihre File Exchange-Detailseite, einen von Ihnen verfassten Forschungsartikel, eine Gruppe, der Sie angehören oder eine Kombination von Artefakten zitieren.

Neue File Exchange-Einträge werden mit einer Standard-Anleitung für Quellenangaben erstellt, die Sie löschen können. Außerdem können Sie:

benutzerdefinierten Text als Anleitung für Quellenangaben eingeben
ein DOI festlegen, das anderweitig erstellt werden muss, wie unter DOI.org beschrieben.
mehrere Anleitungen für Quellenangaben erstellen

Suchen von Dateien

File Exchange bietet eine umfassende Online-Bibliothek mit Dateien. Sie können Dateien wie folgt suchen:

indem Sie File Exchange nach einem zugewiesenen Inhaltstyp durchsuchen
mit der Suchfunktion
durch Verfeinern Ihrer Suche mithilfe von Direktiven

Wenn Sie eine Datei gefunden haben, können Sie sie öffnen, um die Einzelheiten anzuzeigen, Tags, eine Bewertung und Kommentare hinzufügen oder die Datei herunterladen.

Dateisuche — Suche nach Dateien mit Bezug zu numerischen Berechnungen. Beachten Sie die Bereiche (links) für die verschiedenen Filter.

Durchsuchen von Inhaltstypen

File Exchange weist Inhaltstypen basierend auf den mit Ihren eingereichten Dateien verbundenen Informationen zu.

Dem Inhalt wird dieser Typ zugewiesen	Wenn Dateien diese Erweiterung haben	Und die eingereichten Dateien diese Kriterien enthalten
App	.mlappinstall	-
Treiber	.mdd	-
Beispiel	.m	/html-Unterverzeichnis .html-Datei mit dem gleichen Namen wie die MATLAB .m-Datei
Funktion	.m	Aufruf function
Simulink-Modelle	.mdl	-
Video	.avi, .mp4, .wmv, .mpg, .mov, .swf, .mpeg	-

Tipp: Für Mitwirkende, die Dateien einreichen: Wenn Ihr Beitrag angezeigt wird, aber die Nachricht Preview image not found anstelle eines Vorschaubilds erscheint, fügen Sie ein Bild hinzu, das den gleichen Dateinamen hat wie Ihr Code im gleichnamigen Verzeichnis. Dann zeigt File Exchange das Bild zusammen mit Ihrer Datei an. Beispiel: Wenn Sie eine Datei namens „foo.mdl“ haben und einen Screenshot namens „foo.gif“ hinzufügen, sehen Anwender einen Screenshot Ihres Simulink-Modells anstelle dieser Nachricht:

Für diese Datei wurde kein Bild gefunden

Lizenzinformationen

Die Lizenzierung definiert die Rechte, die Sie als Autor und als Anwender des auf File Exchange verfügbaren Codes haben. Die Lizenzierung gibt Auskunft darüber, wie die Datei verwendet werden darf, und behandelt häufig gestellte Fragen im Zusammenhang mit den Rechten zur Änderung, Verbreitung und kommerziellen Nutzung.

Eine BSD-Lizenz ist die einzige verfügbare Lizenz für Code, der direkt in File Exchange gepostet wird. Sie wird automatisch zu dem Community-Inhalt hinzugefügt, den Sie direkt mithilfe der Funktion Upload Files (Dateien hochladen) einreichen. Andere Lizenztypen sind für Community-Einreichungen zulässig, die Sie über Connect to GitHub (Mit GitHub verbinden) oder Link to an External Website (Mit einer externen Website verlinken) einreichen. Einige Einreichungen von MathWorks Personal, einschließlich Hardware-Support-Pakete, können unter der MathWorks Limited License lizenziert werden. Lizenzierte File Exchange-Einreichungen verfügen über einen View License-Link (Lizenz ansehen). Weitere Informationen zur Lizenzierung auf File Exchange finden Sie in den File Exchange Licensing FAQ.

Suchen von Dateien mithilfe von Suchdirektiven

Suchdirektiven helfen Ihnen, Dateien in File Exchange zu finden. Sie können Suchdirektiven im Suchfenster eingeben.

Suchergebnis	Direktive	Beispiele
Ein Autor mit diesem Namen	author:	author:stuart author:"Stuart McGarrity"
Ein Autor mit einer durchschnittlichen Bewertung von 1 bis 5	authoraverage:	authoraverage:5
Community-Mitglieder, deren öffentliches Profil den Namen dieses Unternehmens/dieser Organisation enthält	organization:	organization:mathworks
Inhaltstyp	type:	type:function
Dateikennungsnummer, die oben auf der Detailseite der Datei angezeigt wird.	id:	id:21832
Eine Lizenz, die diese Zeichenfolge enthält	license:	license:bsd
Durchschnittliche Community-Bewertung mit dieser Zahl	rating:	rating:5
Veröffentlichte Einreichungen, auf die diese Tags angewendet wurden	tag:	tag:statistics tag:"image processing"
Dateien mit DOI oder benutzerdefinierten Quellenangaben finden	citation_type:	citation_type:doi citation_type:custom

Verwenden von Direktiven

Um nach einem Ausdruck mit mehreren Wörtern zu suchen, setzen sie ihn in Anführungszeichen, zum Beispiel author:"Helen Chen".
Verwenden Sie Kombinationen von Direktiven in derselben Suche, um die Suchergebnisse einzuschränken. Geben Sie zwischen jeder Direktive ein Leerzeichen ein. File Exchange findet sämtliche Dateien mit allen eingegebenen Direktiven.
Um mit derselben Direktive nach mehreren Werten zu suchen, geben Sie eine Direktive für jeden Wert ein. Beispiel: Mit der Syntax tag:graphics tag:vector finden Sie alle Dateien, die sowohl mit graphics als auch mit vector gekennzeichnet sind.
Geben Sie ein Minuszeichen (-) vor der direktiven Syntax ein, um Dateien aus den Suchergebnissen auszuschließen. Mit der Syntax -tag:game schließen Sie zum Beispiel alle Dateien mit dem Tag game aus.

Hinzufügen von Tags zu Dateien

Tags enthalten Lesezeicheninformationen, die Ihnen helfen, Dateien von Interesse zu finden oder erneut abzurufen. Tags ermöglichen es Ihnen, eingereichte Dateien mithilfe der zugewiesenen Schlüsselwörter zu durchsuchen. Community-Mitglieder mit Profilen können jede beliebige Datei durch Tags kennzeichnen. Alle Tags sind öffentlich und können von jedem angezeigt werden.

In Ihrem Profil können Sie Tags sehen, die Sie auf Dateien angewendet haben. In einer Datei können Sie die Tags sehen, die von allen in der Community vergeben wurden. Durch die Kennzeichnung mit Tags geben Sie Community-Mitgliedern Einblicke in Ihre Interessen, womit Sie die Zusammenarbeit und den Austausch von Ideen erleichtern.

Sie können Tags hinzufügen, wenn Sie neue Dateien einreichen oder bestehende anzeigen lassen. Verwenden Sie Kommas als Trennzeichen für mehrere Tags und Anführungszeichen, um Tags mit mehreren Wörtern zu markieren.

Erstellen von Tags

Tags sollten beschreibend, aber kurz und knapp sein.
Verwenden Sie einheitliche Terminologie, einschließlich Begriffe, die Mitglieder voraussichtlich am häufigsten verwenden, zum Beispiel Videos, Bilder und Grafiken.
Kennzeichnen Sie nennenswerte Elemente wie Konzepte, Funktionen und Eigennamen.
Verwenden Sie Substantive anstelle von Verben.
Verwenden Sie Abkürzungen oder Akronyme nur, wenn sie allgemein bekannt sind.
Prüfen Sie Ihre Rechtschreibung.

Bewertungen

Sie können Dateien mit einem bis fünf Sternen bewerten (niedrigste bis höchste Bewertung). Fügen Sie beim Bewerten von Dateien Einzelheiten hinzu, die die Bewertung unterstützen und teilen Sie Verwendungshinweise mit dem Autor und anderen Mitgliedern der Community.

Hinzufügen von Rezensionen zu Dateien

Seien Sie ehrlich und rücksichtsvoll gegenüber Autoren und anderen Mitgliedern der Community.
Geben Sie speziell an, was Ihnen an den eingereichten Dateien gefällt oder nicht gefällt.
Verwenden Sie Beispiele, um Ihre Perspektive zu verdeutlichen.
Teilen Sie Ihre Erfahrung mit vergleichbaren Beiträgen.
Seien Sie sich darüber im Klaren, dass Kommentare, die obszön, vulgär oder in einem verletzenden Ton geschrieben sind, von der Website entfernt werden.

Diskussionen

Diskutieren Sie Fragen, Antworten oder Kommentare, die sich auf eingereichte Dateien beziehen, mit anderen Mitgliedern der Community. Sie können Kommentare verwenden, um anderen Mitwirkenden für die Beantwortung Ihrer Fragen zu danken oder um hilfreiche Anmerkungen zu geben.

Tipps für hilfreiche Diskussionen

Verwenden Sie Diskussionen, um Fragen zu klären, zu beantworten oder zu kommentieren.
Halten Sie Kommentare kurz und relevant.
Seien Sie bei all Ihren Antworten an Mitwirkende ehrlich und rücksichtsvoll.
Seien Sie sich darüber im Klaren, dass Antworten, die obszön, vulgär oder in einem verletzenden Ton geschrieben sind, entfernt werden.

Anerkennung erhalten

File Exchange bestimmt die beliebtesten Dateien basierend auf der größten Anzahl von Downloads in den letzten 30 Tagen. Je beliebter Ihre Dateien sind, umso größer ist die Anerkennung, die Sie von der Community erhalten.

Zählen von Downloads

Um die Anzahl der Downloads individueller Personen genau zu bestimmen, zählt File Exchange mehrere Downloads von derselben IP-Adresse als einen einzigen Download.

Badges verdienen

Sie können durch Ihre Teilnahme an File Exchange Badges verdienen. Alle Badges, die Sie verdienen, werden auf Ihrer Profilseite in der Community angezeigt.

Hier sind einige Beispiele der Badges, die Sie verdienen können:

Erste Einreichung
Erste Rezension
Editor’s Pick
Persönliche Bestleistung für Downloads
... und viele andere.

Besuchen Sie die Seite Community Badges, um die Badges anzuzeigen, die Sie verdienen können.

Aufbauen eines guten Rufs

Als Belohnung für Ihren aktiven Beitrag und die Teilnahme an File Exchange können Sie Punkte verdienen. Die Anzahl der verdienten Punkte hängt von der durchgeführten Aktion ab. Je mehr Punkte Sie verdienen, umso besser ist Ihr Ruf.

Wenn Ihre ...	Verdiente Zusatzpunkte ...
Einreichung im Blog „Pick of the Week“ vorgestellt wird	+50 Punkte
Einreichungen eine Jahres-Badge erhalten	+50 Punkte
Einreichung eine 5-Sterne-Bewertung erhält	+5 Punkte
Einreichung eine 4-Sterne-Bewertung erhält	+4 Punkte
Einreichung 10-mal heruntergeladen wurde	+1 Punkt, wenn die Einreichung in den letzten 3 Monaten nicht aktualisiert wurde +2 Punkte, wenn die Einreichung in den letzten 3 Monaten aktualisiert wurde

Sehen Sie sich das Leaderboard an, um festzustellen, wer den besten Ruf genießt!

Fragen und Feedback

Falls Sie Fragen oder Kommentare zu File Exchange haben, verwenden Sie dieses Feedback-Forum. Wählen Sie „MATLAB Central“ als Kategorie aus. Fragen und Kommentare bezüglich der Funktionalität bestimmter File Exchange-Einreichungen können mit Kommentaren oder Diskussionen für die jeweilige Einreichung abgedeckt werden.

Erhalten Sie in MATLAB Answers Antworten auf Ihre Fragen zu MATLAB und Simulink von Experten und Expertinnen der Community. Falls Sie zusätzliche Hilfe bei der Lizenzierung oder für andere MathWorks Produkte oder Dienstleistungen benötigen, kontaktieren Sie den Support.