Tensor

Tensore di interfaccia pubblica

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[]
forma ()
Restituisce la forma del Tensore, ovvero le dimensioni di ciascuna dimensione.
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.