/
Sequencing & Naming

Sequencing & Naming

Owned by Elliott Round
Last updated: Jan 28, 2025 by Nathan Dunne
2 min read

All scans for Marso need to be captured ‘One Light At a Time’ (OLAT).

Total images = number of cameras in scene X number of lights per camera

For systems with multiple lights, do not capture an extra image with all lights on for photogrammetry. Marso automatically creates such images during data processing. Any additional images in the dataset will result in an error.

Naming

For the different camera & light options listed in the drop-down boxes, ensure that the names of files are alphanumeric.

Good Examples

Cam_000, Cam_001, Cam_002, Cam_003, Cam_004…
Names are in order

DSC_1234, DSC_1235, DSC_1236, DSC_1237, …
Names don’t start at 0 but are in order

Bad Examples

Cam_0, Cam_1, … , Cam_10, … , Cam_100
Numbers are not padded with 0s to the same length

Light_00_Camera_000, Light_01_Camera_000, …
Light # appears in name before Camera #

Cam_000, Image_001, DSC_002, Cam_003, . .
Numbers are ordered, but names are not

Sequencing

MARSO uses the order in which images are taken to identify which camera relates to which light. For MARSO to work correctly, please follow the below sequencing structures.

If your images are not captured in this way, please rename them to match

 

You’re only required to take one image per position.

  1. Position 1 > cam_1 + light_1

  2. Position 2 > cam_1 + light_1

  3. Position 3 > cam_1 + light_1

  4. Position 4 > cam_1 + light_1

  5. Position 5 > cam_1 + light_1

  6. Position 6 > cam_1 + light_1

  7. …

Take an image per light by only having one light turned on at any given time. A rig with two lights will therefore take twice as many images for all camera views.

  1. Position 1 > cam_1 + light_1

  2. Position 1 > cam_1 + light_2

  3. Position 2 > cam_1 + light_1

  4. Position 2 > cam_1 + light_2

  5. Position 3 > cam_1 + light_1

  6. Position 3 > cam_1 + light_2

  7. …

Take an image with each camera independently, to ensure there is no spill from each camera’s respective light onto images taken by other cameras within the system.

  1. Position 1 > cam_1 + light_1

  2. Position 1 > cam_2 + light_1

  3. Position 1 > cam_3 + light_1

  4. Position 2 > cam_1 + light_1

  5. Position 2 > cam_2 + light_1

  6. Position 2 > cam_3 + light_1

  7. …

For each camera; take an image with each light attached to the camera in question, before moving onto the next camera & light pairing.

  1. Position 1 > cam_1 + light_1

  2. Position 1 > cam_1 + light_2

  3. Position 1 > cam_2 + light_1

  4. Position 1 > cam_2 + light_2

  5. Position 2 > cam_1 + light_1

  6. Position 2 > cam_1 + light_2

  7. Position 2 > cam_2 + light_1

  8. Position 2 > cam_2 + light_2

  9. …