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 | |
astratto lungo | numByte () Restituisce la dimensione, in byte, dei dati del tensore. |
abstract static <T estende TType > T | |
abstract static <T estende TType > T | |
abstract static <T estende TType > T | |
abstract static <T estende TType > T | |
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 |
Vedi anche
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 |