Tensor

Tensor de interface pública
Subclasses indiretas conhecidas

Uma matriz multidimensional digitada estaticamente.

Existem duas categorias de tensores no TensorFlow Java: typed tensors e raw tensors . O primeiro mapeia a memória nativa do tensor para um espaço de dados digitado n-dimensional, permitindo operações diretas de E/S da JVM, enquanto o último é apenas uma referência a um tensor nativo que permite operações básicas e acesso simples a dados.

AVISO: Os recursos consumidos pelo objeto Tensor devem ser liberados explicitamente invocando o método close() quando o objeto não for mais necessário. Por exemplo, usando um bloco try-with-resources:

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

As instâncias de um tensor não são seguras para threads.

Métodos Públicos

Resumo Raw Tensor
asRawTensor ()
Retorna uma representação bruta (sem tipo) deste tensor
vazio abstrato
fechar ()
Libere recursos associados ao Tensor.
tipo de dados abstrato
tipo de dados ()
Retorna o DataType dos elementos armazenados no tensor.
abstrato longo
numBytes ()
Retorna o tamanho, em bytes, dos dados do tensor.
abstrato estático <T estende TType > T
de (tipo Class<T>, formato Shape , tamanho longo, Consumer<T> dataInitializer)
Aloca um tensor de um determinado tipo de dados, forma e tamanho.
abstrato estático <T estende TType > T
de (tipo Class<T>, formato Shape )
Aloca um tensor de um determinado tipo de dados e forma.
abstrato estático <T estende TType > T
de (tipo Class<T>, formato de forma , tamanho longo)
Aloca um tensor de um determinado tipo de dados, forma e tamanho.
abstrato estático <T estende TType > T
de (tipo Class<T>, formato Shape , Consumer<T> dataInitializer)
Aloca e inicializa um tensor de um determinado tipo de dados e forma.
abstrato estático <T estende TType > T
de (tipo Class<T>, formato Shape , ByteDataBuffer rawData)
Cria um Tensor de qualquer tipo a partir dos dados brutos fornecidos pelo buffer fornecido.
forma abstrata
forma ()
Retorna a forma do tensor.

Métodos herdados

Métodos Públicos

resumo público RawTensor asRawTensor ()

Retorna uma representação bruta (sem tipo) deste tensor

público abstrato vazio fechar ()

Libere recursos associados ao Tensor.

AVISO: Isso deve ser invocado para todos os tensores que não foram produzidos por uma operação antecipada ou a memória vazará.

O objeto Tensor não pode mais ser usado após retornos close .

tipo de dados abstrato público tipo de dados ()

Retorna o DataType dos elementos armazenados no tensor.

público abstrato longo numBytes ()

Retorna o tamanho, em bytes, dos dados do tensor.

público estático abstrato T de (tipo Classe<T>, formato de forma , tamanho longo, Consumer<T> dataInitializer)

Aloca um tensor de um determinado tipo de dados, forma e tamanho.

Este método é idêntico a of(Class, Shape, Consumer) , exceto que o tamanho final do tensor pode ser definido explicitamente em vez de ser calculado a partir do tipo de dados e da forma.

Isso pode ser útil para tipos de tensores que armazenam dados, mas também metadados na memória do tensor, como a tabela de consulta em um tensor de strings.

Parâmetros
tipo a classe do tipo tensor
forma forma do tensor
tamanho tamanho em bytes do tensor ou -1 para calcular o tamanho da forma
inicializador de dados método que recebe acessador para os dados do tensor alocado para inicialização
Devoluções
  • um tensor alocado e inicializado
Lança
Exceção de argumento ilegal se size for menor que o espaço mínimo necessário para armazenar os dados do tensor
Exceção de argumento ilegal se size estiver definido como -1, mas os elementos do type fornecido tiverem comprimento variável (por exemplo, strings)
Exceção de argumento ilegal se shape é total ou parcialmente unknown
IllegalStateException se o tensor não foi alocado

público estático abstrato T de (tipo Class<T>, formato Shape )

Aloca um tensor de um determinado tipo de dados e forma.

A quantidade de memória a ser alocada é derivada do tipo de dados e da forma do tensor e não é inicializada.

Parâmetros
tipo a classe do tipo tensor
forma forma do tensor
Devoluções
  • um tensor alocado, mas não inicializado
Lança
Exceção de argumento ilegal se os elementos de um determinado type forem de comprimento variável (por exemplo, strings)
Exceção de argumento ilegal se shape é total ou parcialmente unknown
IllegalStateException se o tensor não foi alocado

público estático abstrato T de (tipo Class<T>, formato de forma , tamanho longo)

Aloca um tensor de um determinado tipo de dados, forma e tamanho.

Este método é idêntico a of(Class, Shape) , exceto que o tamanho final do tensor pode ser definido explicitamente em vez de calculá-lo a partir do tipo de dados e da forma, que pode ser maior que o espaço real necessário para armazenar os dados, mas não menor .

Parâmetros
tipo a classe do tipo tensor
forma forma do tensor
tamanho tamanho em bytes do tensor ou -1 para calcular o tamanho da forma
Devoluções
  • um tensor alocado, mas não inicializado
Lança
Exceção de argumento ilegal se size for menor que o espaço mínimo necessário para armazenar os dados do tensor
Exceção de argumento ilegal se size estiver definido como -1, mas os elementos do type fornecido tiverem comprimento variável (por exemplo, strings)
Exceção de argumento ilegal se shape é total ou parcialmente unknown
IllegalStateException se o tensor não foi alocado
Veja também

público estático abstrato T de (tipo Class<T>, formato Shape , Consumer<T> dataInitializer)

Aloca e inicializa um tensor de um determinado tipo de dados e forma.

A quantidade de memória a ser alocada é derivada do tipo de dados e da forma do tensor. Os dados do tensor são inicializados chamando o dataInitializer , que recebe como argumento o valor retornado por ERROR(/#data()) no tensor alocado. Por exemplo:

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

Se dataInitializer falhar e lançar uma exceção, o tensor alocado será liberado automaticamente antes de lançar novamente a mesma exceção.

Parâmetros
tipo a classe do tipo tensor
forma forma do tensor
inicializador de dados método que recebe acessador para os dados do tensor alocado para inicialização
Devoluções
  • um tensor alocado e inicializado
Lança
Exceção de argumento ilegal se os elementos de um determinado type forem de comprimento variável (por exemplo, strings)
Exceção de argumento ilegal se shape é total ou parcialmente unknown
IllegalStateException se o tensor não foi alocado

público estático abstrato T de (tipo Class<T>, formato Shape , ByteDataBuffer rawData)

Cria um Tensor de qualquer tipo a partir dos dados brutos fornecidos pelo buffer fornecido.

Os dados devem ter sido codificados em data de acordo com a especificação da API TensorFlow C.

Parâmetros
tipo a classe do tipo tensor
forma a forma do tensor.
dados não tratados um buffer contendo os dados brutos do tensor.
Lança
Exceção de argumento ilegal se rawData não for grande o suficiente para conter os dados do tensor
Exceção de argumento ilegal se shape é total ou parcialmente unknown
IllegalStateException se o tensor não foi alocado com os parâmetros fornecidos

forma abstrata pública forma ()

Retorna a forma do tensor.