GES-GSP-Plus

An optimized and modernized version of GES-GSP-Stitching, featuring a streamlined build process, up-to-date dependencies, and a self-contained build with no external DLLs required.

English | 中文

🚀 Quick Start

Get up and running in minutes with our simple setup guide.

📋 Prerequisites

Ensure you have the following tools installed on your Windows 11 machine:

• CMake (version >= 3.23)
• Vcpkg or Conan (version >= 2.0)
• MSBuild (from Visual Studio 2022)

💡 Tip: If you are using Visual Studio 2026, please note the following:

• You must use vcpkg instead of Conan.
• The latest supported OpenCV version is 4.11.0, which is sufficient for reproducing the results.
• Remember to edit CMakePresets.json and replace Visual Studio 2022 with Visual Studio 2026.

• IDE: VSCode (Recommended)

💡 Tip: We highly recommend using Scoop to easily install CMake and Conan on Windows.

# Install Scoop
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
# Use Scoop to install tools
scoop install cmake conan # You can also use 'scoop install vcpkg' if you prefer not to use the version bundled with Visual Studio

🛠️ Build and Run

Follow the steps below to build and run the project.

For Vcpkg Users

# 1. Clone the repository
git clone https://github.com/storious/GES-GSP-Plus.git

# 2. Navigate to the source directory
cd Code

# 3. Configure the project using CMake presets
cmake --preset vcpkg-default

# 4. Build the project in Debug mode
cmake --build --preset vcpkg-debug

# For a Release build, use:
# cmake --build --preset vcpkg-release

# 5. Run the application
cd .. # Ensure you are in the project root directory
.\Code\build\Debug\ges_stitching.exe <input_data_name>
# Example: .\Code\build\Debug\ges_stitching.exe AANAP-01_skyline

For Conan Users

💡 Tip: If you are using Visual Studio 2026, you may face issues when compiling OpenCV 4.12.0. In this case, please switch to vcpkg.

# 1. Clone the repository
git clone https://github.com/storious/GES-GSP-Plus.git

# 2. Navigate to the source directory
cd Code
 
# 3. Initialize Conan profile
conan profile detect --force
# If the compiler is not detected correctly, you can check with `conan profile show default`

# 4. Install dependencies for Debug mode
conan install . --output-folder=build --build=missing -s build_type=Debug

# 5. Configure the project using CMake presets
cmake --preset conan-default

# 6. Build the project in Debug mode
cmake --build --preset conan-debug
# For a Release build, use: cmake --build --preset conan-release

# 7. Run the application
cd .. # Ensure you are in the project root directory
.\Code\build\Debug\ges_stitching.exe <input_data_name>
# Example: .\Code\build\Debug\ges_stitching.exe AANAP-01_skyline

📜 Scripts

For your convenience, we provide the following scripts:

• RUN.bat: simply edit RUN_FILE.txt to easily run different datasets. more detail run RUN.bat -h

---

✨ Key Features & Improvements

• 🧹 Simplified Workflow: No more hunting for DLLs. All dependencies are managed and built by CMake for a hassle-free experience.
• 📦 Modern Dependency Management: Relies on Conan or Vcpkg for reliable and reproducible C++ dependency management.
• 🔄 Updated Core Libraries: Built with modern versions of OpenCV and Eigen.
• 🗑️ VLFeat Removed: The SIFT implementation has been fully migrated to OpenCV, reducing external dependencies.
• 🛠️ CMake Presets: Leverages modern CMake presets for standardized and simple build configurations.

---

🤝 Contributing & Feedback

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. If you have a suggestion that would make this project better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

• Questions & Issues: For any questions, please feel free to open an issue in our GitHub Issues tracker.

---

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.