Versions Compared

Version Old Version 17 New Version Current
Changes made by

Duncan Baird

Nathan Dunne

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel12
include
outlinefalse
indent
styledefaultnone
exclude
typelist
class
printabletrue

When using Marso, photogrammetry must only be done with images generated from Marso, rather than using the RAW images, or your own JPEGs/EXRs.

These are generated using the DEVELOP step.

Photogrammetry Images

Once you have the capture photography for a particular subject, you need to create a job for it in Marso.

Create Job

In Marso, The top-most panel of the main window is used for creating new jobs from capture photography.

20_create_job_frame.pngImage Added

Job Information

  1. Job Name: A descriptive name that will be used to identify the job throughout processing and once the results are ready. e.g Blue_Leather_Handbag

Info

Letters, numbers, hyphens, and underscores are allowed. Do not use special characters.

  1. Raw Images Folder: Specify the path to the raw images from the scan to be processed.

  2. Raw Images Extension: Select from the list of supported file formats found in the Raw Images Folder.

Note

Marso can only ingest camera RAW or DNG Files, it cannot read jpeg, png or exr, see supported files for details.

Fill in the Job Information, then select or create a Light System that matches the capture setup.

See Calibration Section for more information.

21_create_job_light_select.pngImage Added

Click Create to add the new job to the job list.

23_create_job.pngImage Added

A confirmation dialog will be displayed. Check the number of images and the raw extension is as expected before proceeding.

CreateJobConfirm.pngImage Added

The created job will then be displayed in the ‘Available’ pool.

24_show_created_job.pngImage Added

Image Creation

Once you have created a job, the Photogrammetry images need to be created by running the initial DEVELOP step.

Click “Queue' to add the selected job to the

processing

run queue

, for the DEVELOP step

.

This will launch a configure dialog where you can customise your photogrammetry images.

25_prep_job_queue.pngImage Added

Image Customisation

Click ‘Open Image’ to open an image preview from the capture.

25_prep_job_queue.pngImage Removed

26_prep_job_configure.pngImage Removed

A preview of the photogrammetry image will be loaded.

26_prep_job_configure.pngImage Added

This will open preview of your photogrammetry images.

27_prep_job_preview.pngImage Added

If the preview image is too bright or too dark, adjust the brightness slider.

This will affect the photogrammetry images.
27_prep_job_preview.pngImage Removed
28_prep_job_brightness.pngImage Removed

Photogrammetry images will have their brightness adjusted.

28_prep_job_brightness.pngImage Added

You can also optionally

create photogrammetry images as EXRs

export as larger EXR files, instead of JPGs, and

have

modify the directory where the photogrammetry images

be written to a custom directory.

are being written.

For most use cases we recommend JPG photogrammetry images.

29_prep_job_options.pngImage Added

Once you are happy with your

settings

configuration, click

“Queue”

‘Queue’ to save the config and add the job to the processing queue.

29_prep_job_options.pngImage Removed

30_prep_job_configure_finish.pngImage Removed
30_prep_job_configure_finish.pngImage Added

This will return you to the main Marso window, where the selected job is now in the

processing
31_prep_job_in_queue.pngImage Removed

32_prep_job_running.pngImage Removed

run queue.

Click start to begin processing all jobs in the queue.

You can pause or stop processing at any time.

Run Develop

With a job in the run queue, click 'Start' and all jobs in the queue will run.

31_prep_job_in_queue.pngImage Added

The first job in the queue will begin running. Progress is displayed at the bottom of the window.

If necessary, the running job can be paused or stopped at any time, using the buttons in the bottom right of the window.

32_prep_job_running.pngImage Added

Once the DEVELOP step is complete, the job will return to the available pool with status

will be

‘DO SOLVE’.

Click ‘Images’ to open explorer at the folder containing the images that should be used for photogrammetry.

33_prep_job_success.pngImage Removed
33_prep_job_success.pngImage Added

Do Solve

You are can now free to follow begin your normal photogrammetry process, as long as the photogrammetry photogrammetry workflow with the images created by Marso are used. You may modify the contents of these images as long as they are not renamed or re-ordered.

See below for specific tips for the photogrammetry solution you use:

Photogrammetry Checklist

Before proceeding with Marso, ensure that you have completed all of the below.

Table of Content Zone
minLevel1
maxLevel7
locationtop

Camera solve

As well as solving the mesh of the subject, it is important to also get a good solve of the positions of the cameras.

Poorly solved cameras can lead to artifacts in the material measurement later on. We recommend attempting to re-align any bad camera solves or removing those cameras from the 3D solve all together.

ST Maps 

Export the ST Map(s) as exr so that Marso can account for any lens distortion.

Subject Mesh

Bounding Box

When drawing a bounding box around your subject for mesh reconstruction, it is important to also include any stands or supports. This additional geometry will ensure that pixels are correctly traced onto this geometry and not onto the subject itself.

Using one of the lower cameras (as shown below) can be a helpful reference to see how much geometry is required to avoid unwanted pixels being projected onto the subject.

Good

Bad

Bounding_Box_Good0013.pngImage RemovedBounding_Box_Bad0013.pngImage Removed
Bounding_Box_Good_POV0013.pngImage RemovedBounding_Box_Bad_POV0013.pngImage Removed

Info

Using a Mask Mesh will allow you to reconstruct just the subject, whilst avoiding occlusion issues by providing a Subject Mesh & Mask Mesh

RB.pngImage Removed

UV Unwrap

For Marso to work the subject mesh must be exported with a UV unwrap. By default, a 3D mesh within a photogrammetry application will not have a UV, so you must either run the texturing process within the application, or do a Manual UV Unwrap.

Info

For optimal UVs we recommend generating the texture at the same resolution or lower resolution than what you wish to output from Marso.

Example: A RealityCapture texture of 1024px can be used to create a Marso texture of 1024 -> 8192px , but Marso may create artifacts at 512px.

Scale

It is essential that the 3D scene is correctly scaled, we suggest using markers to automatically set the scale of a scene within your photogrammetry software.

You can also Re-Scale with Blender

Poly-Count

A high number of polygons in the mesh may cause Marso to exceed the available VRAM on your system. If this occurs, simplify the mesh and reattempt the process. Marso can produce highly detailed normals, even on medium to low poly meshes. See Examples

Export

The mesh should be exported as an Alembic (.abc) file, with cameras and normals enabled.

⬅️ Capture

Processing

⬅️ Capture

Photogrammetry ➡️