Tensor

Tensor de interfaz pública

Una matriz multidimensional tipada utilizada en Tensorflow Lite.

El identificador nativo de un Tensor lo administra NativeInterpreterWrapper y no es necesario que el cliente lo cierre. Sin embargo, una vez que se haya cerrado NativeInterpreterWrapper , el controlador de tensor se invalidará.

Clases anidadas

clase Tensor.QuantizationParams Parámetros de cuantificación que corresponden a la tabla, QuantizationParameters , en el archivo de esquema del modelo TFLite.

Métodos públicos

Buffer de bytes abstracto
comoReadOnlyBuffer ()
Devuelve una vista ByteBuffer de solo lectura de los datos del tensor.
tipo de datos abstracto
tipo de datos ()
Devuelve el tipo de DataType de los elementos almacenados en el tensor.
abstracto int
númeroBytes ()
Devuelve el tamaño, en bytes, de los datos del tensor.
abstracto int
númDimensiones ()
Devuelve el número de dimensiones (a veces denominado rango ) del tensor.
abstracto int
númeroElementos ()
Devuelve el número de elementos en una vista aplanada (1-D) del tensor.
resumen Tensor.QuantizationParams
quantizationParams ()
Devuelve los parámetros de cuantificación del tensor dentro del intérprete propietario.
entero abstracto[]
forma ()
Devuelve la forma del Tensor, es decir, los tamaños de cada dimensión.
entero abstracto[]
formaFirma ()
Devuelve la forma original del tensor, es decir, los tamaños de cada dimensión, antes de realizar cualquier cambio de tamaño.

Métodos públicos

resumen público ByteBuffer asReadOnlyBuffer ()

Devuelve una vista ByteBuffer de solo lectura de los datos del tensor.

En general, este método es más útil para obtener una vista de solo lectura de los datos del tensor de salida, *después* de que se haya ejecutado la inferencia (por ejemplo, a través de InterpreterApi.run(Object, Object) ). En particular, algunos gráficos tienen salidas con formas dinámicas, lo que puede dificultar la alimentación de un búfer de salida predefinido para el intérprete. Ejemplo de uso:

 interpreter.run(input, null);
 ByteBuffer outputBuffer = interpreter.getOutputTensor(0).asReadOnlyBuffer();
 // Copy or read from outputBuffer.

ADVERTENCIA: Si aún no se ha asignado el tensor, por ejemplo, antes de ejecutar la inferencia, el resultado no está definido. Tenga en cuenta que el puntero del tensor subyacente también puede cambiar cuando el tensor se invalida de alguna manera (por ejemplo, si se ejecuta la inferencia o se cambia el tamaño del gráfico), por lo que *no* es seguro mantener una referencia al búfer devuelto más allá del uso inmediato siguiendo directamente la inferencia. Ejemplo de uso *malo*:

 ByteBuffer outputBuffer = interpreter.getOutputTensor(0).asReadOnlyBuffer();
 interpreter.run(input, null);
 // Copy or read from outputBuffer (which may now be invalid).

Lanza
Argumento de excepción ilegal si los datos del tensor no han sido asignados.

tipo de datos abstracto público tipo de datos ()

Devuelve el tipo de DataType de los elementos almacenados en el tensor.

public abstract int numBytes ()

Devuelve el tamaño, en bytes, de los datos del tensor.

public abstract int numDimensions ()

Devuelve el número de dimensiones (a veces denominado rango ) del tensor.

Será 0 para un escalar, 1 para un vector, 2 para una matriz, 3 para un tensor tridimensional, etc.

public abstract int numElements ()

Devuelve el número de elementos en una vista aplanada (1-D) del tensor.

public abstract Tensor.QuantizationParams quantizationParams ()

Devuelve los parámetros de cuantificación del tensor dentro del intérprete propietario.

Solo los tensores cuantizados tienen QuantizationParameters válidos. Para tensores que no están cuantificados, los valores de scale y zero_point son ambos 0.

public abstract int[] forma ()

Devuelve la forma del Tensor, es decir, los tamaños de cada dimensión.

Devoluciones
  • una matriz donde el i-ésimo elemento es del tamaño de la i-ésima dimensión del tensor.

public abstract int[] shapeSignature ()

Devuelve la forma original del tensor, es decir, los tamaños de cada dimensión, antes de realizar cualquier cambio de tamaño. Las dimensiones desconocidas se designan con un valor de -1.

Devoluciones
  • una matriz donde el i-ésimo elemento es del tamaño de la i-ésima dimensión del tensor.