ImageSearcher

clase final pública ImageSearcher

Realiza búsqueda de similitud en imágenes.

La API espera un modelo TFLite con metadatos del modelo TFLite opcionales, pero muy recomendados. .

  • Tensor de imagen de entrada ( kTfLiteUInt8 / kTfLiteFloat32 )
    • entrada de imagen de tamaño [batch x height x width x channels] .
    • No se admite la inferencia por lotes (se requiere que batch sea 1).
    • Solo se admiten entradas RGB (se requieren 3 channels ).
    • Si el tipo es kTfLiteFloat32 , se deben adjuntar NormalizationOptions a los metadatos para la normalización de la 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): agrega 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 (opciones ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions )
Crea una instancia ImageSearcher con un búfer de modelo e ImageSearcher.ImageSearcherOptions .
Buscador de imágenes estático
createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer, opciones ImageSearcher.ImageSearcherOptions , int indexFd)
Buscador de imágenes estático
createFromFileAndOptions (contexto contextual, ruta del modelo de cadena , opciones ImageSearcher.ImageSearcherOptions )
Crea una instancia ImageSearcher a partir de ImageSearcher.ImageSearcherOptions .
Buscador de imágenes estático
createFromFileAndOptions (opciones de archivo modelFile, ImageSearcher.ImageSearcherOptions )
Crea una instancia ImageSearcher .
Lista < Vecino más cercano >
buscar (imagen TensorImage , opciones ImageProcessingOptions )
Realiza una extracción de incrustación en el TensorImage proporcionado con ImageProcessingOptions , seguido de la búsqueda del vecino más cercano en el índice.
Lista < Vecino más cercano >
buscar (imagen MlImage )
Realiza una extracción de incrustación en el MlImage proporcionado, seguido de una búsqueda del vecino más cercano en el índice.
Lista < Vecino más cercano >
buscar (imagen MlImage , opciones ImageProcessingOptions )
Realiza una extracción de incrustación en el MlImage proporcionado con ImageProcessingOptions , seguido de la búsqueda del vecino más cercano en el índice.
Lista < Vecino más cercano >
buscar (imagen TensorImage )
Realiza una extracción de incrustación en la TensorImage proporcionada, seguida de una búsqueda del vecino más cercano en el índice.

Métodos heredados

Métodos públicos

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

Crea una instancia 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
IOExcepción si se produce un error de E/S al cargar el archivo de índice
Excepción de estado ilegal 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, opciones ImageSearcher.ImageSearcherOptions , int indexFd)

Parámetros
modeloBuffer
opciones
índiceFd

ImageSearcher estático público createFromFileAndOptions (contexto contextual, ruta del modelo de cadena , opciones ImageSearcher.ImageSearcherOptions )

Crea una instancia ImageSearcher a partir de ImageSearcher.ImageSearcherOptions .

Parámetros
contexto
modeloRuta ruta del modelo de búsqueda con metadatos en los activos
opciones
Lanza
IOExcepción 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
Excepción de estado ilegal si hay un error interno
Excepción en tiempo de ejecución si hay un error no especificado

ImageSearcher estático público createFromFileAndOptions (opciones de archivo modelFile, ImageSearcher.ImageSearcherOptions )

Crea una instancia ImageSearcher .

Parámetros
modeloArchivo la instancia File del modelo de búsqueda
opciones
Lanza
IOExcepción 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
Excepción de estado ilegal si hay un error interno
Excepción en tiempo de ejecución si hay un error no especificado

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

Realiza una extracción de incrustación en el TensorImage proporcionado con ImageProcessingOptions , seguido 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 > buscar (imagen MlImage )

Realiza una extracción de incrustación en el MlImage proporcionado, seguido de una 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 una extracción de incrustación en el MlImage proporcionado con ImageProcessingOptions , seguido 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 TensorImage )

Realiza una extracción de incrustación en la TensorImage proporcionada, seguida de una 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