✅ When a job is 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.
📐 Process Photogrammetry
You can now proceed with your normal photogrammetry reconstruction workflow using . 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.
| Warning |
|---|
Marso will break when photogrammetry uses other image files; e.g camera jpeg or manually made |
| Panel | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
We plan to offer ‘jpeg’ and ‘png’ export form from Marso in future builds, for users who do not wish to process the ‘exr’ files. |
📝 Photogrammetry 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.
| Note |
|---|
Avoid using a mesh with a vertex count higher than ?????? to avoid long processing times. 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.
| Expand | ||
|---|---|---|
| ||
To write . . . |
| Expand | ||
|---|---|---|
| ||
To write . . . |
| Expand | ||
|---|---|---|
| ||
To write . . . |
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.
| Expand | ||
|---|---|---|
| ||
To write . . . |
| Expand | ||
|---|---|---|
| ||
This can be done quite easily by using markers and setting a scale bar |
| Expand | ||
|---|---|---|
| ||
To write . . . |
Export Alembic Mesh & ST Maps
In the main window of Marso, enter the Job Name and path to Raw Files:
Job Name: A descriptive name that will be used to identify the scan throughout processing and once the results are ready. e.g Blue_Leather_Handbag
| Panel | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
When processing different versions of the same asset, use a naming system e.g object_v01 |
| Info |
|---|
Letters, numbers, hyphens, and underscores are allowed. Do not use special characters |
Raw Files: Specify the path to the raw images from the scan to be processed.
| Note |
|---|
Marso can only ingest camera RAW or DNG Files, it cannot read jpeg, png or exr Supported Files |
📷 Image Preparation
Once the above information has been entered, the Start button within the Raw Processing pane can be clicked to start the Prepare step.
The new job will appear in the lower pane as soon as it is started, and data preparation will run until its status changes from PREPARING to READY.
| Note |
|---|
If the status shows “Failed”, make sure that the selected Exposure Calibration in Settings is correct. Contact support if the issue persists. |
In addition to reading all data into Maraso, this step will also create ‘exr’ files that will be needed for the photogrammetry step.
When using a capture system that has multiple lights for each camera position or node, Marso will automatically create one ‘exr’ file for each group of lights as an averaged image.
Starting Photogrammetry ➡️