train

Addestrare una rete neurale superficiale (da rimuovere)

train sarà rimossa in una prossima release. Per ulteriori informazioni, vedere Transition Legacy Neural Network Code to dlnetwork Workflows.

Per suggerimenti sull'aggiornamento del codice, vedere Version History (Storico della versione).

Sintassi

trainedNet = train(net,X,T,Xi,Ai,EW)

[trainedNet,tr] = train(net,X,T,Xi,Ai,EW)

[trainedNet,tr] = train(net,X,T,Xi,Ai,EW,Name,Value)

Descrizione

Questa funzione addestra una rete neurale superficiale. Per l'addestramento delle reti di Deep Learning (come le reti convoluzionali o le reti LSTM), utilizzare la funzione trainnet.

trainedNet = train(net,X,T,Xi,Ai,EW) addestra una rete net in base a net.trainFcn e net.trainParam.

[trainedNet,tr] = train(net,X,T,Xi,Ai,EW) restituisce anche un record di addestramento.

[trainedNet,tr] = train(net,X,T,Xi,Ai,EW,Name,Value) addestra una rete con ulteriori opzioni specificate da una o più coppie di argomenti nome-valore.

Esempi

Addestramento e tracciamento di reti

Qui, gli input x e i target t definiscono una semplice funzione che può essere tracciata:

x = [0 1 2 3 4 5 6 7 8];
t = [0 0.84 0.91 0.14 -0.77 -0.96 -0.28 0.66 0.99];
plot(x,t,'o')

In questo caso, feedforwardnet crea una rete feed-forward a due livelli. La rete ha un livello nascosto con dieci neuroni.

net = feedforwardnet(10);
net = configure(net,x,t);
y1 = net(x)
plot(x,t,'o',x,y1,'x')

La rete viene addestrata e poi risimulata.

net = train(net,x,t);
y2 = net(x)
plot(x,t,'o',x,y1,'x',x,y2,'*')

Argomenti di input

net — Rete di input

Oggetto network

Rete di input, specificata come un oggetto network. Per creare un oggetto network, utilizzare ad esempio feedforwardnet o narxnet.

X — Input di rete

matrice | array di celle | dati composti | gpuArray

Input di rete, specificati come una matrice R per Q o un array di celle Ni per TS, dove

• R è la dimensione di input

• Q è la dimensione del batch

• Ni = net.numInputs

• TS è il numero fasi temporali

Gli argomenti train possono avere due formati: matrici per problemi statici e reti con input e output singoli e array di celle per fasi temporali multiple e reti a input e output multipli.

• Il formato matrice può essere utilizzato se si desidera simulare solo una fase temporale (TS = 1). Risulta utile per le reti che hanno solo un input e un output, ma può essere utilizzato anche per le reti che hanno più input e più output. Quando la rete è a input multipli, la dimensione della matrice è (somma di Ri) per Q.

• Il formato dell’array di celle è più generale e opportuno per le reti a input e output multipli, in quanto consente di presentare sequenze di input. Ciascun elemento X{i,ts} è una matrice Ri per Q, dove Ri = net.inputs{i}.size.

Se si utilizzano dati composti, 'useParallel' viene impostato automaticamente su 'yes'. La funzione considera dati composti e restituisce risultati composti.

Se si utilizzano dati gpuArray, 'useGPU' viene impostato automaticamente su 'yes'. La funzione considera dati gpuArray e restituisce risultati gpuArray

Nota

Se la colonna di X comprende almeno un NaN, train non utilizza quella colonna per l'addestramento, il test o la convalida.

T — Target della rete

zeri (predefinito) | matrice | array di celle | dati composti | gpuArray

Target della rete, specificati come una matrice U per Q o un array di celle No per TS, dove

• U è la dimensione di output

• Q è la dimensione del batch

• No = net.numOutputs

• TS è il numero fasi temporali

Gli argomenti train possono avere due formati: matrici per problemi statici e reti con input e output singoli e array di celle per fasi temporali multiple e reti a input e output multipli.

• Il formato matrice può essere utilizzato se si desidera simulare solo una fase temporale (TS = 1). Risulta utile per le reti che hanno solo un input e un output, ma può essere utilizzato anche per le reti che hanno più input e più output. Quando la rete è a input multipli, la dimensione della matrice è (somma di Ui) per Q.

• Il formato dell’array di celle è più generale e opportuno per le reti a input e output multipli, in quanto consente di presentare sequenze di input. Ciascun elemento T{i,ts} è una matrice Ui per Q, dove Ui = net.outputs{i}.size.

Se si utilizzano dati composti, 'useParallel' viene impostato automaticamente su 'yes'. La funzione considera dati composti e restituisce risultati composti.

Se si utilizzano dati gpuArray, 'useGPU' viene impostato automaticamente su 'yes'. La funzione considera dati gpuArray e restituisce risultati gpuArray

Si noti che T è opzionale e deve essere utilizzato solo per le reti che richiedono dei target.

Nota

Qualsiasi valore NaN nei target T è trattato come un dato mancante. Se un elemento di T è NaN, tale elemento non è utilizzato per l’addestramento, il test e la convalida.

Xi — Condizioni iniziali del ritardo di input

zeri (predefinito) | array di celle | matrice

Condizioni iniziali del ritardo di input, specificate come un array di celle Ni per ID o una matrice R per (ID*Q), dove

• ID = net.numInputDelays

• Ni = net.numInputs

• R è la dimensione di input

• Q è la dimensione del batch

Per l’input dell’array di celle, le colonne di Xi sono ordinate dalla condizione di ritardo più vecchia alla più recente: Xi{i,k} è l’input i al momento ts = k - ID.

Anche Xi è opzionale e deve essere utilizzato solo per le reti che presentano ritardi di input o del livello.

Ai — Condizioni iniziali del ritardo del livello

zeri (predefinito) | array di celle | matrice

Condizioni iniziali del ritardo del livello, specificate come un array di celle Nl per LD o una matrice (somma di Si) per (LD*Q), dove

• Nl = net.numLayers

• LD = net.numLayerDelays

• Si = net.layers{i}.size

• Q è la dimensione del batch

Per l’input dell’array di celle, le colonne di Ai sono ordinate dalla condizione di ritardo più vecchia alla più recente: Ai{i,k} è l’output del livello i al momento ts = k - LD.

EW — Pesi dell’errore

array di celle

Pesi dell’errore, specificati come un array di celle No per TS o una matrice (somma di Ui) per Q, dove

• No = net.numOutputs

• TS è il numero fasi temporali

• Ui = net.outputs{i}.size

• Q è la dimensione del batch

Per l’input dell’array di celle, ciascun elemento EW{i,ts} è una matrice Ui per Q, dove

• Ui = net.outputs{i}.size

• Q è la dimensione del batch

I pesi dell’errore EW possono anche avere una dimensione pari a 1 al posto di tutti o qualsiasi No, TS, Ui o Q. In questo caso, EW viene automaticamente esteso in dimensione per corrispondere ai target T. Questo consente di ponderare l'importanza in qualsiasi dimensione in modo appropriato (come per il campione), mantenendone la stessa importanza in un’altra (come il tempo, con TS=1). Se tutte le dimensioni sono pari a 1, ad esempio se EW = {1}, tutti i valori target vengono trattati con la stessa importanza. Quello è il valore predefinito di EW.

Come visto sopra, i pesi dell’errore EW possono avere le stesse dimensioni dei target T oppure avere alcune dimensioni impostate su 1. Ad esempio, se EW è 1xQ, i campioni del target avranno un’importanza diversa, ma ciascun elemento in un campione avrà la stessa importanza. Se EW è la (somma di Ui)x1, ogni elemento di output avrà un’importanza diversa, mentre tutti i campioni saranno trattati con la stessa importanza.

Argomenti nome-valore

Specificare coppie opzionali di argomenti come Name1=Value1,...,NameN=ValueN, dove Name è il nome dell’argomento e Value è il valore corrispondente. Gli argomenti nome-valore devono comparire dopo gli altri argomenti, ma l'ordine delle coppie non ha importanza.

Prima della R2021a, utilizzare le virgole per separare ogni nome e valore e racchiudere Name tra virgolette.

Esempio 'useParallel','yes'

useParallel — Opzione per specificare calcoli paralleli

'no' (predefinito) | 'yes'

Opzione per specificare calcoli paralleli, specificata come 'yes' o 'no'.

• 'no': i calcoli vengono eseguiti su un normale thread MATLAB. Questa è l’impostazione predefinita di 'useParallel'.

• 'yes': i calcoli vengono eseguiti su worker paralleli se un pool parallelo è aperto. In caso di assenza di un pool parallelo aperto, il software ne avvia uno utilizzando il profilo cluster predefinito.

useGPU — Opzione per specificare calcoli GPU

'no' (predefinito) | 'yes' | 'only'

Opzione per specificare calcoli GPU, specificata come 'yes', 'no' o 'only'.

• 'no': i calcoli vengono eseguiti sulla CPU. Questa è l’impostazione predefinita di 'useGPU'.

• 'yes': i calcoli vengono eseguiti sull’attuale gpuDevice se si tratta di una GPU supportata (vedere Parallel Computing Toolbox™ per i requisiti della GPU). Se l’attuale gpuDevice non è supportata, i calcoli restano sulla CPU. Se anche 'useParallel' è 'yes' e un pool parallelo è aperto, allora ogni worker con una GPU unica utilizza quella GPU, mentre gli altri worker eseguono i calcoli sui rispettivi core delle proprie CPU.

• 'only': se nessun pool parallelo è aperto, allora questa impostazione è uguale a 'yes'. Se un pool parallelo è aperto, vengono utilizzati solo i worker con GPU uniche. Tuttavia, se un pool parallelo è aperto, ma non sono disponibili GPU supportate, i calcoli ritornano a essere eseguiti su tutte le CPU dei worker.

showResources — Opzione per mostrare le risorse

'no' (predefinito) | 'yes'

Opzione per mostrare le risorse, specificata come 'yes' o 'no'.

• 'no': non visualizza le risorse di calcolo utilizzate alla riga di comando. Questa è l’impostazione predefinita.

• 'yes': mostra alla riga di comando un riepilogo delle risorse di calcolo effettivamente utilizzate. Le risorse effettive possono differire da quelle richieste se viene richiesto il calcolo in parallelo o su GPU, ma un pool parallelo non è aperto o una GPU supportata non è disponibile. Quando vengono utilizzati i worker in parallelo, viene descritta la modalità di calcolo di ciascun worker, compresi quelli del pool che non vengono utilizzati.

reduction — Riduzione della memoria

1 (predefinito) | intero positivo

Riduzione della memoria, specificata come un numero intero positivo.

Per la maggior parte delle reti neurali, la modalità di calcolo predefinita per l'addestramento della CPU è un algoritmo MEX compilato. Tuttavia, per le reti di grandi dimensioni i calcoli potrebbero essere eseguiti con una modalità di calcolo MATLAB^®. Questo può essere confermato utilizzando 'showResources'. Se si utilizza MATLAB e la memoria costituisce un problema, impostando l'opzione di riduzione su un valore N maggiore di 1, si riduce gran parte della memoria temporanea necessaria per l’addestramento di un fattore N, in cambio di tempi di addestramento più lunghi.

CheckpointFile — File del checkpoint

'' (predefinito) | vettore di carattere

File del checkpoint, specificato come un vettore di carattere.

Il valore per 'CheckpointFile' può essere impostato su un nome di file da salvare nella cartella di lavoro corrente, su un percorso di file in un'altra cartella o su una stringa vuota per disabilitare i salvataggi dei checkpoint (il valore predefinito).

CheckpointDelay — Ritardo del checkpoint

60 (predefinito) | intero non negativo

Ritardo del checkpoint, specificato come un intero non negativo.

Il parametro opzionale 'CheckpointDelay' limita la frequenza dei salvataggi. La limitazione della frequenza dei checkpoint può migliorare l'efficienza, mantenendo basso il tempo di salvataggio dei checkpoint rispetto al tempo impiegato per i calcoli. Il valore predefinito è 60, ad indicare che i salvataggi dei checkpoint non avvengono più di una volta al minuto. Impostare il valore di 'CheckpointDelay' su 0 si desidera che i salvataggi dei checkpoint avvengano solo una volta ogni epoca.

Argomenti di output

trainedNet — Rete addestrata

Oggetto network

Rete addestrata, restituita come un oggetto network.

tr — Record di addestramento

struttura

Record di addestramento (epoch e perf), restituito come una struttura i cui campi dipendono dalla funzione di addestramento della rete (net.NET.trainFcn). Può comprendere campi quali:

• Funzioni e parametri di addestramento, divisione dei dati e performance

• Indici di divisione dei dati per i set di addestramento, convalida e test

• Maschere di divisione dei dati per i set di addestramento, convalida e test

• Numero di epoche (num_epochs) e epoca migliore (best_epoch)

• Un elenco dei nomi degli stati di addestramento (states)

• Campi per ciascun nome di stato che registrano il suo valore durante l'addestramento

• Le migliori prestazioni della rete valutate a ciascuna epoca: migliore performance sul set di addestramento (best_perf), migliore performance sul set di convalida (best_vperf) e migliore performance sul set di test (best_tperf)

Algoritmi

train chiama la funzione indicata da net.trainFcn, utilizzando i valori dei parametri di addestramento indicati da net.trainParam.

Normalmente, un'epoca di addestramento è definita come una singola presentazione di tutti i vettori di input alla rete. La rete è quindi aggiornata in base ai risultati di tutte quelle presentazioni.

L’addestramento continua fino al raggiungimento di un numero massimo di epoche, al raggiungimento dell'obiettivo di performance o all’occorrenza di qualsiasi altra condizione di arresto della funzione net.trainFcn.

Alcune funzioni di addestramento si discostano da questa norma presentando un solo vettore (o sequenza) di input a ciascuna epoca. Un vettore (o sequenza) di input viene scelto in modo casuale per ogni epoca tra vettori (o sequenze) di input concorrenti. competlayer restituisce reti che utilizzano trainru, una funzione di addestramento che esegue tale scelta.

Cronologia versioni

Introduzione prima di R2006a

R2026a: Prossima rimozione di train

train sarà rimossa in una prossima release.

Per saperne di più sull'addestramento e la previsione delle reti neurali, vedere questi esempi e argomenti:

• Training Neural Networks with Tabular Data

• Training Neural Networks with Time Series Data

Per addestrare una rete neurale con dati tabellari, utilizzare una di queste funzioni:

• fitrnet (Statistics and Machine Learning Toolbox): addestra una rete neurale di regressione. Utilizzare questa funzione per attività di regressione semplici.

• fitcnet (Statistics and Machine Learning Toolbox): addestra una rete neurale di classificazione. Utilizzare questa funzione per attività di classificazione semplici.

• trainnet: addestra una rete neurale. Utilizzare questa funzione quando le funzioni fitrnet e fitcnet non forniscono le opzioni di addestramento necessarie per l'attività.

Per addestrare una rete neurale con dati delle serie temporali, utilizzare una di queste opzioni:

• App Time Series Modeler: progetta e addestra le reti neurali per i dati delle serie temporali in modo interattivo.

• trainnet: addestra una rete neurale. Utilizzare questa funzione quando è necessaria una maggiore flessibilità nell'architettura di rete o nell'algoritmo di addestramento.

Per ulteriori informazioni, vedere Transition Legacy Neural Network Code to dlnetwork Workflows.

Vedi anche

Time Series Modeler | fitrnet (Statistics and Machine Learning Toolbox) | fitcnet (Statistics and Machine Learning Toolbox) | trainnet | trainingOptions | dlnetwork

Argomenti

• Training Neural Networks with Tabular Data
• Training Neural Networks with Time Series Data
• Transition Legacy Neural Network Code to dlnetwork Workflows