General

Site Localization - PIX4Dcatch RTK

 

PIX4Dcatch's Site localization function enables the ability to work in a local coordinate system and transform points between the local and global coordinate reference systems. Existing points can be imported, and new points measured on-site. Points can be acquired using PIX4Dcatch with the Pix4D supported RTK device or from any third-party device.

Note: It is recommended to use this feature with the Pix4D supported devices or capable of cm accuracy.

Create a New Point Collection

  1. From the main screen, tap the New Point collection button PIX4Dcatch point management button to open the Point management dialog.
  2. Tap the PIX4Dcatch new collection button button to create a new Point Collection where the points will be stored.

    PIX4Dcatch create point collection button

  3. Tap Site Localization.
  4. Enter a name for the Point Collection and tap Create.

A new point collection has now been created and is ready for points.

Important:

When you do a site localization, you have two coordinate systems that get implicitly defined: a global and a local. The global coordinate system is used for the global points and is a defined coordinate system with known parameters. With site localization, you will only be able to use a geographic coordinate reference system. This implies that the measurements or imported points will always be in degrees. The local coordinate reference system is a custom system defined by the user. It contains an arbitrary origin, orientation, and scale. A known unit is defined, such as meter, feet, or US survey feet.

The global coordinate system will be defined when importing or measuring points. For this step, the coordinate reference system will be Undefined.

Add Local Points

With a new Point Collection, it is possible to begin adding points. Local points should be added first, followed by measuring and linking the points globally. New local points can be imported or added manually. Global points can be measured with the Pix4D supported RTK device when linking to the local points. Once a point has been measured, the coordinate reference system will be defined for the collection.

PIX4Dcatch point collection dialog

Local points can be imported with a .csv file or enter known local coordinates manually to define a Local point.

Import Local Points

Important: The imported files must follow a defined comma-delineated structure, with either 4 or 6 columns.
  • 6 Columns: Point Label, Easting, Northing, Height, Horz accuracy, Vert accuracy
  • 4 Columns: Point Label, Easting, Northing, Height
  1. Tap the PIX4Dcatch import points button button.

    PIX4Dcatch select point crs dialog

  2. Select the Arbitrary CRS tab.
  3. Select the Unit of measurement.
    • Meters (m)
    • US feet (USft)
    • International feet (ft)

    PIX4Dcatch unit of measurement dialog

  4. Select Axes Orientation.

    Select the axes orientation for the imported points. Select the orientation which describes the file structure. i.e., in which columns are the Easting coordinates and the Northing coordinates.

    Tip: European countries usually have Easting and Northing coordinates, while North America has Northing and then Easting.

    PIX4Dcatch select axes orientation dialog

  5. Select Import.

The imported points will be listed in the Point collection.

PIX4Dcatch imported local point collection list

Each newly imported local point contains the following:

  • Point label name.
  • Imported and Local tags.
  • Horizontal and Vertical accuracy(when included in the file).
  • Coordinates with the unit of measurement.
  • Import date.
  • Linked icon - this icon is greyed out when there are no global points in the collection.
  • Measure icon - Measure the point with the Pix4D supported RTK device.

With local points imported, global points can now be added

Define Local Points

Note: Currently available only for Android devices.

Without a .csv with local coordinates, it is possible to manually enter known local coordinates to add a local point in the Point Collection.

  1. From the Point Collection, tap the New Point button button.

    PIX4Dcatch local coordinate input

  2. Select the Local Position tab.
  3. Enter:
    • Local Point Name(optional).
    • Easting, Northing, and Height(ellipsoidal) coordinates.
    • Horizontal and Vertical Accuracy(optional).
  4. Tap Save Local Coordinates. Save local coordinates button
  5. Select Unit of Measurement. (This selection is available for the first point entered and defines the unit of measurement for the following points entered in the collection.)

    PIX4Dcatch unit of measurement dialog

  6. The local position is successfully entered.

    PIX4Dcatch imported local point collection

With local points added to the Point Collection, Global points can now be added and linked.

Add Global Points

With local points in the Point Collection, it is possible to measure a global point with the Pix4D supported RTK device or import from a .csv file to link a local point to a global reference. A transformation can be computed between your local and global points with a minimum of 3 known points in both coordinate systems. It would be advised to measure more points with adequate distribution and spacing whenever possible.

The collection's global coordinate reference system will be defined by the first imported or measured global point. All subsequent measurements will have to be made with this reference.

Measure Global Points

Note: We recommend using this feature with PIX4Dcatch and the Pix4D supported RTK device for a fluent and easy workflow.
  1. From the Point Collection, choose a local point to measure globally and tap the Measure icon measure icon localization.

    PIX4Dcatch point collection linked point

  2. The Global Position tab(default) should be selected.

    PIX4Dcatch measure global point for localization

  3. Enter:
    • Global Point Name(optional).
    • Antenna Height / Altitude Correction(optional) Input value when measuring without the laser.
    • Reference Photos(optional).
    • Description(optional).
    • Measurement Duration. >30 seconds is recommended
  4. Tap Measure. Measure button

Once measured, the point will be linked with a global and local reference. With a minimum of three linked points, a computation can be run. It is recommended to use more than three linked points to have the ability to remove any linked points with residuals outside the desired accuracy.

With three or more linked points, it is possible to Compute the site localization.

Import Global Points

It is possible to import global points the same way as importing local points.

Important: The imported files must follow a defined comma-delineated structure, with either 4 or 6 columns.
  • 6 Columns: Point Label, Easting, Northing, Height, Horz accuracy, Vert accuracy
  • 4 Columns: Point Label, Easting, Northing, Height

From the Point Collection:

  1. Select the dropdown menudropdown menu iconand tap the Import file iconimport icon.

    Import global points to localize

  2. Select the .csv file containing the global points.

    PIX4Dcatch select known CRS

  3. Select the Known CRS tab.
  4. Specify the coordinate reference system for the imported points.
  5. Select Axes Orientation.

    Select the axes orientation for the imported points. Select the orientation which describes the file structure. i.e., in which columns are the Easting coordinates and the Northing coordinates?

  6. Press Import.

PIX4Dcatch import global points

The global points will be saved in the point collection with their respective tags and displayed on the map. With global and local points in the site localization point collection, two maps are displayed. The top map displays the global points, while the lower map displays the local points. Clicking on any point to get the label name. With global and local points, they can now be linked to compute the site localization.

Link Points

With local and global points in the point collection, they are ready to be linked. Once more than three points have been linked, it will be possible to compute the transformation between the global and local coordinate systems. It is recommended to use more than three linked points to have the ability to remove any linked points with residuals outside the desired accuracy.

PIX4Dcatch point collection linked point

  1. Choose a point in the collection with a global and local reference and tap the link Link icon for localization button.
      • If a global point is selected, the list of local points will be displayed. Select the correct local point to link it with the global point.
      • If a local point is selected, the list of global points will be displayed. Select the correct global point to link it with the local point.

    Once a point has been linked, the linked points will become green in the map view. The link button will be replaced with the unlink unlink button button.

  2. Link a minimum of 3 points. An alert will appear, allowing for immediate calculation. It can be canceled to allow for the linking of more points.
    calculation available alert window

Compute Site Localization

With three or more linked points, it is possible to calculate the transformation. It is recommended to have more than three points linked should there be any outliers. Once the additional points have been linked, compute the transformation and check the resulting residuals and RMS computed for the points.

PIX4Dcatch calculate site localization

  • calculate button Tap the Calculate button.

Residuals

For each point, the residuals in East, North, and Height are displayed. The residuals are computed from the reference local coordinates of the points and the transformed coordinates according to the transformation from global to local coordinates.

PIX4Dcatch residual outlier dialog

To remove an outlier:

  1. Toggle button Tap the toggle button to remove any points considered outliers.
  2. recalculate button Tap Recalculate after all outliers have been toggled off.
  3. Select confirm.

Edit the tolerance settings:

It is possible to customize the tolerances for the residuals.

  1. settings button Tap the settings button.
  2. Enter the desired tolerance settings. (The default value will be displayed in the collections unit of measurement)

    PIX4Dcatch point collection tolorances dialog

    • Enter Point Outliers value.
    • Enter RMS Error value.
  3. Tap Done.

For more information on how the RMS error is calculated: How are tie point errors defined - RMS.

Note: A warning message will be displayed when attempting to Recalculate with outliers.

Computed Site Localization Options and Outputs

With a calculated site localization, several options are available.

Important: Before exporting the transformation or any other data, it is necessary to be logged into a valid PIX4Dcloud / PIX4Dcloud Advanced account.

Export WKT File

Tap Export WKT button to export and save the site localization WKT file for processing the localized project locally.

Tap the drop-down menudropdown menu iconat the upper right corner of the screen for more options.

PIX4Dcatch site localization options

edit icon Edit Site Localization

It is possible to edit the collection after calculating. With this action, the previous transformation definition will be erased. The collection will return to the previous state before computing. Additional points can be measured, imported, linked, and unlinked as before.

export icon Export Localized File

Export the zip file containing the global and local points on two separate .csv files, along with the transformation file with the .wkt extension.

report icon See Results

A summary of the results obtained for the site localization:

  • The RMS Error.
  • The Residuals per points and axes.

For more information on how the RMS error is calculated: How are tie point errors defined - RMS.

Process a Site-Localized Project

With a calculated site localization point collection, it is possible to process a project with it. Projects can be uploaded and processed in PIX4Dcloud / Pix4Dcloud Advanced or exported and processed in PIX4Dmatic.

Upload and Process Localized Projects to PIX4Dcloud / PIX4Dcloud Advanced.

Note: Before uploading a project, it is necessary to be logged into a valid PIX4Dcloud / PIX4Dcloud Advanced account.

With a calculated site localization collection on PIX4Dcatch, it can be selected for processing when uploading to PIX4Dcloud / PIX4Dcloud Advanced.

PIX4Dcatch upload dialog

To assign a site localization point collection to a project when uploading to PIX4Dcloud / PIX4Dcloud Advanced:

  1. PIX4Dcatch upload dialog with localized project Tap the Site Localization arrowarrow right icon.
  2. Select the appropriate site localization point collection.

    PIX4Dcatch select point collection dialog

  3. Tap Upload.

For more information: How to visualize a site localization project on PIX4Dcloud.

Process Locally with PIX4Dmatic

With an exported project, and point_collection_name.wkt file. A site-localized project is ready to be imported and processed in PIX4Dmatic.

  1. Export the project from the mobile device. This export will contain the image files. (plus DepthMap.tiff and Confidence.tiff files from LiDAR-capable Apple devices)
    • Tap the dropdown menu.dropdown menu icon
    • Tap Export all data. export icon
    • Export and save.

    For more information: How to export PIX4Dcatch projects (iOS/Android).

  2. Tap Export_WKT_button to export and save the point_collection_name.wkt file.

    PIX4Dcatch_point_collection_computed

  3. Open PIX4Dmatic. new_matic_logo_light
  4. Create a new project and import image files/folders.

    PIX4Dmatic_create_new_project button

  5. Import the WKT file.

    PIX4Dmatic add GCP coordinate reference system dialog

    1. Tap the edit icon in the tie points icon Tie points tab.
    2. Select Import CRS file import icon.
      • Select the site-localized point_collection_name.wkt file for import.
    3. Tap apply button
  6. Calibrate.

Once the WKT file has been successfully imported, the PIX4Dmatic project will display the localized point collection name as the project's coordinate reference System icon coordinate reference system in the lower left corner of the PIX4Dmatic window. The project is successfully site_localized and can be processed as needed.

For more information: How to process PIX4Dcatch datasets in PIX4Dmatic.