third_party/GlueStick/README.md

GlueStick

Joint deep matcher for points and lines 🖼️💥🖼️

This repository contains the official implementation of GlueStick: Robust Image Matching by Sticking Points and Lines Together.

Install 🛠️

To install the software in Ubuntu 22.04 follow these instructions:

sudo apt-get install build-essential cmake libopencv-dev libopencv-contrib-dev
git clone --recursive https://github.com/cvg/GlueStick.git
cd GlueStick
# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
pip install -e .

Running GlueStick 🏃

Download the weights of the model:

wget https://github.com/cvg/GlueStick/releases/download/v0.1_arxiv/checkpoint_GlueStick_MD.tar -P resources/weights

You can execute the inference with it with:

python -m gluestick.run -img1 resources/img1.jpg -img2 resources/img2.jpg

Training 🏋️

We want to provide you with high-quality and flexible code for training. Stay tuned, we will release it soon!

Citation 📝

If you use this code in your project, please consider citing the following paper:

@article{pautrat_suarez_2023_gluestick,
    title={{GlueStick}: Robust Image Matching by Sticking Points and Lines Together},
    author={Pautrat, R{\'e}mi* and Su{\'a}rez, Iago* and Yu, Yifan and Pollefeys, Marc and Larsson, Viktor},
    journal={ArXiv},
    year={2023}
}