# Matterport E57

<figure><img src="https://3163433004-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FokTDI7QVY04Zvb1pQ8Ry%2Fuploads%2FUjW5MyabrjCc8lUm0jFE%2FScreenshot%202024-12-23%20at%2010.45.48%E2%80%AFPM.png?alt=media&#x26;token=ff78acc4-41da-4b5e-91cf-48f3f2cb639c" alt=""><figcaption></figcaption></figure>

The Multiset Developer Portal supports **Matterport™ scans** for generating high-accuracy **Visual Positioning System (VPS)**. Developers can leverage Matterport™ Pro3 and Pro2 cameras to produce detailed 3D models of physical spaces. These models, exported as **.e57 files**, serve as the foundation for creating immersive and precise AR experiences.

This guide provides an overview of the workflow, equipment, and best practices for using Matterport™ scanners to produce VPS.

***

#### **Supported Devices**

* **Matterport™ Pro3 Camera**
* **Matterport™ Pro2 Camera**

***

#### **Scanning Workflow**

Follow these steps to ensure successful scanning and processing of Matterport™ data for VPS:

**1. Prerequisites**

* **Matterport™ Account**:
  * Create an account at [MyMatterport.com](https://my.matterport.com) and upgrade to a Professional subscription plan or higher.
* **Equipment**:
  * Ensure you have access to a Matterport™ Pro2 or Pro3 camera and a compatible mobile device with the **Matterport™ Capture App** installed.
* **Output Format**:
  * Scans must be exported as **.e57 files**. Panoramic images should be included to enhance the accuracy of VPS processing.

***

**2. Required Equipment**

1. **Camera Accessories**:
   * A professional-grade tripod with 3/8”-16 UNC mount to ensure stability during scanning.
   * Quick-release clamps for efficient setup and movement of the camera.
2. **Mobile Device**:
   * An iPad, iPhone, or Android device to control the Matterport™ Capture App. Ensure the device is fully charged before use.
3. **Additional Essentials**:
   * Sturdy carrying cases for secure transport.

***

**3. Preparing for the Scan**

* **Camera Setup**:
  * Mount the camera securely on a tripod and connect it to the Matterport™ Capture App.
  * Verify the camera’s connection and functionality within the app.
* **Environment Preparation**:
  * Minimize direct sunlight and reflective surfaces to reduce alignment errors.
  * Provide adequate ambient lighting for indoor scans.

***

**4. Capturing the Environment**

* Launch the Matterport™ Capture App and create a new project.
* Position the camera to capture comprehensive coverage of the space.
* Use the Capture button to perform 360-degree scans. Avoid standing in the camera’s field of view.
* Leverage tools in the Capture App to mark reflective surfaces or windows for better alignment.

***

**5. Uploading and Processing**

* After completing the scan, upload the data to your Matterport™ cloud account via the Capture App.
* Processing times vary depending on the size and complexity of the scan. Ensure a stable network connection during upload.

***

**6. Exporting .e57 Files**

* Once the scan is processed, export the model as a **.e57 file** from your Matterport™ cloud account.
* Ensure that high-resolution panoramic images are included in the export for enhanced VPS performance.

***

**7. Uploading to Multiset Portal**

* Log in to the Multiset Developer Portal and upload the **.e57 file**.
* To upload, click on **Create Map -> Upload -> Choose Matterport** and .e57 file

<figure><img src="https://3163433004-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FokTDI7QVY04Zvb1pQ8Ry%2Fuploads%2FcWfu75LsSVWuPAQlLJ1G%2FScreenshot%202025-01-30%20at%204.34.04%E2%80%AFPM.png?alt=media&#x26;token=7405a483-ea89-45de-b492-104afb916b65" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3163433004-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FokTDI7QVY04Zvb1pQ8Ry%2Fuploads%2FVW38uU9xZtuKXu7cqZji%2FScreenshot%202025-01-30%20at%204.34.14%E2%80%AFPM.png?alt=media&#x26;token=ad96d490-3275-4efe-8470-7297adab81ac" alt=""><figcaption></figcaption></figure>

* The portal processes the file to generate a VPS-compatible map.

After processing, the map status will be active, and if anything goes wrong during the process, the status will be "failed"

<figure><img src="https://3163433004-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FokTDI7QVY04Zvb1pQ8Ry%2Fuploads%2F2ZqNyBtMkytcIpuqnAo3%2FScreenshot%202025-01-30%20at%204.42.16%E2%80%AFPM.png?alt=media&#x26;token=eef8c330-b978-4eb5-b249-eee7982ce0fb" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Note : Processing Matterport E57 files can take upto an hour to be active
{% endhint %}

Below is the video tutorial of the process

{% embed url="<https://youtu.be/6b0DmaqVrjw?si=K8hMay57MSuX8vc>\_" %}

#### **Best Practices**

* **High Scan Density**: Perform scans at closer intervals to capture detailed and accurate environmental data with overlapping panoramic images.
* **Include Panoramas**: Ensure overlapping panoramic images are embedded in the export for visual localization.
* **Post-Processing**: Use the Matterport™ Capture App to refine the scans and remove unnecessary artifacts before exporting.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.multiset.ai/basics/third-party-scans/matterport-e57.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.