KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

image_retrieval_system

★ 57 Open GitHub ↗

A image retrieval program implemented by VLAD algorithm (paper: https://ieeexplore.ieee.org/document/5540039). Can train you own image set and build your own image retrieval system.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![c++](https://img.shields.io/badge/C%2B%2B-00599C?style=for-the-badge&logo=c%2B%2B&logoColor=white)
[![About me](https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/mingjun-m-0bb5401a1/)
![](https://img.shields.io/github/stars/mingjm3/image_retrieval_system.svg)

# Image Retrieval System

## Table of Contents

- [Background](#background)
- [Install](#install)
- [Usage](#usage)
- [Result](#result)
- [Contact](#contact)
- [License](#license)

## Background

This project based on paper *[Aggregating local descriptors into a compact image representation](https://ieeexplore.ieee.org/document/5540039)*. The image retrieval program implemented by VLAD (vector of locally aggregated descriptors) algorithm using **C++** and **OpenCV**. It can help you train your own image retrieval system using your image dataset.

## Install

This project uses [C++](https://cplusplus.com/) and [OpenCV](https://opencv.org/) library. Go check them out if you don't have them locally installed.

```sh
# check c++ installation
$ g++ --version

# install OpenCV using brew
$ brew install opencv
```

## Usage

Using **CMakeLists.txt** to build project.

- Step 1: Build your VLAD vector and visual vocabulary

```sh
    ./build ${path_to_images_dataset} ${path_to_save_visual_vocabulary} ${path_to_save_vlad_vector_model}
```

- Step 2: Image retrieved using query image from user

```sh
    ./app ${path_to_query_image} ${path_to_visual_vocabulary} ${path_to_vlad_vector_model}
```

Showcase: https://www.youtube.com/watch?v=6zu_ttuSKGU

## Result

<div style="display:flex; justify-content: center;">
    <div style="flex: 50%; padding: 10px;">
        <img src="assets/query.jpg" alt="Query image from user" style="width: 30%;">
        <p style="text-align: center;">Query image from user</p>
    </div>
    <div style="flex: 50%; padding: 10px;">
        <img src="assets/result.jpg" alt="Result" style="width: 30%;">
        <p style="text-align: center;">Return the most similar image in image dataset</p>
    </div>
</div>

## Contact

[Author](https://mingjm3.github.io/)
[Linkedin](https://www.linkedin.com/in/mingjun-m-0bb5401a1/)

## License

[Apache License 2.0](https://github.com/mingjm3/image_retrieval_system/blob/master/LICENSE)

---

## 🎉 Stargazers

[![Stargazers repo roster for @USERNAME/REPO_NAME](https://reporoster.com/stars/mingjm3/image_retrieval_system
)](https://github.com/mingjm3/image_retrieval_system/stargazers)

image_retrieval_system

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README