You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
128 lines
5.0 KiB
128 lines
5.0 KiB
COLMAP
|
|
======
|
|
|
|
About
|
|
-----
|
|
|
|
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 wide
|
|
range of features for reconstruction of ordered and unordered image collections.
|
|
The software is licensed under the new BSD license. If you use this project for
|
|
your 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 at https://github.com/colmap/colmap. COLMAP
|
|
builds on top of existing works and when using specific algorithms within
|
|
COLMAP, please also cite the original authors, as specified in the source code.
|
|
|
|
|
|
Download
|
|
--------
|
|
|
|
Executables for Windows and Mac and other resources can be downloaded from
|
|
https://demuc.de/colmap/. Executables for Linux/Unix/BSD are available at
|
|
https://repology.org/metapackage/colmap/versions. To build COLMAP from source,
|
|
please see https://colmap.github.io/install.html.
|
|
|
|
Getting Started
|
|
---------------
|
|
|
|
1. Download the pre-built binaries from https://demuc.de/colmap/ or build the
|
|
library manually as described in the documentation.
|
|
2. Download one of the provided datasets at https://demuc.de/colmap/datasets/
|
|
or use your own images.
|
|
3. Use the **automatic reconstruction** to easily build models
|
|
with a single click or command.
|
|
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
The documentation is available at https://colmap.github.io/.
|
|
|
|
|
|
Support
|
|
-------
|
|
|
|
Please, use the COLMAP Google Group at
|
|
https://groups.google.com/forum/#!forum/colmap (colmap@googlegroups.com) for
|
|
questions and the GitHub issue tracker at https://github.com/colmap/colmap for
|
|
bug reports, feature requests/additions, etc.
|
|
|
|
|
|
Acknowledgments
|
|
---------------
|
|
|
|
The library was written by Johannes L. Schönberger (https://demuc.de/). Funding
|
|
was provided by his PhD advisors Jan-Michael Frahm (http://frahm.web.unc.edu/)
|
|
and Marc Pollefeys (https://people.inf.ethz.ch/pomarc/).
|
|
|
|
|
|
Contribution
|
|
------------
|
|
|
|
Contributions (bug reports, bug fixes, improvements, etc.) are very welcome and
|
|
should be submitted in the form of new issues and/or pull requests on GitHub.
|
|
|
|
|
|
License
|
|
-------
|
|
|
|
The COLMAP library is licensed under the new BSD license. Note that this text
|
|
refers only to the license for COLMAP itself, independent of its dependencies,
|
|
which are separately licensed. Building COLMAP with these dependencies may
|
|
affect the resulting COLMAP license.
|
|
|
|
Copyright (c) 2022, ETH Zurich and UNC Chapel Hill.
|
|
All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, 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, THE
|
|
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
|
|
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
Author: Johannes L. Schoenberger (jsch-at-demuc-dot-de)
|