AEM Interpretation Conversion Tool (AEMInterpConvert)

Overview

For more information about AEMInterpConvert, Geoscience Australia’s Online Airborne Electromagnetic Interpretation Conversion Tool, see this Geoscience Australia article.

---

Installation Guide

1. Clone the Repository

git clone git@bitbucket.org:geoscienceaustralia/aem-interpretation-conversion.git
cd aem-interpretation-conversion

---

2. Choose Your Environment Setup

Option A: Anaconda (Recommended)

If you have Anaconda installed:

conda env create -f environment.yml
conda activate aemworkflow-env

---

Option B: Python 3.12 + Virtual Environment (VENV)

i. Ensure Python 3.12 is installed.

Linux / macOS:

python3.12 -m venv aem-venv
source aem-venv/bin/activate

Windows (Command Prompt):

python -m venv aem-venv
aem-venv\Scripts\activate.bat

ii. Install GDAL Dependencies.

Linux / macOS: Use the provided build script to install system-level GDAL and PROJ libraries:

cd builds
./linux_gdal.sh

This script will:

• Install required system packages (gdal, proj)
• Install the Python GDAL bindings matching your GDAL version

---

Windows

1. Download and install OSGeo4W.

   • Choose Advanced Install
   • Select the following packages:
     • gdal
     • proj

2. After installation (default path is C:\OSGeo4W or C:\OSGeo4W64), run the helper script to configure environment variables and install Python GDAL bindings using Windows Command prompt (CMD):

cd builds
windows_gdal.bat

This script will:

• Add OSGeo4W binaries to your PATH
• Detect the installed GDAL version (gdalinfo --version)
• Install the matching Python GDAL bindings via pip

---

iii. Verify GDAL Installation

To confirm GDAL bindings are working correctly:

python -c "from osgeo import gdal; print(gdal.VersionInfo())"

iv. Install the AEMInterpConvert Package

After setting up dependencies:

pip install .

3. CLI Usage

---

For each script, run the file with any required arguments and any additional where you want to deviate from the default. All arguments should be in quotes as per the examples.

If using Anaconda, activate conda environment if required before running the scripts.

Pre-interpretation

aemworkflow pre-interpret "{input_directory}" "{output_directory}" 

Parameter examples:

Flag	Argument	Required	Default	Options	Notes
	input directory	Yes	None		A non zipped folder containing required files
	output directory	Yes	None
	crs - GDA/MGA zone EPSG	No	28349	28349, 28350, 28351, 28352, 28354, 28355, 28356
	Interpretation GIS software	No	esri_arcmap_0.5	esri_arcmap_0.5 or esri_arcmap_pro_0.5
	depth lines	No	10
	depth lines increment	No	30

Interpretation

aemworkflow interpret "{input_directory}" "{output_directory}"

Parameter examples:

Flag	Argument	Required	Default	Options	Notes
	input directory	Yes	None		A non zipped folder containing required files
	output directory	Yes	None
	crs - GDA/MGA zone EPSG	No	28349	28349, 28350, 28351, 28352, 28354, 28355, 28356
	Interpretation GIS software	No	esri_arcmap_0.5	esri_arcmap_0.5 or esri_arcmap_pro_0.5
	depth lines	No	10
	depth lines increment	No	30

Validation

aemworkflow validate "{input_directory}" "{output_directory}" "{asud_filename}"

Parameter examples:

Flag	Argument	Required	Default	Options	Notes
	input directory	Yes	None		A non zipped folder containing required files
	output directory	Yes	None
	ausd file name	Yes	None

Conversion

aemworkflow convert "{input_directory}" "{output_directory}"

Parameter examples:

Flag	Argument	Required	Default	Options	Notes
	input directory	Yes	None		A non zipped folder containing required files
	output directory	Yes	None
	crs - GDA/MGA zone EPSG	No	28349	28349, 28350, 28351, 28352, 28354, 28355, 28356

Export

aemworkflow export "{input_directory}" "{output_directory}" "{boundary_file}" "{split_file}" -mdc -mdch -egs 

Parameter examples:

Flag	Argument	Required	Default	Options	Notes
	input directory	Yes	None		A non zipped folder containing required files
	output directory	Yes	None
	name of boundary file	Yes	None
	name of split file	Yes	None
-mdc	Export to MDC format	Yes	False
-mdch	Export to MDCH format	Yes	False
-egs	Export to EGS format	Yes	False

Useful Links

Home Page http://github.com/GeoscienceAustralia/aem-interpretation-conversion

Documentation http://GeoscienceAustralia.github.io/aem-interpretation-conversion

Issue tracking https://github.com/GeoscienceAustralia/aem-interpretation-conversion/issues

AEMInterpConvert website user interface https://aem.toolkits.ga.gov.au

Bugs & Feedback

For bugs, questions and discussions, please use
Github Issues https://github.com/GeoscienceAustralia/aem-interpretation-conversion/issues