Informazioni su File Exchange
File Exchange consente di trovare e condividere applicazioni personalizzate, classi, esempi di codice, driver, funzioni, modelli Simulink, script e video. Con File Exchange sarai in grado di:
- Inviare file
- Effettuare il collegamento ai repository GitHub
- Condividere siti web contenenti il tuo codice MATLAB
- Ottenere informazioni sulle licenze
- Fornire ad altri istruzioni su come citare il tuo lavoro
- Cercare file utilizzando tipi di contenuti, la finestra di ricerca e direttive di ricerca
- Aggiungere tag ai contenuti inviati ai fini di ricerche future, rivedere contenuti e discutere con gli altri in base al tuo utilizzo
- Ottenere un riconoscimento da parte della community inviando file che i membri utilizzano, etichettano e valutano
- Ottenere badge
- Accrescere la tua reputazione
- Fare domande e ricevere feedback
L’utilizzo di File Exchange è soggetto ai Termini di utilizzo di MATLAB Central.
Invio di file
È possibile inviare file fino a 250 MB. Per inviare un file, accedi al tuo Community Profile. Se non disponi di un profilo, dovrai crearne uno. Sulla pagina del tuo account, fai clic su “Publish” per caricare un file dal computer o inserire un collegamento a un repository GitHub.
Collegamento ai repository GitHub
Il collegamento tra File Exchange e GitHub consente ai collaboratori di sviluppare progetti software in un unico ambiente senza dover caricare i file in entrambe le posizioni. I collaboratori possono godere di tutti i vantaggi dello sviluppo collaborativo in GitHub, mentre i membri della community possono accedere all'ultima versione dei tuoi progetti, sia che partano da File Exchange che da GitHub. I membri della community che scaricano file collegati a GitHub sono responsabili della convalida del contenuto e della concessione in licenza di tali file.
Quando si effettua il collegamento a un archivio di GitHub, File Exchange archivia i contenuti del repository sui server MathWorks al fine di renderli disponibili in File Exchange e Add-On Explorer. I file archiviati sui server MathWorks sono di sola lettura e vengono aggiornati automaticamente in modo da riflettere le modifiche apportate in GitHub. L’archiviazione dei contenuti degli archivi consente a MathWorks di offrire funzionalità convenienti, come ad esempio la visualizzazione di anteprime del codice MATLAB.
Per collegare un archivio a GitHub, seleziona una delle opzioni seguenti:
- Release di GitHub – Le release di GitHub sono il metodo consigliato per effettuare il collegamento. Quando l’archivio è pronto per essere distribuito, utilizza le release di GitHub per inserire il codice in un pacchetto. Grazie all’utilizzo delle release di GitHub, i contenuti inviati su File Exchange verranno aggiornati automaticamente al momento della creazione di una nuova release in GitHub.
Quando crei una release di GitHub:
- - Se inserisci il tuo codice in un pacchetto come toolbox, allega il toolbox (file .mltbx) alla release. Successivamente, File Exchange fornisce il toolbox come file da scaricare. Se alla release non viene allegato un file .mltbx, File Exchange utilizza lo strumento di compressione delle release.
- - Segui i consigli riportati di seguito su come etichettare le versioni:
- - Inserisci una versione nel formato: maggiore.minore.patch.estensione (patch ed estensione sono opzionali).
- - I segmenti di numero della versione devono contenere meno di sei cifre.
- - Le etichette alfanumeriche non vengono riconosciute (ad esempio 2-beta).
- - Quando alleghi un file .mltbx alla release, imposta lo stesso numero di versione nel pacchetto rispetto al numero di versione della release di GitHub.
- - Per ulteriori informazioni sulle release di GitHub, consulta la documentazione di GitHub.
- Ramo predefinito – Con questo metodo, File Exchange utilizza il ramo predefinito dell’archivio (solitamente "main" o "master") per visualizzare le anteprime dei file e fornire il pacchetto da scaricare. Le modifiche apportate al ramo predefinito sono disponibili entro 24 ore. A seconda del processo di sviluppo, se si rende disponibile il ramo predefinito in File Exchange, gli utenti potrebbero ottenere un codice instabile. Consigliamo di utilizzare le release di GitHub per una distribuzione stabile del codice.
- Se utilizzi Git LFS, inserisci il codice in un pacchetto come toolbox e allega il file .mltbx alla release di GitHub del tuo archivio. Git LFS non è supportato per i collegamenti del ramo predefinito in File Exchange.
Come semplificare la ricerca e l’utilizzo dei file
- Assicurati che i titoli e le descrizioni siano chiari e concisi ma descrittivi.
- Controlla la leggibilità e la correttezza ortografica dei contenuti inviati.
- Utilizza tag che agevolino le ricerche; consulta la sezione Creazione di tag.
- Quando aggiungi immagini, assicurati che queste utilizzino lo stesso nome file e che si trovino nella stessa directory in cui si trova il codice.
- Esegui il riconoscimento dei file alla base del contenuto inviato. I riconoscimenti compaiono nella pagina del file e nella pagina del file riconosciuto.
Condivisione dei siti web contenenti il tuo codice MATLAB
Utilizzando l’opzione “Link to an External Website” quando lavori in File Exchange, sarai in grado di condividere i siti web contenenti i tuoi progetti MATLAB. Con questa opzione:
- La pagina dei dettagli del contenuto inviato contiene il link al tuo sito web.
- La community può fornire un feedback sul tuo progetto nella pagina dei dettagli.
- Il codice presente sul tuo sito web non può essere scaricato direttamente da File Exchange.
Informazioni sulle licenze
Le licenze definiscono i diritti dell'autore e dell'utente del codice disponibile su File Exchange: descrivono nel dettaglio il codice che può essere utilizzato e rispondono alle domande più comuni sui diritti di modifica, distribuzione e uso commerciale.
La licenza BSD è l'unica licenza supportata per il codice inviato direttamente a File Exchange e viene aggiunta automaticamente ai contenuti della community che invii direttamente a File Exchange utilizzando Upload Files. Altri tipi di licenza sono consentiti per i contributi della community forniti utilizzando Connect to GitHub o Link to an External Website. Alcuni contenuti rilasciati dal personale MathWorks, compresi i pacchetti di supporto hardware, possono essere concessi in licenza con la MathWorks Limited License. I contenuti di File Exchange concessi in licenza prevedono un link View License. Per ulteriori informazioni sulle licenze di File Exchange, consulta la pagina Domande frequenti sulle licenze di File Exchange.
Istruzioni per le citazioni del tuo lavoro
Le istruzioni per le citazioni aiutano i membri della community a citare il tuo lavoro quando viene utilizzato nelle loro ricerche o in lavori derivati. Ad esempio, potresti volere che gli altri citino la tua pagina dei dettagli di File Exchange, un tuo articolo di ricerca, un gruppo al quale appartieni o una combinazione di artefatti.
I nuovi elementi di File Exchange vengono creati con un'istruzione per la citazione predefinita, che può essere eliminata. Inoltre, è possibile:
- Specificare un'istruzione per la citazione utilizzando testo personalizzato
- Specificare un DOI, da generare altrove, come spiegato su DOI.org
- Creare più istruzioni per la citazione
Ricerca di file
File Exchange offre un'ampia libreria online di file. È possibile cercare i file nei seguenti modi:
- Navigazione in un tipo di contenuto assegnato
- Ricerca
- Ottimizzazione delle ricerche mediante direttive
Una volta trovato un file, è possibile aprirlo per visualizzarne i dettagli; aggiungere tag, una valutazione e dei commenti, oppure scaricarlo.
Ricerca di file relativi al calcolo numerico. Da notare le aree (a sinistra) per i diversi filtri.
Navigazione tra i tipi di contenuto
File Exchange assegna ai file dei tipi di contenuto in base alle informazioni associate al contenuto inviato.
| Tipo assegnato al contenuto | Quando i file hanno questa estensione | E contengono questi criteri |
|---|---|---|
App |
.mlappinstall |
- |
Driver |
.mdd |
- |
Esempio |
.m |
File .html della sottodirectory /html con lo stesso nome del file .m di MATLAB |
Function |
.m |
Chiamata di |
Modello Simulink |
.mdl |
- |
Video |
.avi, .mp4, .wmv, .mpg, .mov, .swf, .mpeg |
- |
Suggerimento: per gli utenti che inviano file, se un file nel contenuto inviato viene visualizzato ma mostra un messaggio Preview image not found (Immagine di anteprima non trovata) invece di un'immagine di anteprima, è necessario aggiungere un'immagine con lo stesso nome file del codice nella stessa directory; in questo modo File Exchange visualizzerà l'immagine insieme al file. Esempio: se un file è stato nominato “foo.mdl”, l’aggiunta di una schermata dal nome “foo.gif” mostrerà agli utenti una schermata del modello Simulink invece del suddetto messaggio.
Informazioni sulle licenze
Le licenze definiscono i diritti dell'autore e dell'utente del codice disponibile su File Exchange: Descrivono nel dettaglio il file che può essere utilizzato e rispondono alle domande più comuni sui diritti di modifica, distribuzione e uso commerciale.
La licenza BSD è l'unica licenza supportata per il codice inviato direttamente a File Exchange e viene aggiunta automaticamente ai contenuti della community che invii direttamente a File Exchange utilizzando Upload Files. Altri tipi di licenza sono consentiti per i contributi della community forniti utilizzando Connect to GitHub o Link to an External Website. Alcuni contenuti rilasciati dal personale MathWorks, compresi i pacchetti di supporto hardware, possono essere concessi in licenza con la MathWorks Limited License. I contenuti di File Exchange concessi in licenza prevedono un link View License. Per ulteriori informazioni sulle licenze di File Exchange, consulta la pagina Domande frequenti sulle licenze di File Exchange.
Ricerca di file mediante direttive
Le direttive di ricerca aiutano a trovare i file su File Exchange. È possibile specificare delle direttive di ricerca nella finestra di ricerca.
| Risultato della ricerca | Direttiva | Esempi |
|---|---|---|
Autore con questo nome |
author: |
|
Autore con una valutazione media dei file compresa tra 1 e 5 |
authoraverage: |
|
Membro della community con questo nome di azienda/organizzazione elencato nel suo profilo pubblico |
organization: |
|
Tipo di contenuto |
type: |
|
Numero di identificazione del file, che compare nella parte superiore della pagina dei dettagli del file |
id: |
|
Licenza contenente questa stringa |
license: |
|
Valutazione media della community con questo valore |
rating: |
|
Tag con questa stringa applicati ai contenuti inviati pubblicati |
tag: |
|
Ricerca di file con DOI o citazione personalizzata |
citation_type: |
Utilizzo delle direttive
- Per cercare una frase composta da più parole, racchiudi la frase tra virgolette, ad esempio
author:"Helen Chen". - Per restringere i risultati della ricerca, utilizza combinazioni di direttive nella stessa ricerca, assicurandoti di inserire uno spazio tra ciascuna direttiva. File Exchange trova tutti i file che corrispondono a tutte le direttive specificate.
- Per cercare più di un valore per la stessa direttiva, specifica una direttiva per ciascun valore. Ad esempio, la sintassi
tag:graphicstag:vectortrova tutti i file con entrambi i taggraphicsevector. - Per escludere dei file dai risultati della ricerca, inserisci un segno meno (-) prima della sintassi della direttiva. Ad esempio, la sintassi
-tag:gameesclude tutti i file con il taggame.
Aggiunta di tag ai file
I tag forniscono informazioni segnalibro per aiutare a trovare o richiamare i file di interesse consentono di sfogliare i file inviati utilizzando le parole chiave assegnate. I membri della community con un profilo possono aggiungere tag a qualsiasi file. Tutti i tag sono pubblici e possono essere visualizzati da chiunque.
Dal tuo profilo puoi vedere i tag che hai applicato ai file, mentre all'interno di un file puoi vedere i tag applicati da tutti i membri della community. Mediante i tag, i membri della community possono conoscere i tuoi interessi, agevolando così la collaborazione e lo scambio di idee.
È possibile aggiungere tag quando si inviano nuovi file o si visualizzano quelli esistenti. Utilizza le virgole per separare i tag multipli e le virgolette per indicare i tag composti da più parole.
Creazione di tag
- I tag devono essere descrittivi e concisi.
- Impiega una terminologia uniforme, compresi i termini che i membri sono più propensi a utilizzare, ad esempio video, immagini e grafica.
- Aggiungi tag agli elementi più rilevanti, come i concetti, le funzioni e i nomi propri.
- Preferisci i sostantivi ai verbi.
- Non utilizzare abbreviazioni o acronimi, a meno che non siano ben noti.
- Controlla l'ortografia.
Aggiunta di valutazioni ai file inviati.
Aggiunta di valutazioni ai file
- È importante essere onesti e rispettosi nei confronti dell'autore del file e degli altri membri della community.
- Fornisci informazioni specifiche su ciò che ti piace e non ti piace del contenuto inviato.
- Illustra il tuo punto di vista attraverso degli esempi.
- Condividi le tue esperienze con contenuti simili.
- I commenti contenenti blasfemia, turpiloquio o toni offensivi verranno rimossi dal sito.
Consigli per delle discussioni utili
- Sfrutta le discussioni per chiedere chiarimenti su una domanda, una risposta o un commento.
- Scrivi commenti pertinenti e brevi.
- È importante essere onesti e rispettosi nel rispondere a tutti i collaboratori.
- Le risposte contenenti blasfemia, turpiloquio o toni offensivi verranno rimosse.
Ottenimento di badge
Ottieni badge partecipando a File Exchange. I badge ottenuti compaiono sulla tua pagina di profilo della community.
Alcuni esempi di badge che puoi ottenere sono:
- First Submission (Primo invio)
- First Review (Prima revisione)
- Editor’s Pick (Suggerimento della redazione)
- Personal Best Downloads (Contenuto più scaricato)
- ... e tanti altri ancora
Visita la pagina dei badge della community per scoprire i tipi di badge che puoi ottenere.
| Quando... | Punti aggiuntivi guadagnati |
|---|---|
Il tuo contenuto viene inserito nel blog "Pick of the Week" |
+50 punti |
I tuoi contenuti ti fanno guadagnare un badge annuale |
+50 punti |
Il tuo contenuto riceve una valutazione di 5 stelle |
+5 punti |
Il tuo contenuto riceve una valutazione di 4 stelle |
+4 punti |
Il tuo contenuto è stato scaricato 10 volte |
+1 punto se il contenuto non è stato aggiornato negli ultimi 3 mesi +2 punti se il contenuto è stato aggiornato negli ultimi 3 mesi |
Consulta la leaderboard per scoprire chi ha ricevuto la valutazione più alta.
Domande e feedback
Per domande o commenti specifici su File Exchange, utilizza questo modulo di feedback. Per il campo "Category", seleziona "MATLAB Central". Le domande e i commenti relativi alla funzionalità di determinati contenuti di File Exchange possono essere affrontati tramite commenti o discussioni all'interno del contenuto stesso.
Ottieni le risposte alle tue domande su MATLAB e Simulink dagli esperti della community in MATLAB Answers. Se necessiti di ulteriore assistenza per le licenze o per altri prodotti o servizi MathWorks, contatta l’assistenza.
