Download Images from the Imago Portal Using the Command Line Tool

Introduction

Images may be downloaded from the Imago Portal using the command line features of the Imago Connect+Tools application. This is useful, for example, for scheduling a download or downloading "on demand", without the need to open the application itself.

The Imago Connect+Tools application must be downloaded and installed before running the command line feature. 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.

Download Images

Without a Parameter File

The command line tool expects the following parameters:

"{Install folder}\imago-cmd.exe" export --user {your username} -- password {your password} {Workspace} {DataSet} {Collection} {Export directory name}  

For example, to download the Collection for drillhole AA222 from the Workspace and Dataset and place in "C:\Scratch":

the parameters are:

"C:\Program Files (x86)\Imago\imago-tools\imago-cmd.exe" export --user ImagoDemo1 --password ImagoDemo1 "Imago Demo" "Drilling Core" "AA222" "C:\Scratch"

This will create a folder C:\scratch\Imago Demo\Drilling Core\AA222 and populate with all drillholes corresponding imagery:

The provided directory is scanned to ascertain to see if it contains previously downloaded images. If so, only new imagery is downloaded. This is useful for running incremental downloads for imagery which may have been since added. The "*" wildcard may be used to download imagery which satisfies this wildcard. For example "AA*" will download all imagery for collections that commence with "AA". To automate downloads, it is recommended that the command and parameters be executed from a .bat file. Here is an example (note your firewall might prevent you from downloading, if that is the case create a new file with notepad, paste the command and save it as download.bat).

With Parameter File

More advanced options are available using flag --mapping flag. This is achieved by including rules in a text file which essentially replace some or all of the parameters supplied to the command line utility. 

A placeholder {Collection} can be inserted into the rule's export directory which is replaced with the
Collection name before exporting the image.

An example mapping file might be:

Workspace Dataset ImageryType ImageType ExportDirectory
Imago Demo Drilling Hard Rock Core Boxes Dry c:\images\dry_hard_rock\{Collection}
Imago Demo Drilling Hard Rock c:\images\demo\hard

For more details of the options of the "export" command, you can use "imago-cmd.exe export", to display the help.

ImagoTools_Batch_Downloader.bat has an example of use a mapping file (click the image):

It is recommended you use an a text editor such as Notepad++ which color codes commands and parameters Modify the downloaded .bat file to suit your circumstance.

A complete list of commands (click the image):