✅ When is a job ready?
When a job status transitions from PREPARING to READY, the Inspect Photos button will be made available - taking you to the directory of the exr files (these are to be used by photogrammetry).
The status bar at the bottom of the main window will also indicate that the selected job is ready for Photogrammetry once the preparation is complete.
📐 Run your Photogrammetry
You can now proceed with your normal photogrammetry reconstruction workflow. You must use the exr files created in the previous step.
We recommend using either: Agisoft Metashape Pro or Reality Capture as your photogrammetry application.
Marso will break when photogrammetry uses other image files; e.g camera jpeg or manually made
We plan to offer ‘jpeg’ and ‘png’ export from Marso in future builds
You can freely edit the contents of the exr files, e.g. changing brightness and contrast, to improve the reconstruction, so long as the resolution and the file name are kept the same.
📝 Checklist
3D Mesh and camera solve
It is important to get a good solve of the cameras within the same, poorly solved cameras can lead to artifacts in the material measurement later on. We recommend attempting to re-align any bad camera solves or deleting those cameras from the 3D solve all together.
There is a polygon limit dertemined by the amound of VRAM available on your system, exceedingly largse meshed can crash Marso. If this occurs, simplify the mesh and reattempt the process
Marso can produce high detailed normals on medium to low poly meshes.
UV Unwrapped Mesh
The 3D mesh that Marso will create textures for will require a UV. By default, a 3D mesh within a photogrammetry application will not have a UV, you must first run the texturing process within the application or UV unwrap manually.
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 may create artifacts if Marso attempts to create a 512px texture.
Scale the Scene
It is essential that the 3D scene is correctly scaled, we suggest using makers to automatically set the scale of a scene within Reality Capture of Agisoft Metashape Pro.
Agisoft Metashape Standard does not offer a way to automatically set scale. For best practice, we recommend using Blender (a free 3D application) to do this by hand.
You will require an Alembic file that includes cameras & a UV unwrapped mesh, as listed in steps 2 & 4.
Open a new ‘General’ blender scene and Delete all of the Default objects, you scene should look like this:
To Import an Alembic file : File -> Import -> Alembic
After importing, the mesh and cameras should be in your scene. Create an empty object, this will be used to apply the same scale to the mesh and all the cameras:
Select everything except the ‘Empty’:
Then Shift+Drag the selected items into the empty:
It should look like this:
Using the measure too 
(Shift+Spacebar, M), hold Ctrl to snap the tool to two points in the mesh, like so:
Then compare this distance to the real life distance. If you divide this distance by the real life distance you end up with a scale factor.
On the object properties menu for the ‘Empty’, insert the computed scale factor into the three scale input boxes:
Use the measure tool again to confirm the distance is now correct.
Now select all cameras and the mesh, press Alt+P to bring up the Clear Parent dialog, and select Clear and Keep Transformation:
Delete the ‘Empty’ from the scene, your outline should only have the cameras and mesh now:
Now export the scaled alembic:
This scaled alembic is the one you want to select during the run dialog in Marso.
We use the default settings from Reality Capture, however be sure that Export Vertex Normals is set to YES, and Export Images is set to NO
Export Alembic Mesh & ST Maps
Export an Alembicabcfile with cameras & normals enabled, also export an ST Map as anexrwhich will be used to account for lens distortion. It is important to use an ST map created within the photogrammetry application rather than
It is important to use an ST map that has been created within the photogrammetry application you have used to solve the 3D scene to avoid any discrepancies.
Exporting an ST Map
In Agisoft Metashapes, by default, all cameras should solve into a single group resulting in them all sharing the same lens distortion profile. Go to :Tools -> Camera Calibration
You should see a single-camera group on the left pane.
If you have multiple camera groups within your scene with different camera solves,
Marso will not work.
Switch from the Initial tab to the Adjusted tab, and press save.
Set the Save as Type to be : ‘STMAP (*.tif *.exr)' . Type in a meaningful filename such as ‘Lens_Profile’. By default, the extension of the file will be ‘.tif' , ensure that this is changed to ‘.exr’.
Exporting an Alembic
To export the alembic :File -> Export -> Model
Give the file a meaningful name and press save.
After clicking save, an Export Model window will appear. You must enable :
Vertex Normals Cameras
Tips and Tricks
For best results, we recommend using Reality Capture (which is now free!) or Agisoft Metashape Professional. Agisoft Metashape Standard will work but does require manually scaling the 3D data which can lead to human error.
Reality Capture Workflow
To write . . .
Agisoft Metashape | Professional
To write . .