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.
- entrada de imagen de tamaño
kTfLiteUInt8
/ kTfLiteFloat32
)-
N
componentes correspondientes a lasN
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> | |
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:
- Región de interés (ROI) (a través
ImageProcessingOptions.Builder.setRoi(Rect)
). Por defecto, la imagen completa. - rotación de imágenes (a través
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). El valor predeterminado esImageProcessingOptions.Orientation.TOP_LEFT
.
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:
- Región de interés (ROI) (a través
ImageProcessingOptions.Builder.setRoi(Rect)
). Por defecto, la imagen completa. - rotación de imágenes (a través
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). El valor predeterminado esImageProcessingOptions.Orientation.TOP_LEFT
.MlImage.getRotation()
no es efectivo.
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 |
---|