Skip to content
Simon edited this page May 15, 2021 · 18 revisions

If you shoot a static dataset with a moving rig of cameras (cameras rigidly fixed together with shutter synchronization), you can declare this constraint to the reconstruction algorithm.

Currently, there is no solution to declare this constraint directly within the Meshroom UI, but you can use the following file naming convention:

+ rig/  # "rig" folder
|-+ 0/  # sub-folder with the index of the camera (starting at 0)
|---- DSC_0001.JPG  # Your camera filename (the is no constraint on the filename, here "DSC_" prefix is just an example)
|---- DSC_0002.JPG
|-+ 1/ # sub-folder with the index of the camera
|---- DSC_0001.JPG
|---- DSC_0002.JPG

All images with the same name in different "rig/cameraIndex" folder will be declared linked together by the same transformation. So in this example, the relative pose between the two "DSC_0001.JPG" images from the camera 0 and camera 1 will be the same than between the two "DSC_0002.JPG" images.

When you drop the rig sub-folders into Meshroom, this constraint will be recognized and you will be able to see it in the CameraInit node (see Rig and Rig Sub-Pose of the Viewpoints parameter).

In the Images Pane you should now see your images with a chain link icon: chain

Requirements:

The EXIF serial number (BodySerialNumber) for each image set are required to be different. (Images with the same EXIF information are ignored)

Cameras need to move/capture in sync like a stereo rig. In case of a turntable, cameras should capture in sync to the rotation of the turntable from their fixed positions.

Example:

For a rig with two cameras (Front, Back), images from the Front camera are required to have a different EXIF serial number (BodySerialNumber) than the images from the Back camera. (same with right/left or top/down)

Discussion on the topic: https://github.com/alicevision/meshroom/discussions/1382

More: https://github.com/alicevision/meshroom/issues/527 https://github.com/alicevision/meshroom/issues/905 https://github.com/alicevision/meshroom/issues/1068

The following message will be shown in the cli window when Meshroom detects images that may belong to a rig and or have missing metadata:

Some image(s) have no serial number to identify the camera/lens device. This makes it impossible to correctly group the images by device if you have used multiple identical (same model) camera devices. The reconstruction will assume that only one device has been used, so if 2 images share the same focal length approximation they will share the same internal camera parameters. 1 image(s) are concerned.