Skip to content
3D Reconstruction Software
Python QML Other
Branch: develop
Clone or download
Latest commit bc1eb83 Nov 1, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github [github] added template for questions Sep 10, 2019
bin [bin] meshroom_photogrammetry: fix argument name Oct 22, 2019
docker [docker] update to Qt 5.13 Aug 7, 2019
docs/logo update meshroom logo, icon and banner Apr 21, 2018
meshroom Merge branch 'develop' into dev/imagesImport Nov 1, 2019
tests [tests] multiviewPipeline: add de/serialization testing Feb 1, 2019
.gitignore add build/tests folders to .gitignore Jun 8, 2018
.travis.yml Travis CI: Add Python 3.7 to the testing May 14, 2019
CHANGES.md Add release notes for 2019.2 Aug 12, 2019
CMakeLists.txt [cmake] another workaround Aug 8, 2019
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Aug 8, 2019
CONTRIBUTING.md [doc] Minor fix to CONTRIBUTING Aug 16, 2019
COPYING.md [copying] add the obvious AliceVision dependency Feb 22, 2019
Dockerfile [docker] go back to cuda-7.0 for compatibility Aug 23, 2019
Dockerfile_py2 [docker] minor fix for python-2 Sep 9, 2019
INSTALL.md [doc] INSTALL: add QtAliceVision Aug 12, 2019
LICENSE-MPL2.md Add License file Apr 23, 2018
README.md [doc] readme: add link to manual Oct 24, 2019
appveyor.yml [ci][appVeyor] remove Python27 matrix Aug 3, 2018
dev_requirements.txt [build] fix cxFreeze version for Python 2.7 compatibility Sep 13, 2019
requirements.txt Merge branch 'develop' of github.com:alicevision/meshroom into dev/stats Sep 10, 2019
setup.py [cxFreeze] bundle more context files Aug 21, 2019
setupInitScriptUnix.py [setup] init LD_LIBRARY_PATH in cx_Freeze Aug 8, 2018

README.md

Meshroom - 3D Reconstruction Software

CII Best Practices

Meshroom is a free, open-source 3D Reconstruction Software based on the AliceVision Photogrammetric Computer Vision framework.

Learn more details about the pipeline on AliceVision website.

See results of the pipeline on sketchfab.

Continuous integration:

  • Windows: Build status
  • Linux: Build Status

Photogrammetry

Photogrammetry is the science of making measurements from photographs. It infers the geometry of a scene from a set of unordered photographs or videos. Photography is the projection of a 3D scene onto a 2D plane, losing depth information. The goal of photogrammetry is to reverse this process.

See the presentation of the pipeline steps.

Manual

https://meshroom-manual.readthedocs.io

Tutorials

Overall presentation of the Meshroom software.

Detailed tutorial with a focus on the features of the 2019.1 release.

Overall presentation of the protogrammetry practice with Meshroom.

Overall presentation of the protogrammetry practice with Meshroom and detailed presentation how to do the retolopogy in Blender.

Presentation of the Meshroom software with a focus on using it for Match Moving.

License

The project is released under MPLv2, see COPYING.md.

Get the project

See INSTALL.md to setup the project and pre-requisites.

Get the source code and install runtime requirements:

git clone --recursive git://github.com/alicevision/meshroom
cd meshroom
pip install -r requirements.txt

Start Meshroom

You need to have AliceVision installation in your PATH (and LD_LIBRARY_PATH on Linux/macOS).

  • Launch the User Interface
# Windows
set PYTHONPATH=%CD% && python meshroom/ui
# Linux/macOS
PYTHONPATH=$PWD python meshroom/ui

On Ubuntu, you may have conflicts between native drivers and mesa drivers. In that case, you need to force usage of native drivers by adding them to the LD_LIBRARY_PATH: LD_LIBRARY_PATH=/usr/lib/nvidia-340 PYTHONPATH=$PWD python meshroom/ui You may need to adjust the folder /usr/lib/nvidia-340 with the correct driver version.

  • Launch a 3D reconstruction in command line
# Windows: set PYTHONPATH=%CD% &&
# Linux/macOS: PYTHONPATH=$PWD
python bin/meshroom_photogrammetry --input INPUT_IMAGES_FOLDER --output OUTPUT_FOLDER

FAQ

See the Meshroom wiki for more information.

Contact

Use the public mailing-list to ask questions or request features. It is also a good place for informal discussions like sharing results, interesting related technologies or publications:

alicevision@googlegroups.com http://groups.google.com/group/alicevision

You can also contact the core team privately on: alicevision-team@googlegroups.com.

You can’t perform that action at this time.