This manual contains the documentation for DCIP octree package releases beginning on 2020-05-08. This version of the package is compatible with GIFtools v2.31 and later. If using an earlier version of GIFtools, please see the 2014-10 release manual .

4. Running the programs

This section provides describes how to run all executables pertaining to the DCIP octree package.


All executable files, input files, output filenames and files specified within input files can be specified in the following manner:

  • as just the filename if contained within the current working directory (Example: filename.txt)

  • as a file path relative to the current working directory (Example: sub_dir\filename.txt)

  • as the full path (Example: C:\Users\Name\Tests\filename.txt)

Executable files should not be renamed. However, input file names can be specified by the user if desired.

The main executable programs within the DCIP octree program library are:

  • create_octree_mesh_dcip: creates an OcTree mesh based on the survey geometry

  • dcipoctree_fwd: used to forward model both DC and IP data

  • surface_electrodes: projects electrodes in air cells to discrete surface topography

  • dcsensitivity: approximates the sensitivities for the DC or IP problem

  • sens2weights: creates sensitivity weights from sensitivities

  • dcoctree_inv: inverts DC data to recover a conductivity model

  • ipoctree_inv: inverts IP data to recover a chargeabitiliy model

The following Octree utility programs may also be helpful:

  • blk3cellOct: creates conductivity models on an OcTree mesh

  • create_weight_file: creates the weighting on each cell in the model

  • interface_weights: creates weights on the faces of cells

4.1. Contents

To learn the specifics of running each executable, see the following sections: