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:

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

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 function

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.

Nessuna immagine trovata per questo file

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:

author:stuart
author:"Stuart McGarrity"

Autore con una valutazione media dei file compresa tra 1 e 5

authoraverage:

authoraverage:5

Membro della community con questo nome di azienda/organizzazione elencato nel suo profilo pubblico

organization:

organization:mathworks

Tipo di contenuto

type:

type:function

Numero di identificazione del file, che compare nella parte superiore della pagina dei dettagli del file

id:

id:21832

Licenza contenente questa stringa

license:

license:bsd

Valutazione media della community con questo valore

rating:

rating:5

Tag con questa stringa applicati ai contenuti inviati pubblicati

tag:

tag:statistics
tag:"image processing"

Ricerca di file con DOI o citazione personalizzata

citation_type:

citation_type:doi

citation_type:custom

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:graphics tag:vector trova tutti i file con entrambi i tag graphics e vector.
  • Per escludere dei file dai risultati della ricerca, inserisci un segno meno (-) prima della sintassi della direttiva. Ad esempio, la sintassi -tag:game esclude tutti i file con il tag game.

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.

Revisioni

È possibile valutare i file assegnando da una a cinque stelle (dalla valutazione più bassa alla più alta). Quando valuti un file, aggiungi dei dettagli a supporto della valutazione e condividi delle note d'uso con l'autore e gli altri membri della community.

 

Aggiunta di valutazioni ai file inviati.

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.

Discussioni

Confrontati con gli altri membri della community su domande, risposte o commenti relativi ai contenuti inviati. Utilizza i commenti per ringraziare gli altri collaboratori per le risposte alle tue domande o per fornire commenti utili.

 

Aggiunta di discussioni per i file inviati.

Aggiunta di discussioni per i file inviati.

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 un riconoscimento

File Exchange seleziona i file più popolari in base al maggior numero di download effettuati nei 30 giorni precedenti. Più popolari sono i tuoi file, maggiore sarà il riconoscimento che otterrai dalla community.

Conteggio dei download

Per calcolare con precisione i download effettuati dai singoli utenti, File Exchange conta i download multipli effettuati dallo stesso indirizzo IP come un unico download.


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.


Accrescimento della reputazione

Come ricompensa per aver collaborato e partecipato attivamente a File Exchange, guadagnerai punti. Il numero di punti guadagnati dipende dall'azione compiuta. Più punti guadagni, maggiore sarà la tua reputazione.

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.