threedscan/meshroom

!Meshroom - 3D Reconstruction Software

Meshroom is a free, open-source 3D Reconstruction Software based on the https://github.com/alicevision/AliceVision Photogrammetric Computer Vision framework.

Learn more details about the pipeline on [***]

See results of the pipeline on sketchfab.

Continuous integration:

• Windows: https://ci.appveyor.com/api/projects/status/25sd7lfr3v0rnvni/branch/develop?svg=true](https://ci.appveyor.com/project/AliceVision/meshroom/branch/develop)
• Linux: https://travis-ci.org/alicevision/meshroom.svg?branch=develop](https://travis-ci.org/alicevision/meshroom)

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 http://alicevision.github.io/#photogrammetry.

Tutorials

• Meshroom: Open Source 3D Reconstruction Software by Mikros Image

Overall presentation of the Meshroom software.

• Meshroom Tutorial on Sketchfab by Mikros Image

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

• Photogrammetry 2 – 3D scanning with just PHONE/CAMERA simpler, better than ever! by Prusa 3D Printer

Overall presentation of the protogrammetry practice with Meshroom.

• How to 3D Photoscan Easy and Free! by by CG Geek

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

• Meshroom Survival Guide by Moviola

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:

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

Start Meshroom

You need to have https://github.com/alicevision/AliceVision installation in your PATH (and LD_LIBRARY_PATH on Linux/macOS).

• Launch the User Interface

bash
# 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

bash
# Windows: set PYTHONPATH=%CD% &&
# Linux/macOS: PYTHONPATH=$PWD
python bin/meshroom_photogrammetry --input INPUT_IMAGES_FOLDER --output OUTPUT_FOLDER

FAQ

See the https://github.com/alicevision/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:

---

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

You can also contact the core team privately on: ***.