pixel-perfect-sfm

(★ 1,484)

Pixel-Perfect Structure-from-Motion with Featuremetric Refinement (ICCV 2021, Best Student Paper Award)

File Explorer

Download Latest Version (.zip)

- CMakeConfig.cmake.in
- CMakeHelper.cmake
- CMakeUninstall.cmake.in
- FindAVX2.cmake
- - README.md
- - demo.gif
  - eth3d_localization.svg
  - pipeline.svg
- FAQ.md
- features.md
- general.md
- pipeline.svg
- - CMakeLists.txt
  - example.cc
- refine_sift_aachen.py
- sfm+loc_aachen.py
- plot_eth3d_triangulation.ipynb
- - bindings.cc
  - CMakeLists.txt
- - __init__.py
  - bindings.cc
  - CMakeLists.txt
  - main.py
- - __init__.py
  - bindings.cc
  - CMakeLists.txt
  - main.py
- - __init__.py
  - default.yaml
  - dsift.yaml
  - low_memory.yaml
  - norefine.yaml
  - photometric.yaml
  - pixsfm_eth3d.yaml
  - pixsfm_eth3d_d2net.yaml
- - __init__.py
  - bindings.cc
  - CMakeLists.txt
  - extract_patches.py
  - extractor.py
  - store_features.py
  - store_references.py
- - __init__.py
  - bindings.cc
  - CMakeLists.txt
  - main.py
- - __init__.py
  - bindings.cc
  - CMakeLists.txt
  - main.py
- - __init__.py
  - bindings.cc
  - CMakeLists.txt
- - __init__.py
  - bindings.cc
  - CMakeLists.txt
  - colmap.py
  - database.py
  - hloc.py
  - misc.py
  - visualize.py
- __init__.py
- CMakeLists.txt
- extract.py
- localize.py
- refine_colmap.py
- refine_hloc.py
- clang_format.sh
- CMakeLists.txt
- half.hpp
- HighFive
- progressbar.h
- pybind11
.clang-format
.gitattributes
.gitignore
.gitmodules
CMakeLists.txt
demo.ipynb
LICENSE
README.md
requirements.txt
setup.py

# Installation Guide

1. Get the code

git clone https://github.com/cvg/pixel-perfect-sfm

Downloads the entire project code from GitHub to your computer.

cd pixel-perfect-sfm

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

APT (Debian/Ubuntu 계열) Built into Debian/Ubuntu-based Linux distributions.

sudo apt-get install libhdf5-dev

Installs directly from the APT package repository (Debian/Ubuntu-based).

sudo apt install libpcl-dev # linux only

Installs directly from the APT package repository (Debian/Ubuntu-based).

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. CMake

Medium

Prerequisites

Git Needed to download the project code from GitHub.
CMake The tool used to generate build configuration.
C/C++ 컴파일러 Windows needs Visual Studio (Community edition, free), macOS needs Xcode Command Line Tools, Linux needs the gcc/g++ package.

cmake .. && make -j

Analyzes the source code and generates build configuration files (must be run inside the build folder).

✅ Check that an executable was created inside the build folder, then run it directly (e.g. ./build/app_name).

Pulled directly from this repo's README.

4. Python

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install -r requirements.txt

Installs the Python libraries listed in requirements.txt (or similar).

pip install -e .

Installs the Python libraries listed in requirements.txt (or similar).

pip install -e . # install pixsfm in develop mode

Installs the Python libraries listed in requirements.txt (or similar).

python -m pixsfm.refine_hloc reconstructor \

Runs the Python script (or module).

python -m pixsfm.refine_hloc reconstructor [...] dense_features.use_cache=true

Runs the Python script (or module).

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.