Tensor

Tensore di interfaccia pubblica
Sottoclassi indirette conosciute

Un array multidimensionale tipizzato staticamente.

Esistono due categorie di tensori in TensorFlow Java: typed tensors e raw tensors . Il primo mappa la memoria nativa del tensore su uno spazio dati tipizzato n-dimensionale, consentendo operazioni di I/O dirette dalla JVM, mentre il secondo è solo un riferimento a un tensore nativo che consente operazioni di base e accesso ai dati flat.

ATTENZIONE: le risorse consumate dall'oggetto Tensor devono essere liberate esplicitamente richiamando il metodo close() quando l'oggetto non è più necessario. Ad esempio, utilizzando un blocco try-with-resources:

try (Tensor t = Tensor.of(...)) {
   doSomethingWith(t);
 
 }

Le istanze di un tensore non sono thread-safe.

Metodi pubblici

RawTensor astratto
come RawTensor ()
Restituisce una rappresentazione grezza (non tipizzata) di questo tensore
vuoto astratto
vicino ()
Rilascia risorse associate al Tensore.
tipo di dati astratto
tipodati ()
Restituisce il DataType degli elementi memorizzati nel tensore.
astratto lungo
numByte ()
Restituisce la dimensione, in byte, dei dati del tensore.
abstract static <T estende TType > T
di (tipo Classe<T>, forma forma , dimensione lunga, consumer<T> dataInitializer)
Assegna un tensore di un determinato tipo di dati, forma e dimensione.
abstract static <T estende TType > T
di (tipo Classe<T>, forma forma)
Assegna un tensore di un dato tipo e forma dati.
abstract static <T estende TType > T
di (tipo Classe<T>, forma forma , dimensione lunga)
Assegna un tensore di un determinato tipo di dati, forma e dimensione.
abstract static <T estende TType > T
di (tipo Classe<T>, forma forma , consumatore<T> dataInitializer)
Assegna e inizializza un tensore di un dato tipo e forma.
abstract static <T estende TType > T
di (tipo Classe<T>, forma forma , ByteDataBuffer rawData)
Crea un tensore di qualsiasi tipo dai dati grezzi forniti dal buffer specificato.
forma astratta
forma ()
Restituisce la forma del tensore.

Metodi ereditati

Metodi pubblici

estratto pubblico RawTensor asRawTensor ()

Restituisce una rappresentazione grezza (non tipizzata) di questo tensore

pubblico astratto vuoto chiudi ()

Rilascia risorse associate al Tensore.

ATTENZIONE: Questo deve essere invocato per tutti i tensori che non sono stati prodotti da un'operazione di entusiasmo altrimenti la memoria verrà persa.

L'oggetto Tensor non è più utilizzabile dopo close .

estratto pubblico DataType dataType ()

Restituisce il DataType degli elementi memorizzati nel tensore.

public abstract long numBytes ()

Restituisce la dimensione, in byte, dei dati del tensore.

T astratto statico pubblico di (tipo Classe<T>, forma forma , dimensione lunga, consumatore<T> dataInitializer)

Assegna un tensore di un determinato tipo di dati, forma e dimensione.

Questo metodo è identico a of(Class, Shape, Consumer) , tranne per il fatto che la dimensione finale del tensore può essere impostata esplicitamente invece di essere calcolata dal tipo di dati e dalla forma.

Ciò potrebbe essere utile per i tipi di tensore che memorizzano dati ma anche metadati nella memoria del tensore, come la tabella di ricerca in un tensore di stringhe.

Parametri
tipo la classe del tipo tensore
forma forma del tensore
misurare dimensione in byte del tensore o -1 per calcolare la dimensione dalla forma
dataInitializer metodo che riceve la funzione di accesso ai dati del tensore allocati per l'inizializzazione
Ritorni
  • un tensore allocato e inizializzato
Lancia
IllegalArgumentException se size è inferiore allo spazio minimo richiesto per memorizzare i dati del tensore
IllegalArgumentException se size è impostata su -1 ma gli elementi del type indicato sono di lunghezza variabile (ad esempio stringhe)
IllegalArgumentException se shape è totalmente o parzialmente unknown
IllegalStateException se il tensore non è stato allocato

T astratto statico pubblico di (tipo Classe<T>, Forma forma)

Assegna un tensore di un dato tipo e forma dati.

La quantità di memoria da allocare deriva dal tipo di dati e dalla forma del tensore e non viene inizializzata.

Parametri
tipo la classe del tipo tensore
forma forma del tensore
Ritorni
  • un tensore allocato ma non inizializzato
Lancia
IllegalArgumentException se gli elementi del type indicato sono di lunghezza variabile (es. stringhe)
IllegalArgumentException se shape è totalmente o parzialmente unknown
IllegalStateException se il tensore non è stato allocato

T astratto statico pubblico di (tipo Classe<T>, forma forma , dimensione lunga)

Assegna un tensore di un determinato tipo di dati, forma e dimensione.

Questo metodo è identico a of(Class, Shape) , tranne per il fatto che la dimensione finale del tensore può essere impostata esplicitamente invece di calcolarla dal tipo di dati e dalla forma, che potrebbe essere maggiore dello spazio effettivo richiesto per archiviare i dati ma non inferiore .

Parametri
tipo la classe del tipo tensore
forma forma del tensore
misurare dimensione in byte del tensore o -1 per calcolare la dimensione dalla forma
Ritorni
  • un tensore allocato ma non inizializzato
Lancia
IllegalArgumentException se size è inferiore allo spazio minimo richiesto per memorizzare i dati del tensore
IllegalArgumentException se size è impostata su -1 ma gli elementi del type indicato sono di lunghezza variabile (ad esempio stringhe)
IllegalArgumentException se shape è totalmente o parzialmente unknown
IllegalStateException se il tensore non è stato allocato
Vedi anche

T astratto statico pubblico di (tipo Classe<T>, forma forma, consumatore<T> dataInitializer)

Assegna e inizializza un tensore di un dato tipo e forma.

La quantità di memoria da allocare dipende dal tipo di dati e dalla forma del tensore. I dati del tensore vengono inizializzati chiamando dataInitializer , che riceve in argomento il valore restituito da ERROR(/#data()) sul tensore allocato. Per esempio:

FloatNdArray data = ...
 try (TFloat32 t = Tensor.of(TFloat32.class, Shape.of(2, 2), data::copyTo)) {
   ...
 
 }

Se dataInitializer fallisce e genera un'eccezione, il tensore allocato verrà rilasciato automaticamente prima di lanciare nuovamente la stessa eccezione.

Parametri
tipo la classe del tipo tensore
forma forma del tensore
dataInitializer metodo che riceve la funzione di accesso ai dati del tensore allocati per l'inizializzazione
Ritorni
  • un tensore allocato e inizializzato
Lancia
IllegalArgumentException se gli elementi del type indicato sono di lunghezza variabile (es. stringhe)
IllegalArgumentException se shape è totalmente o parzialmente unknown
IllegalStateException se il tensore non è stato allocato

T astratto statico pubblico di (tipo Classe<T>, forma forma , ByteDataBuffer rawData)

Crea un tensore di qualsiasi tipo dai dati grezzi forniti dal buffer specificato.

I dati devono essere stati codificati in data secondo le specifiche dell'API TensorFlow C.

Parametri
tipo la classe del tipo tensore
forma la forma del tensore.
rawData un buffer contenente i dati grezzi del tensore.
Lancia
IllegalArgumentException se rawData non è abbastanza grande da contenere i dati del tensore
IllegalArgumentException se shape è totalmente o parzialmente unknown
IllegalStateException se il tensore non è stato assegnato con i parametri specificati

public abstract Forma forma ()

Restituisce la forma del tensore.