Important
The 2014-10 release is compatible with GIFtools v2.30 and earlier. This version of the DCIPoctree package will not be maintained. For documentation of the latest version, see latest DCIP octree manual .
3. Elements of the program DCIPoctree (2014-10 release)¶
The DCIPoctree library consists of three core programs and nine utilities.
Core Programs:
DCIPoctreeFwd
: Forward model conductivity/chargeability models to calculate dataDCoctreeInv
: Invert 3D DC data to develop a conductivity modelIPoctreeInv
: Invert 3D IP data to develop a chargeablility model
Utilities:
create_octree_mesh
: Create an octree mesh file from electrode locations and optionally topography3DModel2Octree
: Convert from a 3D UBC-GIF mesh/model to an octree mesh/modeloctreeTo3D
: Convert from an octree mesh/model to a standard 3D UBC-GIF mesh/modelrefine_octree
: Make an octree mesh finer based on the values of the input modelremesh_octree_model
: Convert a model from one octree mesh to anothersurface_electrodes
: Place the electrodes on the topographic surfaceoctree_cell_centre
: Read in an octree mesh, and output a 3-columns file of cell centresinterface_weights
: Create a weight file for the octree cell interfacescreate_weight_file
: Create an octree cell weighting file
Each of the above programs requires an input file (or files) in order to run. Before detailing the procedures for running each of the above programs, we first present information about these general input/output files.
3.1. General files for DCIPoctree programs¶
Input files can have any user-defined name, while output files have restricted file names. Generall speaking, the filename extensions are not important. While the user can provide different file extensions for each file type (i.e. *.msh
for mesh files, *.con
for conductivity models), some users prefer to use the *.txt
filename convention so that files are more easily read and edited in the Windows environment. There are ten general file types which are used by the different codes in DCIPoctree library: