# Agisoft Metashape

## Scaling

<details>

<summary>Agisoft Metashape | Standard</summary>

Agisoft Metashape Standard does not offer a way to automatically set scale. For best practice, we recommend using [Blender](https://www.blender.org/download/) (a free 3D application) to do this by hand.

{% hint style="info" %}
You will require an Alembic file that includes cameras & a UV unwrapped mesh.
{% endhint %}

Open a new ‘General’ blender scene and delete all of the default objects, your scene should look like this:

<img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/eehVVEwnzJbesfm9XUrC/ia7vvsAPIE0wJ62t6C1M-u6MkDxBhXfzoxuSph3VG_dWk-z2z0OEVsbC4Pqyg1hMFc4A7QQ8Deusk8n4V9UvGZWbY2hDgVlLL6TqPM_BMnMkei-X-Bjsi1lnHtvEZ7qi6dVEeeocY202gzE_bSmUoKU.png" alt="" data-size="original">

To Import an Alembic file : `File -> Import -> Alembic`

<img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/6tgwAvfMGAZa2ZoKIpgM/alembicimport.png" alt="" data-size="original">

<img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/hCHKlZCosh62ZvavF7Q8/alembicimport2.png" alt="" data-size="original">

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:

<img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/7Smgbn4IxbOCu9iv4bDi/Untitled-20250205-144829.png" alt="" data-size="original">

Select everything except the ‘Empty’:

<img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/jywMjxulgacZYikFp0Vk/Untitled-1-20250205-144838.png" alt="" data-size="original">

Then Shift+Drag the selected items into the empty:

<img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/AgQLDUUH5dnzIa4p3vxS/Untitled-20250205-144845.png" alt="" data-size="original">

It should look like this:

<img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/tMApllIhqkteqMdiFRKH/Untitled-1-20250205-144856.png" alt="" data-size="original">

Using the measure tool (Shift+Spacebar, M), hold Ctrl to snap the tool to two points in the mesh, like so:

<img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/suRBj5N6FtxLv49iAePE/Untitled-20250205-144905.png" alt="" data-size="original">

\
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.&#x20;

On the object properties menu for the ‘Empty’, insert the computed scale factor into the three scale input boxes:

<img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/PtqMPj48IwzMB40N7d9o/Untitled-1-20250205-144914.png" alt="" data-size="original">

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:

<img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/mmY3H4OxQ0OwPTtGV88l/Untitled-20250205-144924.png" alt="" data-size="original">

Delete the ‘Empty’ from the scene, your outline should only have the cameras and mesh now:

<img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/t6MvbZ2thJkyxh4sm6Jw/Untitled-1-20250205-144932.png" alt="" data-size="original">

Now export the scaled alembic:

<img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/af6zdbD7dhzbWJddwYKK/Untitled-20250205-144938.png" alt="" data-size="original">

<img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/bqzikIeiFnyPSpMyKrK5/Untitled-1-20250205-144944.png" alt="" data-size="original">

This scaled alembic is the one you want to select during the run dialog in Marso.

</details>

<details>

<summary>Agisoft Metashape | Pro</summary>

Scaling can be done quite easily by using markers and setting a scale bar.

</details>

## Exporting

{% tabs %}
{% tab title=" Exporting Alembic" %}
To export an alembic from Agisoft:&#x20;

1. Go to file.
2. Go down to export, then click on export model.&#x20;
3. Select a name and press save.

After pressing save, an export model window will appear.

{% hint style="warning" %}
You must enable vertex normals and cameras, your settings should look like the below images.
{% endhint %}

<figure><img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/vNpRkpZbCyOAFvePKtGI/image-20240523-095400.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/RBoFtMCdFAuuS5lLPUBl/image-20240523-095400%20(1).png" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Exporting ST Map" %}
In Agisoft Metashape, by default, all cameras should solve into a single group resulting in them all sharing the same lens distortion profile.

To export an ST Map:&#x20;

1. Go to tools.&#x20;
2. Go down to camera calibration.
3. You should see a single-camera group on the left pane (see below for an example).

<figure><img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/JweAnbjbqeIJBnUop6RR/image-20240523-093711.png" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="danger" %}
If you have multiple camera groups within your scene with different camera solves, Marso will not work.
{% endhint %}

4. Switch from the 'initial' to the 'adjusted' tab.

<figure><img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/ZJWyVdYtPg1xMzOn3np4/image-20240523-093818.png" alt="" width="317"><figcaption></figcaption></figure>

5. Set the save type as 'STMap (\*tif\*.exr)'. Type in a meaninful file name such as 'Lens\_Profile'. By default, the extension of the file will be ‘.tif' , **ensure** that this is changed to ‘.exr’.

<figure><img src="https://content.gitbook.com/content/dSWZvUSEhiy6J2XcG20t/blobs/08FZXVio5kSZAN0Q2Je2/image-20240523-094248.png" alt="" width="236"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}
