Meshroom on Qarnot - documentation

Introduction

Meshroom is a free, open-source 3D Reconstruction Software based on AliceVision, a photogrammetry computer vision framework.

Versions

Meshroom versions supported on Qarnot:

• 2019.2.0
• 2020.1.0
• 2021.1.0
• 2023.2.0

To change the version used, just modify constant DOCKER_TAG. By the default, the latest supported version will be used.

If you are interested in another version, please send us an email at qlab@qarnot.com.

Test Case

In this test case, a 3D model will be built from photos taken of an object. All the steps and the photogrammetry process are explained in an other article. 

To download the demo folder, create a photogrammetry folder and navigate in it. You can download the example folder here which contains the input photos. The dataset needs to be unzipped before it can be used on Qarnot.

Launching the case

Before starting a calculation with the Python SDK, a few steps are required:

• Please ensure that you have created a Qarnot account here.
• Retrieve the authentication token here
• Install Qarnot’s Python SDK here

In addition to the Python SDK, Qarnot provides C# and Node.js SDKs and a Command Line. Once everything is set up, the following script needs to be used to start the calculation.

Please note that the dataset needs to be unzipped before it can be used on Qarnot. Your tree view should look like this:

• photogrammetry/
  • CuteB3
  • meshroom.py

To launch this script, simply copy the preceding code in a Python script, put it at the same level as the photogrammetry folder and execute python3 meshroom.py in your terminal. 

Note: if you want to add other flags to the Command line sent to the Docker container, you can use the MESHROOM_EXTRA_FLAGS environment variable. It's useful to know that:

• the Meshroom installation folder is /mehsroom/Meshroom/
• the Bucket data is located in /job/

Results

At any given time, you can monitor the status of your task on the general web interface Tasq. The following figure shows a successful Meshroom task on Qarnot’s Tasq.

Wrapping up

That’s it! If you have any questions, please contact qlab@qarnot.com and we will help you with pleasure! You can read a more detailed article on this use case here : Create your own 3D model with photogrammetry – Qarnot Blog.