Un array multidimensionale digitato utilizzato in Tensorflow Lite.
L'handle nativo di un Tensor
è gestito da NativeInterpreterWrapper
e non necessita di essere chiuso dal client. Tuttavia, una volta chiuso NativeInterpreterWrapper
, l'handle del tensore verrà invalidato.
Classi nidificate
classe | Tensor.QuantizationParams | Parametri di quantizzazione che corrispondono alla tabella QuantizationParameters nel file di schema del modello TFLite. |
Metodi pubblici
ByteBuffer astratto | asReadOnlyBuffer () Restituisce una vista ByteBuffer di sola lettura dei dati del tensore. |
tipo di dati astratto | tipo di dati () Restituisce il DataType degli elementi memorizzati nel Tensor. |
astratto int | numByte () Restituisce la dimensione, in byte, dei dati del tensore. |
astratto int | numerodimensioni () Restituisce il numero di dimensioni (a volte indicato come rango ) del Tensore. |
astratto int | numElementi () Restituisce il numero di elementi in una vista appiattita (1-D) del tensore. |
Tensor.QuantizationParams astratto | quantizzazioneParams () Restituisce i parametri di quantizzazione del tensore all'interno dell'interprete proprietario. |
int astratto[] | |
int astratto[] | formaFirma () Restituisce la forma originale del Tensore, ovvero le dimensioni di ciascuna dimensione, prima che venisse eseguito qualsiasi ridimensionamento. |
Metodi pubblici
estratto pubblico ByteBuffer asReadOnlyBuffer ()
Restituisce una vista ByteBuffer
di sola lettura dei dati del tensore.
In generale, questo metodo è molto utile per ottenere una vista di sola lettura dei dati del tensore di output, *dopo* che l'inferenza è stata eseguita (ad esempio, tramite InterpreterApi.run(Object, Object)
). In particolare, alcuni grafici hanno output di forma dinamica, che possono rendere scomodo l'inserimento di un buffer di output predefinito all'interprete. Esempio di utilizzo:
interpreter.run(input, null);
ByteBuffer outputBuffer = interpreter.getOutputTensor(0).asReadOnlyBuffer();
// Copy or read from outputBuffer.
ATTENZIONE: Se il tensore non è stato ancora allocato, ad esempio prima che sia stata eseguita l'inferenza, il risultato non è definito. Si noti che il puntatore del tensore sottostante può anche cambiare quando il tensore viene invalidato in qualsiasi modo (ad esempio, se viene eseguita l'inferenza o il grafico viene ridimensionato), quindi *non* è sicuro mantenere un riferimento al buffer restituito oltre l'uso immediato direttamente dopo l’inferenza. Esempio di utilizzo *cattivo*:
ByteBuffer outputBuffer = interpreter.getOutputTensor(0).asReadOnlyBuffer();
interpreter.run(input, null);
// Copy or read from outputBuffer (which may now be invalid).
Lancia
IllegalArgumentException | se i dati del tensore non sono stati allocati. |
---|
estratto pubblico DataType dataType ()
Restituisce il DataType
degli elementi memorizzati nel Tensor.
public abstract int numBytes ()
Restituisce la dimensione, in byte, dei dati del tensore.
public abstract int numDimensions ()
Restituisce il numero di dimensioni (a volte indicato come rango ) del Tensore.
Sarà 0 per uno scalare, 1 per un vettore, 2 per una matrice, 3 per un tensore tridimensionale ecc.
public abstract int numElements ()
Restituisce il numero di elementi in una vista appiattita (1-D) del tensore.
public abstract Tensor.QuantizationParams quantizationParams ()
Restituisce i parametri di quantizzazione del tensore all'interno dell'interprete proprietario.
Solo i tensori quantizzati hanno QuantizationParameters
validi. Per tensori non quantizzati, i valori di scala e zero_point sono entrambi 0.
pubblico astratto int[] forma ()
Restituisce la forma del Tensore, ovvero le dimensioni di ciascuna dimensione.
ritorna
- un array in cui l'i-esimo elemento è la dimensione dell'i-esima dimensione del tensore.
public abstract int[] shapeSignature ()
Restituisce la forma originale del Tensore, ovvero le dimensioni di ciascuna dimensione, prima che venisse eseguito qualsiasi ridimensionamento. Le dimensioni sconosciute sono contrassegnate con un valore pari a -1.
ritorna
- un array in cui l'i-esimo elemento è la dimensione dell'i-esima dimensione del tensore.