Agisoft Metashape

How to export your Agisoft Metashape project for Nira

Metashape supports direct upload to Nira. We suggest following this guide.  If you prefer to upload manually, continue with the instructions below:

First, a note on georeferencing:

To best utilize all of Nira's georeferencing features, it is recommended that you export your files using georeferenced coordinates. If you plan to use georeferenced coordinates, you'll need to determine an appropriate coordinate system for your project. Here's how:

• Choose a UTM Zone if you're not sure which coordinate system to use:

Simply drag one of your project's photos into the UTM Zone Identification webpage and make note of the UTM Zone displayed. You'll use it in one of the steps below.

• If you already have a preferred coordinate system:

Be sure it's cartesian. To check this, look up the EPSG number here: https://epsg.io. Ensure that it includes "Coordinate System: Cartesian 2D CS". For example, the page for EPSG:28992 confirms that is cartesian, whereas EPSG:4326 is not. If your preferred coordinate system is not cartesian, you should use a UTM Zone instead -- see the first bullet point above to learn how.

Important note about texture width and height:

You must configure configure Metashape to export textures with width and height dimensions that are a power of two. Some examples of correct power of two texture width and height dimensions are 8192 x 8192, 16384 x 16384, and 32768 x 32768. For more information, please see our help article Are there ideal dimensions (width and height) for texture files?

To export your files:

1. File > Export > Export Model... > Save as type: Wavefront OBJ (*.obj)

2. You can use Local Coordinates (m), but we strongly suggest using a Georeferenced Coordinate System. If you're not sure what to choose, read the tips at the beginning of this page.  Be sure to enable Export texture (JPEG), Include comment Generated with Agisoft Metashape, Use UDIM texture layout, and Write metadata.xml.           

Match these settings when exporting...

3. File > Export > Export Cameras... > Save as type: Blocks Exchange (*.xml)

4. We suggest you use "Cameras.xml" as the filename

5. Coordinate System setting needs to match the coordinate system you chose during the OBJ export.  Be sure to disable Tie points and Control points so the xml file can be smaller in size.

Upload all of the following files to Nira:

• Photo files: (jpg, png, or tiff)
• Camera: (BlocksExchange XML)
• Coordinate System geolocation data: metadata.xml
• Textures: (.jpg files)
• Mesh: (.obj and .mtl files)

After uploading to Nira, you’ll have all of your photos available within the Show Photo… button.  Be sure your photos do not have comma ( , ) characters in the filename.