1. Package overview


E3D version 2 performs forward modeling and inversion with the executable e3d_v2.exe. Past iterations of this code may have been given the name ‘e3dinv_1mesh.exe’. To use this code, ensure you have downloaded E3D version 2 package from the UBC-GIF website.

1.1. Description

This manual provides instruction and background for the E3D version 2 program library for the forward modelling and inversion of frequency domain electromagnetic survey data. In order to decrease computational time and increase accuracy by mesh refinement in areas of interest, models are discretized on an Octree mesh.


Fig. 1.1 2D (QuadTree) mesh discretization about a ring (left). Cell refinement for OcTree mesh (right).

For ease of use the program library includes several utilities which generate a regular base mesh, enabling the user to construct initial or simulation models on a regular mesh and then convert to an octree mesh. From the users point of view the software operates in much the same way as previous GIF codes. This version is currently run through the command line only.

The program library provides codes to do the following:

  • Construct models on a rectangular mesh, where each cell is assigned a constant value of conductivity, and transfers the model to an octree mesh.

  • Forward model magnetic field anomaly responses to a 3D volume of contrasting conductivity, on and octree mesh.

  • Convert from and octree mesh to a regular base mesh.

  • Invert of surface, airborne, and/or borehole EM data to generate 3D conductivity models:

The inversion is solved as an optimization problem with the simultaneous goals of (i) minimizing an objective function dependent on the model and (ii) generating synthetic data that match observations to within a degree of misfit consistent with the statistics of those data.

To counteract the inherent lack of information, the formulation incorporates reference model and smoothing by regularization.

Capacity for the user to directionally weight smoothing and reference model influence as well as overall influence of regularization on objective function minimization. Explicit prior information may also take the form of upper and lower bounds on the conductivity contrast in any cell.

The regularization parameter (controlling relative importance of objective function and misfit terms). The initial research underlying this program library was funded principally by the mineral industry consortium “Joint and Cooperative Inversion of Geophysical and Geological Data” (1991 - 1997) which was sponsored by NSERC and the following 11 companies: BHP Minerals, CRA Exploration, Cominco Exploration, Falconbridge, Hudson Bay Exploration and Development, INCO Exploration & Technical Services, Kennecott Exploration Company, Newmont Gold Company, Noranda Exploration, Placer Dome, and WMC.

In comparison with the E3D version 1 program library there are several new features for mesh generation and inversion with E3D version 2. These include:

  • Surface and below surface topography cell size control. This allows the user to generate a mesh with refined cells near the surface of the topography to better capture features.

  • A more versatile format for survey and observations files

1.2. Program Library Content

The main executable programs within the E3D version 2 program library are:

  • e3d_v2: single executable file for carrying out forward modeling and inversion of FEM data

  • create_octree_mesh_e3d_v2: creates a the OcTree mesh based on transmitter and receiver locations

The following Octree utility programs may also be helpful:

  • blk3cellOct: creates a conductivity model on the OcTree mesh

  • create_weight_file: creates cell weighting for the recovered model

  • interface_weights: creates weights on the faces of cells for the recovered model

1.3. Licensing

Licensing for commercial use is managed by distributors, not by the UBC-GIF research group. Details are in the Licensing policy document.

1.4. Installing E3D

1.4.1. E3D Executables

There is no automatic installer currently available for the E3D version 2 program library. Please follow the following steps in order to use the software:

  1. Extract all files provided from the given zip-based archive and place them all together in a new folder.

  2. Add this directory as new path to your environment variables.

  3. Make sure to create a separate directory for each new inversion, where all the associated files will be stored. Do not store anything in the bin directory other than executable applications and Graphical User Interface applications (GUIs).

MPI can be downloaded here .

1.4.2. MPI Executables

Message passaging interface (MPI) programming allows E3D version 2 to utilize parallel computing. Even if the code is being run on a single machine, the user is required to download the necessary MPI package to use the E3D version 2 executables. To set up MPI:

  1. Download and install:

  1. Path the folders containing MPI executables to your environment variables.