Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel2
outlinefalse
stylenone
typelist
printabletrue

First Time Setup

When using Marso for the first time, a number of settings must be initially set. This is done via the settings Dialog.

[SCREENSHOT: Open Settings]

[SCREENSHOT: Settings Dialog]

The Settings window can be accessed by going to File → Settings

00_open_app_settings.pngImage Added

You should see your license key at the top of the settings window, as well as the Activation status: Active

01_app_settings.pngImage Added

Marso Settings

Paths

Marso requires creating two folders on secondary storage in order to function:

  • Scratch Directory

    • Intermediary Files will be written here during processing, and deleted afterwards

    • Fast R/W speeds are highly recommended, and available space ~256GB

  • Output Directory

    • Results will be written here, in a subfolder for each subject

    • Storage speeds are not as important, can be a network share

[SCREENSHOT: Paths]

Click the arrows to open an explorer selection window for each required directory.

Marso will create the directory if it doesn’t already exist.

03_settings_paths.pngImage Added

Calibration Presets

Before processing, you will need to create calibration presets to describe your capture system to Marso.

This should only need to be done once for a Camera and Light, as long as the exposure settings are not modified.

Exposure Preset

To create an exposure preset, you will need to capture a photo of a calibration grey card under similar conditions to how you will capture any subjects. See: Capturing a Calibration Image

Once you have this image you can create an exposure preset.

Open the Exposure Parameters dialog from Settings

05_app_settings_exposure_params.pngImage Modified

Any existing presets will be shown on the left.
Click ‘New’ to create a new preset

06_exposure_params_create.pngImage Modified
07_new_exposure_params_window.pngImage Removed

Enter the information collected when capturing the image.

Click Create to launch the
Exposure Calibration tool.

10_new_exposure_populated.pngImage Added

Panel
panelIconId23f0
panelIcon:alarm_clock:
panelIconText
bgColor#F4F5F7

There may be some delay before the Exposure Calibration tool is launched!

Selecting a region

When the dialogue launches, you should see your calibration image displayed, with a prompt to select a region of your grey card. Draw a selection box over

Click and drag to create a selection box on the image. Select the region corresponding to the grey value given.

A larger the box is better, as it will reduce the impact of noise.


Press Enter to Confirm the selection.

PhotographyCalibrationInitial.pngImage Added

Panel
panelIconId2328
panelIcon:keyboard:
panelIconText⌨️
bgColor#E6FCFF

If you are unable to see the grey card to make a selection, use the hotkeys to adjust the brightness.

#E6FCFF
Panel
panelIconId2328
panelIcon:keyboard:
panelIconText⌨️
bgColor

W/S - Key to make the preview image brighter or darker.
R - To reset the brightness

This is just for preview purposes and does not affect the final calibration.

Press Enter to confirm the selection. This will start the exposure calibration, which

The calibration tool will then run in the background. This may take up to 10 minutes depending on your system and

then

the resolution of your

camera

input images.

Once complete it will display the adjust image

When it is complete the adjusted image will be shown for confirmation.

Accepting the confirmation will return you

PhotographyCalibrationFinal.pngImage Added

After accepting the adjusted image you will be returned to Marso, with the new exposure preset visible

:

[SCREENSHOT]

New exposure presets can be created at any time as required. It should be possible to re-use your preset as long as the capture system remains unchanged.

in the list.

11_exposure_preset_created.pngImage Added


Light System Preset

The ‘Light System’ preset describes the location of you light(s) relative to the camera sensor.

If you have multiple lights, the Light System preset also describes the order in which the that lights should will be triggered in when capturing.

09_app_settings_light_system.pngImage Removed
10_new_light_system.pngImage Removed
CoordinateSystem_Front.pngImage Removed
11_add_new_light.pngImage Removed
12_save_light_system.pngImage Removed

[SCREENSHOT]

The new light system

.

Open the Light Systems Dialog from Settings

13_open_lights_system.pngImage Added

The top left frame is used to create new light systems.

Light position distances should be specified in meters.

The co-ordinate system is
Y-up (see Diagram).

CoordinateSystem_Front.pngImage Added
15_lights_system_positions.pngImage Added

Enter the positions for the first light, then click ‘Add’ to create a light in the new system.

Repeat for all lights if you have Multiple Lights.

16_lights_system_add_light.pngImage Added

Give the new Light System Preset a descriptive name, and click ‘Save’.

18_lights_system_save.pngImage Added

The new Light System Preset will appear on the right side, and can be viewed by selecting it.

19_lights_system_created.pngImage Added


⬅️ Installation

Capture ➡️