作者:ALEX SALGADO
你是否曾经遇到过这样的情况:你在街上发现了一只丢失的小狗,但不知道它是否有主人? 了解如何使用向量搜索或图像搜索来做到这一点。
通过图像搜索找到你的小狗
您是否曾经遇到过这样的情况:你在街上发现了一只丢失的小狗,但不知道它是否有主人? 在 Elasticsearch 中通过图像处理使用向量搜索,此任务可以像漫画一样简单。
想象一下这个场景:在一个喧闹的下午,路易吉,一只活泼的小狗,在 Elastic 周围散步时不小心从皮带上滑落,发现自己独自在繁忙的街道上徘徊。 绝望的主人正在各个角落寻找他,用充满希望和焦虑的声音呼唤着他的名字。 与此同时,在城市的某个地方,一位细心的人注意到这只小狗表情茫然,决定提供帮助。 很快,他们给路易吉拍了一张照片,并利用所在公司的向量图像搜索技术,开始在数据库中进行搜索,希望能找到有关这只小逃亡者主人的线索。
如果你想在阅读时跟踪并执行代码,请访问在 Jupyter Notebook (Google Collab) 上运行的文件 Python 代码。
架构
我们将使用 Jupyter Notebook 来解决这个问题。 首先,我们下载要注册的小狗的图像,然后安装必要的软件包。
注意:要实现此示例,我们需要在使用图像数据填充向量数据库之前在 Elasticsearch 中创建索引。
- 首先部署 Elasticsearch(我们为你提供 14 天的免费试用期)。
- 在此过程中,请记住存储要在 Python 代码中使用的凭据(用户名、密码)。
- 为简单起见,我们将使用在 Jupyter Notebook (Google Colab) 上运行的 Python 代码。
下载代码 zip 文件并安装必要的软件包
!git clone https://github.com/salgado/image-search-01.git
!pip -q install Pillow sentence_transformers elasticsearch
让我们创建 4 个类来帮助我们完成这项任务,它们是:
- Util 类:负责处理前期任务和 Elasticsearch 索引维护。
- Dog 类:负责存储我们小狗的属性。
- DogRepository 类:负责数据持久化任务。
- DogService 类:它将成为我们的服务层。
Util class
Util 类提供了用于管理 Elasticsearch 索引的实用方法,例如创建和删除索引。
方法:
- create_index():在 Elasticsearch 中创建一个新索引。
- delete_index():从 Elasticsearch 中删除现有索引。
### Util class
from elasticsearch import Elasticsearch, exceptions as es_exceptions
import getpassclass Util:@staticmethoddef get_index_name():return "dog-image-index"@staticmethoddef get_connection():es_cloud_id = getpass.getpass('Enter Elastic Cloud ID: ')es_user = getpass.getpass('Enter cluster username: ')es_pass = getpass.getpass('Enter cluster password: ')es = Elasticsearch(cloud_id=es_cloud_id,basic_auth=(es_user, es_pass))es.info() # should return cluster inforeturn es@staticmethoddef create_index(es: Elasticsearch, index_name: str):# Specify index configurationindex_config = {"settings": {"index.refresh_interval": "5s","number_of_shards": 1},"mappings": {"properties": {"image_embedding": {"type": "dense_vector","dims": 512,"index": True,"similarity": "cosine"},"dog_id": {"type": "keyword"},"breed": {"type" : "keyword"},"image_path" : {"type" : "keyword"},"owner_name" : {"type" : "keyword"},"exif" : {"properties" : {"location": {"type": "geo_point"},"date": {"type": "date"}}}}}}# Create indexif not es.indices.exists(index=index_name):index_creation = es.indices.create(index=index_name, ignore=400, body=index_config)print("index created: ", index_creation)else:print("Index already exists.")@staticmethoddef delete_index(es: Elasticsearch, index_name: str):# delete indexes.indices.delete(index=index_name, ignore_unavailable=True)
如果你是自构建的集群,你可以参考文章 “Elasticsearch:关于在 Python 中使用 Elasticsearch 你需要知道的一切 - 8.x” 来了解如何使用客户端来连接 Elasticsearch 集群。
Dog class
Dog 类代表一只狗及其属性,例如 ID、图像路径、品种、所有者姓名和图像嵌入。
属性:
- dog_id:狗的 ID。
- image_path:狗图像的路径。
- breed:狗的品种。
- owner_name:狗的主人的名字。
- image_embedding:狗的图像嵌入。
方法:
- __init__():初始化一个新的 Dog 对象。
- generate_embedding():生成狗的图像嵌入。
- to_dict():将 Dog 对象转换为字典。
import os
from sentence_transformers import SentenceTransformer
from PIL import Image# domain class
class Dog:model = SentenceTransformer('clip-ViT-B-32')def __init__(self, dog_id, image_path, breed, owner_name):self.dog_id = dog_idself.image_path = image_pathself.breed = breedself.image_embedding = Noneself.owner_name = owner_name@staticmethoddef get_embedding(image_path: str):temp_image = Image.open(image_path)return Dog.model.encode(temp_image)def generate_embedding(self):self.image_embedding = Dog.get_embedding(self.image_path)def __repr__(self):return (f"Image(dog_id={self.dog_id}, image_path={self.image_path}, "f"breed={self.breed}, image_embedding={self.image_embedding}, "f"owner_name={self.owner_name})")def to_dict(self):return {'dog_id': self.dog_id,'image_path': self.image_path,'breed': self.breed,'image_embedding': self.image_embedding,'owner_name': self.owner_name}
DogRepository class
DogRepository 类提供了从 Elasticsearch 保存和检索狗数据的方法。
方法:
- insert():将一条新狗插入 Elasticsearch。
- bulk_insert():将多条狗批量插入到Elasticsearch中。
- search_by_image():通过图像搜索相似的狗。
from typing import List, Dict
# persistence layer
class DogRepository:def __init__(self, es_client: Elasticsearch, index_name: str = "dog-image-index"):self.es_client = es_clientself._index_name = index_nameUtil.create_index(es_client, index_name)def insert(self, dog: Dog):dog.generate_embedding()document = dog.__dict__self.es_client.index(index=self._index_name, document=document)def bulk_insert(self, dogs: List[Dog]):operations = []for dog in dogs:operations.append({"index": {"_index": self._index_name}})operations.append(dog.__dict__)self.es_client.bulk(body=operations)def search_by_image(self, image_embedding: List[float]):field_key = "image_embedding"knn = {"field": field_key,"k": 2,"num_candidates": 100,"query_vector": image_embedding,"boost": 100}# The fields to retrieve from the matching documentsfields = ["dog_id", "breed", "owner_name","image_path", "image_embedding"]try:resp = self.es_client.search(index=self._index_name,body={"knn": knn,"_source": fields},size=1)# Return the search resultsreturn respexcept Exception as e:print(f"An error occurred: {e}")return {}
DogService Class
DogService 类提供管理狗数据的业务逻辑,例如插入和搜索狗。
方法:
- insert_dog():将一条新狗插入 Elasticsearch。
- search_dogs_by_image():通过图像搜索相似的狗。
from typing import List, Dict
# persistence layer
class DogRepository:def __init__(self, es_client: Elasticsearch, index_name: str = "dog-image-index"):self.es_client = es_clientself._index_name = index_nameUtil.create_index(es_client, index_name)def insert(self, dog: Dog):dog.generate_embedding()document = dog.__dict__self.es_client.index(index=self._index_name, document=document)def bulk_insert(self, dogs: List[Dog]):operations = []for dog in dogs:operations.append({"index": {"_index": self._index_name}})operations.append(dog.__dict__)self.es_client.bulk(body=operations)def search_by_image(self, image_embedding: List[float]):field_key = "image_embedding"knn = {"field": field_key,"k": 2,"num_candidates": 100,"query_vector": image_embedding,"boost": 100}# The fields to retrieve from the matching documentsfields = ["dog_id", "breed", "owner_name","image_path", "image_embedding"]try:resp = self.es_client.search(index=self._index_name,body={"knn": knn,"_source": fields},size=1)# Return the search resultsreturn respexcept Exception as e:print(f"An error occurred: {e}")return {}
上面介绍的类(classes)为构建狗数据管理系统奠定了坚实的基础。 Util 类提供了用于管理 Elasticsearch 索引的实用方法。 Dog 类代表狗的属性。 DogRepository 类提供了从 Elasticsearch 保存和检索狗数据的方法。 DogService 类提供了高效的狗数据管理的业务逻辑。
主要代码
我们的代码基本上有两个主要流程或阶段:
- 使用基本信息和图像注册狗。
- 使用新图像执行搜索以在向量数据库中查找狗。
第一阶段:注册小狗
为了存储有关 Luigi 和其他公司的小狗的信息,我们将使用 Dog 类。
为此,我们对序列进行如下的编程:
开始为小狗登记
# Start a connection
es_db = Util.get_connection()
Util.delete_index(es_db, Util.get_index_name())# Register one dog
dog_repo = DogRepository(es_db, Util.get_index_name())
dog_service = DogService(dog_repo)# Visualize the inserted Dog
from IPython.display import display
from IPython.display import Image as ShowImagefilename = "/content/image-search-01/dataset/dogs/Luigi.png"
display(ShowImage(filename=filename, width=300, height=300))
输出:
登记 Luigi
dog = Dog('Luigi', filename, 'Jack Russel/Rat Terrier', 'Ully')dog_service.register_dog(dog)
登记所有其他小狗
import json# JSON data
data = '''
{"dogs": [{"dog_id": "Buddy", "image_path": "", "breed": "Labrador Retriever", "owner_name": "Berlin Red"},{"dog_id": "Bella", "image_path": "", "breed": "German Shepherd", "owner_name": "Tokyo Blue"},{"dog_id": "Charlie", "image_path": "", "breed": "Golden Retriever", "owner_name": "Paris Green"},{"dog_id": "Bigu", "image_path": "", "breed": "Beagle", "owner_name": "Lisbon Yellow"},{"dog_id": "Max", "image_path": "", "breed": "Bulldog", "owner_name": "Canberra Purple"},{"dog_id": "Luna", "image_path": "", "breed": "Poodle", "owner_name": "Wellington Brown"},{"dog_id": "Milo", "image_path": "", "breed": "Rottweiler", "owner_name": "Hanoi Orange"},{"dog_id": "Ruby", "image_path": "", "breed": "Boxer", "owner_name": "Ottawa Pink"},{"dog_id": "Oscar", "image_path": "", "breed": "Dachshund", "owner_name": "Kabul Black"},{"dog_id": "Zoe", "image_path": "", "breed": "Siberian Husky", "owner_name": "Cairo White"}]
}
'''# Convert JSON string to Python dictionary
dogs_data = json.loads(data)# Traverse the list and print dog_id of each dog
image_dogs = "/content/image-search-01/dataset/dogs/"
for dog_info in dogs_data["dogs"]: dog = Dog(dog_info["dog_id"], image_dogs + dog_info["dog_id"] + ".png" , dog_info["breed"], dog_info["owner_name"])dog_service.register_dog(dog)
可视化新狗
# visualize new dogs
import matplotlib.pyplot as plt
import matplotlib.image as mpimg
import mathimage_dogs = "/content/image-search-01/dataset/dogs/"
num_dogs = len(dogs_data["dogs"])cols = int(math.sqrt(num_dogs))
rows = int(math.ceil(num_dogs / cols))# Configurar o tamanho da figura
plt.figure(figsize=(5, 5))# Loop para exibir as imagens dos cães
for i, dog_info in enumerate(dogs_data["dogs"]): filename = image_dogs + dog_info["dog_id"] + ".png"img = mpimg.imread(filename)plt.subplot(rows, cols, i+1) # (número de linhas, número de colunas, índice do subplot)plt.imshow(img)plt.axis('off')plt.show()
输出:
第二阶段:寻找丢失的狗
现在我们已经登记了所有小狗,让我们进行搜索。 我们的开发人员拍了这张丢失小狗的照片。
filename = "/content/image-search-01/dataset/lost-dogs/lost_dog1.png"
display(ShowImage(filename=filename, width=300, height=300))
输出:
看看我们能找到这只可爱的小狗的主人吗?
# find dog by image
result = dog_service.find_dog_by_image(filename)
获取结果
让我们看看我们发现了什么......
filename = result['hits']['hits'][0]['_source']['image_path']
display(ShowImage(filename=filename, width=300, height=300))
输出:
瞧! 我们找到了!!!
但谁将是所有者和他们的名字?
# Print credentials
print(result['hits']['hits'][0]['_source']['dog_id'])
print(result['hits']['hits'][0]['_source']['breed'])
print(result['hits']['hits'][0]['_source']['owner_name'])
输出:
- Luigi
- Jack Russel/Rat Terrier
- Ully
好结局
我们找到了路易吉!!! 我们通知 Ully 吧。
filename = "/content/image-search-01/dataset/lost-dogs/Ully.png"
display(ShowImage(filename=filename, width=300, height=300))
输出:
很快,Ully 和 Luigi 就团聚了。 小狗高兴地摇着尾巴,Ully 紧紧地抱住它,保证再也不会让它离开她的视线。 他们经历了一阵情感旋风,但现在他们在一起了,这才是最重要的。 就这样,Ully 和 Luigi 心中充满了爱和欢乐,从此幸福地生活在一起。
结论
在这篇博文中,我们探索了如何使用 Elasticsearch 通过向量搜索来寻找丢失的小狗。 我们演示了如何生成狗的图像嵌入,在 Elasticsearch 中对其进行索引,然后使用查询图像搜索相似的狗。 该技术可用于寻找丢失的宠物,以及识别图像中其他感兴趣的物体。
向量搜索是一个强大的工具,可用于多种应用。 它特别适合需要根据外观搜索相似对象的任务,例如图像检索和对象识别。
我们希望这篇博文能够提供丰富的信息,并且你会发现我们讨论的技术对你自己的项目很有用。
原文:Finding your puppy with Image Search — Elastic Search Labs