Repository files navigation

COLMAP is a general-purpose Structure-from-Motion (SfM) and Multi-View Stereo(MVS) pipeline with a graphical and command-line interface. It offers a widerange of features for reconstruction of ordered and unordered image collections.The software is licensed under the new BSD license. If you use this project foryour research, please cite:

@inproceedings{schoenberger2016sfm,    author={Sch\"{o}nberger, Johannes Lutz and Frahm, Jan-Michael},    title={Structure-from-Motion Revisited},    booktitle={Conference on Computer Vision and Pattern Recognition (CVPR)},    year={2016},}@inproceedings{schoenberger2016mvs,    author={Sch\"{o}nberger, Johannes Lutz and Zheng, Enliang and Pollefeys, Marc and Frahm, Jan-Michael},    title={Pixelwise View Selection for Unstructured Multi-View Stereo},    booktitle={European Conference on Computer Vision (ECCV)},    year={2016},}

If you use the image retrieval / vocabulary tree engine, please also cite:

@inproceedings{schoenberger2016vote,    author={Sch\"{o}nberger, Johannes Lutz and Price, True and Sattler, Torsten and Frahm, Jan-Michael and Pollefeys, Marc},    title={A Vote-and-Verify Strategy for Fast Spatial Verification in Image Retrieval},    booktitle={Asian Conference on Computer Vision (ACCV)},    year={2016},}

The latest source code is available athttps://github.com/colmap/colmap. COLMAPbuilds on top of existing works and when using specific algorithms withinCOLMAP, please also cite the original authors, as specified in the source code,and consider citing relevant third-party dependencies (most notablyceres-solver, poselib, sift-gpu, vlfeat).

• Binaries forWindows and other resources can be downloadedfromhttps://github.com/colmap/colmap/releases.
• Binaries forLinux/Unix/BSD are available athttps://repology.org/metapackage/colmap/versions.
• Pre-builtDocker images are available athttps://hub.docker.com/r/colmap/colmap.
• Conda packages are available athttps://anaconda.org/conda-forge/colmap andcan be installed withconda install colmap
• Python bindings are available athttps://pypi.org/project/pycolmap.CUDA-enabled wheels are available athttps://pypi.org/project/pycolmap-cuda12.
• Tobuild from source, please seehttps://colmap.github.io/install.html.

1. Download pre-built binaries or build from source.
2. Download one of the provided datasets athttps://demuc.de/colmap/datasets/or use your own images.
3. Use theautomatic reconstruction to easily build modelswith a single click or command.

The documentation is available athttps://colmap.github.io/.

To build and update the documentation at the documentation website, follow these steps:

1. Build the documentation locally followingthese instructions.
2. Clone the website repositorycolmap/colmap.github.io.
3. Copy the contents of the generated files at_build/html to the cloned respository root.
4. Create a pull request to thecolmap/colmap.github.io repository with the updated files.
5. (optional if main release) Copy the previous release as legacy to the "legacy" folder, under a folder with the release numberas seen here

Please, use GitHub Discussions athttps://github.com/colmap/colmap/discussionsfor questions and the GitHub issue tracker athttps://github.com/colmap/colmapfor bug reports, feature requests/additions, etc.

COLMAP was originally written byJohannes Schönberger withfunding provided by his PhD advisors Jan-Michael Frahm and Marc Pollefeys.The team of core project maintainers currently includesJohannes Schönberger,Paul-Edouard Sarlin, andShaohui Liu.

The Python bindings in PyCOLMAP were originally added byMihai Dusmanu,Philipp Lindenberger, andPaul-Edouard Sarlin.

The project has also benefitted from countless community contributions, includingbug fixes, improvements, new features, third-party tooling, and communitysupport (special credits toTorsten Sattler).

Contributions (bug reports, bug fixes, improvements, etc.) are very welcome andshould be submitted in the form of new issues and/or pull requests on GitHub.

The COLMAP library is licensed under the new BSD license. Note that this textrefers only to the license for COLMAP itself, independent of its thirdpartydependencies, which are separately licensed. Building COLMAP with thesedependencies may affect the resulting COLMAP license.

Copyright (c), ETH Zurich and UNC Chapel Hill.All rights reserved.Redistribution and use in source and binary forms, with or withoutmodification, are permitted provided that the following conditions are met:    * Redistributions of source code must retain the above copyright      notice, this list of conditions and the following disclaimer.    * Redistributions in binary form must reproduce the above copyright      notice, this list of conditions and the following disclaimer in the      documentation and/or other materials provided with the distribution.    * Neither the name of ETH Zurich and UNC Chapel Hill nor the names of      its contributors may be used to endorse or promote products derived      from this software without specific prior written permission.THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THEIMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSEARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BELIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, ORCONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OFSUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESSINTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER INCONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THEPOSSIBILITY OF SUCH DAMAGE.