Agisoft Metashape

This page is intended for the users that are performing the bundle block adjustment (AT) for frame cameras in Metashape.

Metshape offers a variety of formats for storing the AT results, the Inpho Match-AT Project .prj file format can be exported and used as input in SURE.

Since SURE version 3.0.7 the distortion model written in the Inpho Match-AT Project .prj, exported from Metashape, can be read and applied by SURE.

Thus the user can input directly the distorted images and SURE will automatically apply the distortion values from the exported file and it will undistort the imagery during the Image Preparation step.


Step by step guidelines

For a SURE version > than version 3.0.7 and 3.0.7 included, the following workflow has to be followed:

Exporting the AT to a SURE compatible format

In order to obtain the orientation files compatible with SURE, you can follow these steps:

A) Export of the Inpho .prj (recommended as input in SURE)

  • Open the oriented project in Metashape;
  • Navigate to Tools → Export → Export Cameras;
  • You will be able to select the path, name and type .prj 

.prj

The orientation parameters stored in the Inpho .prj exported from Metashape, preserves the required information. This format together with the distorted imagery it is used as input in SURE 3.0.7 (and newer versions).

 


SURE Processing with distorted images:

  • Run SURE using the .PRJ either using the command line, or by opening the .PRJ with sure.exe directly.
  • As input folder the distorted images must be specified using “-img”, (e.g.: -img distortedimages/).

When using the SURE GUI the following message will pop-up:

SURE warning for the 3.0.7 version and newer


It is also possible to automate your tasks by scripting or batching by using the available command line interface.




Step by step guidelines

For a SURE version < than version 3.0.6 and 3.0.6 included, the following workflow has to be followed:

Workflow for SURE versions older than 3.0.7

Please note that, that the distortion model of Metashape is not fully compatible with SURE versions older than 3.0.7, therefore it is necessary to undistort the images in Metashape. 

Metashape also writes distortion parameters into the Inpho project file. However, the definition of the parameters is not compatible with the Inpho definition. Thus when creating a Project in SURE (see Project Setup) SURE will give an warning when importing the .prj , that a .prj file from Agisoft is automatically detected. Thus the user has to use as input images only the undistorted images when creating a project in SURE. SURE is not compatible with the distortion model mentioned by Metashape, thus the distortion parameters given in the exported .prj files are ignored . This being the reason why the user has to use the undistorted images as input in SURE versions older than version 3.0.7.

A) Export of the Inpho .prj (recommended as input in SURE)

B) Undistort the images in Metashape

During this step, the images will be undistorted without the re-centering of the principal point

  • Go to Tools → Export → Undistort Photos
  • A new panel will pop up:
    • Make sure that the Center principal point checkbox is not selected
    • Make sure that Square pixels checkbox is selected
    • File names must be written as follows: {filename}.{fileext} (this should be written by default)
    • Press OK. You will now have the undistorted photos in a separate folder.

SURE Processing with undistorted images:

  • Run SURE using the .PRJ either using the command line, or by opening the .PRJ with sure.exe directly.
  • As input folder the undistorted images must be specified using “-img”, (e.g.: -img myundistortedimages/). Choose “no” if asked, whether to apply additional undistortion parameters or type 'n' in the CLI.

  • When using the SURE GUI the following message will pop-up:

    SURE warning for the 3.0.6 version and older