SKIP AHEAD TO

Introduction

There may be a need to update/replace existing coordinates for an image e.g. a GPS reading for an outcrop due to more accurate data being made available. The command line tool provides the means to this.

The Imago Connect+Tools application must be downloaded and installed before running the command line tool.

The application provides two modes:

A task based GUI for uploading/downloading images/attributes plus several other utilities
A command line tool for downloading collections and images.

Update Coordinates

In this example I have a soil collection on the Imago Portal:

Workspace: Blackfly Exploration
Dataset: Soils
Imagery Type: Soil
Collection: Adobe Reef
Name: G1120

I want to update the elevation from 399 to 403. This can be achieved by using the Imago Command Line Tool as follows:

"c:\Program Files (x86)\Imago\imago-tools\imago-cmd" updategeometry --user XXXXXXXX --password YYYYYYYY --filesource ZZZZZZZZ.csv

Where:

XXXXXXXX is your login and YYYYYYYY is your password to the Imago Portal.
ZZZZZZZZ.csv is a comma-separated file containing parameters and value(s) to be updated.

Expected values in the file are:

The key_ columns are important. The Imago Portal will effectively use these values to isolate the image to be updated and update using the remaining supplied values.

As the command line Help states, not all values are required. However sufficient key_ values must be supplied to uniquely identify the image to be updated.

In Excel, this is the source file to update the elevation value:

If any key_ column is omitted, the command-line tool will not be able to complete the update and errors will be reported e.g. key_dataset.

After running the command line tool with the source CSV file, the image elevation has been updated;

Multiple values can be updated e.g. x, y, z

The command-line tool will report an error if the provided credentials do not have appropriate permissions.
If no error is reported by the tool, the update has been successful.
Make sure the CSV file is not opened by another application (e.g. Excel) otherwise the tool will complain.
Use multiple rows for multiple images in a collection, one collection per row.
This update can also be achieved using the Imago Connect Desktop application, by selecting the Upload Collections task.
Geometry updates can also be directly in the Imago Portal by: