A pesquisa de imagens permite procurar imagens semelhantes em um banco de dados. Ele funciona incorporando a consulta de pesquisa em um vetor de alta dimensão que representa o significado semântico da consulta, seguido de uma pesquisa de similaridade em um índice predefinido e personalizado usando ScaNN (Scalable Nearest Neighbors).
Ao contrário da classificação de imagens, aumentar o número de itens que podem ser reconhecidos não exige o retreinamento de todo o modelo. Para adicionar novos itens, basta recriar o índice. Isso também permite trabalhar com bancos de dados de imagens maiores (mais de 100 mil itens).
Use a API Task Library ImageSearcher para implantar seu pesquisador de imagens personalizado
nos seus apps para dispositivos móveis.
Principais recursos da API ImageSearcher
Usa uma única imagem como entrada, realiza a extração de embeddings e a pesquisa de vizinho mais próximo no índice.
Processamento de imagens de entrada, incluindo rotação, redimensionamento e conversão de espaço de cores.
Região de interesse da imagem de entrada.
Pré-requisitos
Antes de usar a API ImageSearcher, é preciso criar um índice com base no corpus personalizado de imagens para pesquisar. Isso pode ser feito usando a API Model Maker
Searcher
seguindo e adaptando o tutorial.
Para isso, você vai precisar de:
- um modelo de incorporação de imagens do TFLite, como o mobilenet
v3.
Confira mais modelos de incorporação pré-treinados (também conhecidos como modelos de vetor de recursos) na
coleção de módulos de imagem do Google no Kaggle
Models.
- seu corpus de imagens.
Depois dessa etapa, você terá um modelo de pesquisa TFLite independente (por exemplo,
mobilenet_v3_searcher.tflite), que é o modelo incorporador de imagens original com
o índice anexado aos Metadados do modelo TFLite.
Executar inferência em Java
Etapa 1: importar a dependência do Gradle e outras configurações
Copie o arquivo de modelo de pesquisa .tflite para o diretório de recursos do módulo
Android em que o modelo será executado. Especifique que o arquivo não deve ser
compactado e adicione a biblioteca do TensorFlow Lite ao arquivo build.gradle
do módulo:
android {
// Other settings
// Specify tflite index file should not be compressed for the app apk
aaptOptions {
noCompress "tflite"
}
}
dependencies {
// Other dependencies
// Import the Task Vision Library dependency
implementation 'org.tensorflow:tensorflow-lite-task-vision:0.4.4'
// Import the GPU delegate plugin Library for GPU inference
implementation 'org.tensorflow:tensorflow-lite-gpu-delegate-plugin:0.4.4'
}
Etapa 2: usar o modelo
// Initialization
ImageSearcherOptions options =
ImageSearcherOptions.builder()
.setBaseOptions(BaseOptions.builder().useGpu().build())
.setSearcherOptions(
SearcherOptions.builder().setL2Normalize(true).build())
.build();
ImageSearcher imageSearcher =
ImageSearcher.createFromFileAndOptions(context, modelFile, options);
// Run inference
List<NearestNeighbor> results = imageSearcher.search(image);
Consulte o código-fonte e o
javadoc
para mais opções de configuração do ImageSearcher.
Executar inferência em C++
// Initialization
ImageSearcherOptions options;
options.mutable_base_options()->mutable_model_file()->set_file_name(model_path);
options.mutable_embedding_options()->set_l2_normalize(true);
std::unique_ptr<ImageSearcher> image_searcher = ImageSearcher::CreateFromOptions(options).value();
// Create input frame_buffer from your inputs, `image_data` and `image_dimension`.
// See more information here: tensorflow_lite_support/cc/task/vision/utils/frame_buffer_common_utils.h
std::unique_ptr<FrameBuffer> frame_buffer = CreateFromRgbRawBuffer(
image_data, image_dimension);
// Run inference
const SearchResult result = image_searcher->Search(*frame_buffer).value();
Consulte o código-fonte para mais opções de configuração do ImageSearcher.
Executar inferência em Python
Etapa 1: instale o pacote Pypi de suporte do TensorFlow Lite.
Instale o pacote Pypi de suporte do TensorFlow Lite usando o seguinte comando:
pip install tflite-support
Etapa 2: usar o modelo
from tflite_support.task import vision
# Initialization
image_searcher = vision.ImageSearcher.create_from_file(model_path)
# Run inference
image = vision.TensorImage.create_from_file(image_file)
result = image_searcher.search(image)
Consulte o código-fonte para mais opções de configuração do ImageSearcher.
Resultados de exemplo
Results:
Rank#0:
metadata: burger
distance: 0.13452
Rank#1:
metadata: car
distance: 1.81935
Rank#2:
metadata: bird
distance: 1.96617
Rank#3:
metadata: dog
distance: 2.05610
Rank#4:
metadata: cat
distance: 2.06347
Teste a ferramenta de demonstração da CLI simples para ImageSearcher com seu próprio modelo e dados de teste.