ImageSearcher

ImageSearcher de clase final pública

Realiza la búsqueda de similitud en las imágenes.

La API espera un modelo TFLite con metadatos de modelo TFLite opcionales, pero muy recomendables . .

  • Tensor de imagen de entrada ( kTfLiteUInt8 / kTfLiteFloat32 )
    • entrada de imagen de tamaño [batch x height x width x channels] .
    • la inferencia por lotes no es compatible (se requiere que el batch sea 1).
    • solo se admiten entradas RGB (se requiere que los channels sean 3).
    • si el tipo es kTfLiteFloat32 , es necesario adjuntar NormalizationOptions a los metadatos para la normalización de entrada.
  • Tensor de salida ( kTfLiteUInt8 / kTfLiteFloat32 )
    • N componentes correspondientes a las N dimensiones del vector de características devuelto para esta capa de salida.
    • 2 o 4 dimensiones, es decir, [1 x N] o [1 x 1 x 1 x N] .

TODO(b/180502532): agregue un puntero al modelo de ejemplo.

TODO(b/222671076): agregue métodos de creación de fábrica sin opciones, como `createFromFile`, una vez que se admita el formato de archivo único (archivo de índice empaquetado en el modelo).

Clases anidadas

clase ImageSearcher.ImageSearcherOptions Opciones para configurar un ImageSearcher.

Métodos públicos

Buscador de imágenes estático
createFromBufferAndOptions ( ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions opciones)
Crea una instancia de ImageSearcher con un búfer de modelo e ImageSearcher.ImageSearcherOptions .
Buscador de imágenes estático
createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions opciones, int indexFd)
Buscador de imágenes estático
createFromFileAndOptions (Context context, String modelPath, opciones de ImageSearcher.ImageSearcherOptions )
Crea una instancia de ImageSearcher a partir de ImageSearcher.ImageSearcherOptions .
Buscador de imágenes estático
createFromFileAndOptions (Modelo de archivoArchivo, ImageSearcher.ImageSearcherOptions opciones )
Crea una instancia de ImageSearcher .
Lista < Vecino más cercano>
búsqueda (imagen de TensorImage , opciones de ImageProcessingOptions )
Realiza la extracción de incrustación en el TensorImage proporcionado con ImageProcessingOptions , seguida de la búsqueda del vecino más cercano en el índice.
Lista < Vecino más cercano>
buscar (imagen MlImage )
Realiza la extracción incrustada en la MlImage proporcionada, seguida de la búsqueda del vecino más cercano en el índice.
Lista < Vecino más cercano>
buscar (imagen MlImage , opciones ImageProcessingOptions )
Realiza la extracción de incrustación en el MlImage provisto con ImageProcessingOptions , seguida de la búsqueda del vecino más cercano en el índice.
Lista < Vecino más cercano>
buscar (imagen de TensorImage )
Realiza la extracción incrustada en el TensorImage proporcionado, seguido de la búsqueda del vecino más cercano en el índice.

Métodos Heredados

Métodos públicos

ImageSearcher estático público createFromBufferAndOptions ( ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions opciones)

Crea una instancia de ImageSearcher con un búfer de modelo e ImageSearcher.ImageSearcherOptions .

Parámetros
modeloBuffer un ByteBuffer directo o un MappedByteBuffer del modelo de búsqueda
opciones
Lanza
Argumento de excepción ilegal si el búfer del modelo no es un ByteBuffer directo o un MappedByteBuffer
IOException si se produce un error de E/S al cargar el archivo de índice
IllegalStateExceptionIlegalStateException si hay un error interno
Excepción en tiempo de ejecución si hay un error no especificado

ImageSearcher estático público createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions options, int indexFd)

Parámetros
modeloBuffer
opciones
índiceFd

ImageSearcher estático público createFromFileAndOptions (contexto de contexto, String modelPath, opciones de ImageSearcher.ImageSearcherOptions )

Crea una instancia de ImageSearcher a partir de ImageSearcher.ImageSearcherOptions .

Parámetros
contexto
modeloPath ruta del modelo de búsqueda con metadatos en los activos
opciones
Lanza
IOException si se produce un error de E/S al cargar el modelo tflite o el archivo de índice
Argumento de excepción ilegal si un argumento no es válido
IllegalStateExceptionIlegalStateException si hay un error interno
Excepción en tiempo de ejecución si hay un error no especificado

ImageSearcher estático público createFromFileAndOptions (Modelo de archivoFile , ImageSearcher.ImageSearcherOptions opciones)

Crea una instancia de ImageSearcher .

Parámetros
modeloArchivo el modelo de búsqueda Instancia de File
opciones
Lanza
IOException si se produce un error de E/S al cargar el modelo tflite o el archivo de índice
Argumento de excepción ilegal si un argumento no es válido
IllegalStateExceptionIlegalStateException si hay un error interno
Excepción en tiempo de ejecución si hay un error no especificado

lista pública < Neighbor más cercano> búsqueda (imagen de TensorImage , opciones de ImageProcessingOptions )

Realiza la extracción de incrustación en el TensorImage proporcionado con ImageProcessingOptions , seguida de la búsqueda del vecino más cercano en el índice.

ImageSearcher admite las siguientes opciones:

ImageSearcher admite los siguientes tipos de espacio de color TensorImage :

Parámetros
imagen un objeto UINT8 TensorImage que representa una imagen RGB o YUV
opciones
Lanza
Argumento de excepción ilegal si el tipo de espacio de color de la imagen no es compatible

lista pública < Vecino más cercano> búsqueda (imagen MlImage )

Realiza la extracción incrustada en la MlImage proporcionada, seguida de la búsqueda del vecino más cercano en el índice.

Parámetros
imagen un objeto MlImage que representa una imagen
Lanza
Argumento de excepción ilegal si el tipo de almacenamiento o formato de la imagen no es compatible

lista pública < Vecino más cercano> búsqueda (imagen MlImage , opciones ImageProcessingOptions )

Realiza la extracción de incrustación en el MlImage provisto con ImageProcessingOptions , seguida de la búsqueda del vecino más cercano en el índice.

ImageSearcher admite las siguientes opciones:

Parámetros
imagen un objeto MlImage que representa una imagen
opciones configura opciones que incluyen ROI y rotación
Lanza
Argumento de excepción ilegal si el tipo de almacenamiento o formato de la imagen no es compatible

lista pública < Vecino más cercano> búsqueda (imagen de TensorImage )

Realiza la extracción incrustada en el TensorImage proporcionado, seguido de la búsqueda del vecino más cercano en el índice.

ImageSearcher admite los siguientes tipos de espacio de color TensorImage :

Parámetros
imagen un objeto UINT8 TensorImage que representa una imagen RGB o YUV
Lanza
Argumento de excepción ilegal si el tipo de espacio de color de la imagen no es compatible