GXIP class¶

class GXIP(handle=0)¶

GXIP class.

This class is used in the GXIP System for the import, export and processing of Induced Polarization data.

Note:

The following defines are used in GX code but are not part of any functions:

IP_ARRAY constants IP_CHANNELS constants IP_LINES constants

a_spacing(db, line)¶

Return the A-Spacing for the input line. If necessary, first imports the specified line into the GXIP object.

Parameters:	db (GXDB) – Database line (str) – Line name
Returns:	The A-Spacing value. If there are multiple A-Spacings, the base or smallest value. This value could be `rDUMMY` for some arrays (such as 3D) where no A-Spacing is explicitly defined.
Return type:	float

New in version 8.1.

License: Geosoft Extended End-User License

average_duplicates_qc(db, chan, qc_chan, out)¶

Average duplicate samples in a database.

Parameters:	db (GXDB) – Database to export from chan (str) – Mask or reference channel (required) qc_chan (str) – QC channel (can be left blank) out (int) – IP_DUPLICATE constants

New in version 7.3.

License: Geosoft Extended End-User License

Note: Averages all values with shared station and N values, as long as the mask channel is defined at that FID. Previous averaged values (IP_DATA_AVG) are overwritten according to the overwrite flag. If the QC channel is selected, only those rows of data where the QC channel value is “1” will be included in the average.

classmethod convert_ubcip_2d_to_grid(file, pg, vv_x, vv_z, x, z, cx, cz, reciprocal)¶

Convert a UBC 2D model to a regular grid.

Parameters:

file (str) – Output grid file name
pg (GXPG) – Model data
vv_x (GXVV) – Model cells sizes (input)
vv_z (GXVV) – Model cells sizes (input)
x (float) – Top-left corner X
z (float) – Top-left corner Z
cx (float) – Output grid cell size in X
cz (float) – Output grid cell size in Z
reciprocal (int) – Output reciprocal of values (0:No, 1:Yes) for resistivity?

New in version 7.1.

License: Geosoft Extended End-User License

Note: Uses GXTIN gridding to sample the model. By setting the final value, a resistivity grid can be created from conductivity data.

classmethod create()¶

Create GXIP.

Returns:	`GXIP` Object
Return type:	GXIP

New in version 5.0.

License: Geosoft Extended End-User License

create_default_job(ini, type)¶

Create a default job from scratch.

Parameters:	ini (str) – File name of the INI file to create (forces correct suffix) type (int) – IP_PLOT constants

New in version 6.1.

License: Geosoft Extended End-User License

export_data_to_ubc_3d(db, line_lst, locations_only, include_z, chan, error_chan, mask_chan, ip_type, comments, obs)¶

Export of GXIP data to UBC 3D GXIP format.

Parameters:

db (GXDB) – GXDB object
line_lst (GXLST) – Lines to export (Name, Symbol)
locations_only (int) – Locations only (0: No, 1: Yes)?
include_z (int) – Include Z values (0: No, 1: Yes)?
chan (str) – GXIP channel name (can be “” if exporting locations only)
error_chan (str) – Error channel name (can be “” if exporting locations only)
mask_chan (str) – Mask channel name (can be “”)
ip_type (int) – IPTYPE (1: Vp, 2: Chargeability)
comments (str) – Comments (can be “”)
obs (str) – Output OBS file name

New in version 9.2.

License: Geosoft Extended End-User License

Note: Outputs a *.DAT file of the survey data for use in the UBC GXIP 3D inversion programs.

export_i2_x(db, file, line, res_data, ip_data, res_model, ip_model, res_synth, ip_synth, res_poly, ip_poly)¶

Export line(s) to an Interpex RESIX I2X format file.

Parameters:

db (GXDB) – Database to export from
file (str) – Name of the file
line (str) – Name of the line
res_data (str) – Resistivity (data) channel
ip_data (str) – GXIP (data) channel (can be “”)
res_model (str) – Image model resistivity channel (can be “”)
ip_model (str) – Image model GXIP channel (can be “”)
res_synth (str) – Image model synthetic resistivity channel (can be “”)
ip_synth (str) – Image model synthetic GXIP channel (can be “”)
res_poly (str) – Resistivity (polygon) channel (can be “”)
ip_poly (str) – GXIP (polygon) channel (can be “”)

New in version 5.0.

License: Geosoft Extended End-User License

Note: Exports a line to an ”.I2X” file.

export_ipdata(db, chan, title)¶

Exports data in the Geosoft IPDATA format.

Parameters:	db (GXDB) – Database to export from chan (str) – Channel to export title (str) – Title for IPDATA files

New in version 5.0.

License: Geosoft Extended End-User License

export_ipdata_dir(db, chan, title, dir)¶

Exports data in the Geosoft IPDATA format in the specified directory

Parameters:	db (GXDB) – Database to export from chan (str) – Channel to export title (str) – Title for IPDATA files dir (str) – Directory for IPDATA files

New in version 6.4.

License: Geosoft Extended End-User License

export_ipred(db, title, chan, suffix, filter, wts, stn1, stn2, max_n)¶

Exports pseudo-section in the Geosoft IPRED format.

Parameters:

db (GXDB) – Database to export from
title (str) – Title for first line of file
chan (str) – Channel to process
suffix (str) – File suffix (type)
filter (int) – IP_FILTER constants
wts (str) – The Fraser Filter weights
stn1 (float) – First Station position (rDUMMY for default)
stn2 (float) – Last Station position (rDUMMY for default)
max_n (int) – Maximum n spacing

New in version 5.0.

License: Geosoft Extended End-User License

Note: The Fraser Filter weights apply to each N expansion above, and are listed as w1,w2,w3,... Unspecified values beyond the list’s end are set to 1.0.

export_ipred_dir(db, title, chan, suffix, filter, wts, stn1, stn2, max_n, dir)¶

Exports pseudo-section in the Geosoft IPRED format in the specified directory

Parameters:

db (GXDB) – Database to export from
title (str) – Title for first line of file
chan (str) – Channel to process
suffix (str) – File suffix (type)
filter (int) – IP_FILTER constants
wts (str) – The Fraser Filter weights
stn1 (float) – First Station position (rDUMMY for default)
stn2 (float) – Last Station position (rDUMMY for default)
max_n (int) – Maximum n spacing
dir (str) – Directory to export to

New in version 6.4.

License: Geosoft Extended End-User License

Note: The Fraser Filter weights apply to each N expansion above, and are listed as w1,w2,w3,... Unspecified values beyond the list’s end are set to 1.0.

export_line_ipdata(db, line, chan, title)¶

Exports one line of data in the Geosoft IPDATA format.

Parameters:	db (GXDB) – Database to export from line (str) – Line to export chan (str) – Channel to export title (str) – Title for IPDATA files

New in version 5.1.8.

License: Geosoft Extended End-User License

export_sgdf(db, file, chan, chan2)¶

Exports data to a Scintrex Geophysical Data Format file.

Parameters:	db (GXDB) – Database to export from file (str) – SGDF file to create chan (str) – Time Domain channel or Frequency Amplitude Channel chan2 (str) – Frequency Domain Phase channel (optional)

New in version 5.0.

License: Geosoft Extended End-User License

export_ubc_res3(db, line, voltage_chan, current_chan, error_chan, obs, topo, version)¶

Export of GXIP Resistivity data to UBC format.

Parameters:	db (GXDB) – `GXDB` object line (str) – Output line name voltage_chan (str) – Output voltage channel name current_chan (str) – Output current channel name error_chan (str) – Output error channel name (“” for none) obs (str) – Output OBS file name topo (str) – Output TOPO file name version (float) – Version number (3 or 5)

New in version 8.1.

License: Geosoft Extended End-User License

Note: Outputs a *.DAT file of the survey data for use in the UBC 2D inversion program DCINV2D. Voltage and current channels should be in units such that V/I gives volts/amp (or mV/mA).

classmethod export_ubc_res_control(control, n_iter, i_rest, chi_factor, obs, mesh, topo, initial, ref_cond, alphas, wts)¶

Export a control file for using in the UBC DCINV2D program.

Parameters:

control (str) – Output control file name
n_iter (int) – niter
i_rest (int) – irest
chi_factor (float) – chifact
obs (str) – RES obs file
mesh (str) – Mesh file
topo (str) – Topography file (required)
initial (str) – Initial model file (can be “” or “NULL”)
ref_cond (float) – Reference model conductivity
alphas (str) – Alphas
wts (str) – Weights file

New in version 6.4.

License: Geosoft Extended End-User License

Note: UBC Version 3. Outputs a control file for use in the UBC 2D resistivity inversion program DCINV2D.

classmethod export_ubc_res_control_v5(control, n_iter, chi_factor, obs, topo, mesh_selection, mesh, initial_selection, initial, reference_selection, ref_cond, alphas_selection, alphas, wts)¶

Export a control file for using in the UBC DCINV2D program.

Parameters:

control (str) – Output control file name
n_iter (int) – niter
chi_factor (float) – chifact
obs (str) – RES obs file
topo (str) – Topography file (required)
mesh_selection (int) – Mesh type IP_UBC_CONTROL constants FILE, VALUE or DEFAULT
mesh (str) – Mesh file (can be “”) or value
initial_selection (int) – Initial model type IP_UBC_CONTROL constants FILE, VALUE or DEFAULT
initial (str) – Initial model file (can be “”) or value
reference_selection (int) – Reference model type IP_UBC_CONTROL constants FILE, VALUE or DEFAULT
ref_cond (str) – Reference model file (can be “”) or value(
alphas_selection (int) – Alphas type IP_UBC_CONTROL constants FILE, VALUE, LENGTH or DEFAULT
alphas (str) – Alphas file (can be “”), value or length
wts (str) – Weights file

New in version 8.1.

License: Geosoft Extended End-User License

Note: UBC Version 5. Outputs a control file for use in the UBC 2D resistivity inversion program DCINV2D.

export_ubcip3(db, line, chan, error_chan, obs, topo, version)¶

Export of GXIP data to UBC format.

Parameters:	db (GXDB) – `GXDB` object line (str) – Output line name chan (str) – Output `GXIP` channel name error_chan (str) – Output error channel name (“” for none) obs (str) – Output OBS file name topo (str) – Output TOPO file name version (float) – Version number (3 or 5)

New in version 8.1.

License: Geosoft Extended End-User License

Note: Outputs a *.DAT file of the survey data for use in the UBC 2D inversion program IPINV2D. Include error channel output and version-specific formatting.

classmethod export_ubcip_control(control, n_iter, i_rest, chi_factor, obs, cond, mesh, topo, initial, ref_mod, alphas, wts)¶

Export a control file for using in the UBC IPINV2D program.

Parameters:

control (str) – Output control file name
n_iter (int) – niter
i_rest (int) – irest
chi_factor (float) – chifact
obs (str) – GXIP obs file
cond (str) – Conductivity file
mesh (str) – Mesh file
topo (str) – Topography file
initial (str) – Initial model file
ref_mod (str) – Reference model
alphas (str) – Alphas
wts (str) – Weights file

New in version 6.4.

License: Geosoft Extended End-User License

Note: UBC Version 3 Control file. Outputs a control file for use in the UBC 2D GXIP inversion program IPINV2D.

classmethod export_ubcip_control_v5(control, n_iter, chi_factor, obs, topo, cond_selection, cond, mesh_selection, mesh, initial_selection, initial, reference_selection, ref_cond, alphas_selection, alphas, wts)¶

Export a control file for using in the UBC IPINV2D program.

Parameters:

control (str) – Output control file name
n_iter (int) – niter
chi_factor (float) – chifact
obs (str) – RES obs file
topo (str) – Topography file (required)
cond_selection (int) – Conductivity type IP_UBC_CONTROL constants FILE or VALUE
cond (str) – Conductivity file (can be “”) or value
mesh_selection (int) – Mesh type IP_UBC_CONTROL constants FILE, VALUE or DEFAULT
mesh (str) – Mesh file (can be “”) or value
initial_selection (int) – Initial model type IP_UBC_CONTROL constants FILE, VALUE or DEFAULT
initial (str) – Initial model file (can be “”) or value
reference_selection (int) – Reference model type IP_UBC_CONTROL constants FILE, VALUE or DEFAULT
ref_cond (str) – Reference model file (can be “”) or value(
alphas_selection (int) – Alphas type IP_UBC_CONTROL constants FILE, VALUE, LENGTH or DEFAULT
alphas (str) – Alphas file (can be “”), value or length
wts (str) – Weights file

New in version 8.1.

License: Geosoft Extended End-User License

Note: UBC Version 5 Control file.

get_chan_domain(db, chan)¶

Is this channel registered as a Time or Frequency domain channel?

Parameters:	db (GXDB) – Database chan (str) – Channel to check
Returns:	IP_DOMAIN constants
Return type:	int

New in version 5.1.8.

License: Geosoft Extended End-User License

classmethod get_chan_label(chan, label, units)¶

Get the default label and units for a given channel.

Parameters:	chan (str) – Input channel label (str_ref) – Returned label units (str_ref) – Returned units

New in version 5.0.

License: Geosoft Extended End-User License

get_channel_info(db, chan, domain, delay, n_windows, vv)¶

Time Windows or Frequency info from a channel.

Parameters:	db (GXDB) – Database chan (str) – Channel to check domain (int_ref) – IP_DOMAIN constants delay (float_ref) – Delay or Base Frequency n_windows (int_ref) – Number of time windows or frequencies vv (GXVV) – Time windows or frequencies

New in version 8.1.

License: Geosoft Extended End-User License

get_electrode_locations_and_mask_values(db, line, tx_rx, v_vx, v_vy, v_vm1, v_vm2)¶

Get unique electrodes, along with current mask info.

Parameters:	db (GXDB) – `GXDB` object line (str) – Line name (“” for all selected lines) tx_rx (int) – Electrode type. 0:Tx, 1:Rx v_vx (GXVV) – X locations v_vy (GXVV) – Y locations v_vm1 (GXVV) – `GXIP` QC channel values (“QC” or “QC_IP”) v_vm2 (GXVV) – Resistivity QC channel values (“QC_RES”)

New in version 9.0.

License: Geosoft Extended End-User License

Note: The mask values are determined from the first row where a given electrode is found. Values returned for all currently selected lines.

get_electrode_locations_and_mask_values2(db, line, tx_rx, v_vx, v_vy, v_vm1, v_vm2, v_vlines)¶

Get unique electrodes, along with current mask info.

Parameters:

db (GXDB) – GXDB object
line (str) – Line name (“” for all selected lines)
tx_rx (int) – Electrode type. 0:Tx, 1:Rx
v_vx (GXVV) – X locations
v_vy (GXVV) – Y locations
v_vm1 (GXVV) – GXIP QC channel values (“QC” or “QC_IP”)
v_vm2 (GXVV) – Resistivity QC channel values (“QC_RES”)
v_vlines (GXVV) – Line symbol values (GS_INT)

New in version 9.2.

License: Geosoft Extended End-User License

Note: The mask values are determined from the first row where a given electrode is found. Values returned for all currently selected lines.

get_n_value_lst(db, lst)¶

Fill a list with unique N values in selected lines.

Parameters:	db (GXDB) – Database lst (GXLST) – `GXLST` object

New in version 6.1.

License: Geosoft Extended End-User License

classmethod get_qc_channel(db, qc_type, chan)¶

Get the QC channel handle, if it exists.

Parameters:	db (GXDB) – `GXDB` object qc_type (int) – QC channel type. IP_QCTYPE constants chan (str_ref) – String to place name into
Returns:	Channel handle, `NULLSYMB` if not found
Return type:	int

New in version 9.2.

License: Geosoft Extended End-User License

Note: For GXIP, looks for “QC_IP”, then “QC_OffTime”, then “QC”. For Resistivity, looks for “QC_Res”, then “QC_OnTime” (case insensitive).

get_topo_line(db, line, x_min, x_max, x_inc, vv)¶

Get topography values for a line.

Parameters:	db (GXDB) – Database to import data to line (str) – Line name x_min (float) – Starting “X” (station) value (`rDUMMY` for default) x_max (float) – Ending “X” (station) value (`rDUMMY` for default) x_inc (float) – “X” increment along the line (`rDUMMY` for default = half “A” separation) vv (GXVV) – Returned topography values

New in version 6.4.2.

License: Geosoft Extended End-User License

Note: If topography info is available, returns values calculated for the input line. If no topography is available, returned values will be dummies. Values between actual data are interpolated using the Akima spline. Ends are extrapolated using the end data points.

import_dump(ip_sys, db, dump_file)¶

Imports data from an GXIP instrument dump file.

Parameters:	ip_sys (int) – IP_SYS constants db (GXDB) – `GXDB` Handle dump_file (str) – Dump file name

New in version 5.0.

License: Geosoft Extended End-User License

import_grid(db, grid, chan)¶

Imports data from a grid

Parameters:	db (GXDB) – Database to import data to grid (str) – The name of the grid file, with decorations chan (str) – The name of the channel to import to

New in version 5.0.

License: Geosoft Extended End-User License

Note: Data is imported to the specified channel. The values are interpolated at each row’s X and Y positions.

import_i2_x(db, file, line, res_data, ip_data, res_model, ip_model, res_synth, ip_synth, res_poly, ip_poly, mode)¶

Imports an Interpex RESIX I2X format file to a line.

Parameters:

db (GXDB) – Database to import to
file (str) – Name of file to import
line (str) – Line to import to
res_data (str) – Resistivity (data) channel
ip_data (str) – GXIP (data) channel (can be “”)
res_model (str) – Image model resistivity channel (can be “”)
ip_model (str) – Image model GXIP channel (can be “”)
res_synth (str) – Image model synthetic resistivity channel (can be “”)
ip_synth (str) – Image model synthetic GXIP channel (can be “”)
res_poly (str) – Resistivity (polygon) channel (can be “”)
ip_poly (str) – GXIP (polygon) channel (can be “”)
mode (int) – IP_I2XIMPMODE constants

New in version 5.0.

License: Geosoft Extended End-User License

Note: Imports a single ”.I2X” file to a specified line. If the line does not exist, it will be created.

import_i2_x_ex(db, file, line, res_data, ip_data, res_model, ip_model, res_synth, ip_synth, res_poly, ip_poly, res_zonge, ip_zonge, mode)¶

Same as import_i2_x, with Zonge data imported as well.

Parameters:

db (GXDB) – Database to import to
file (str) – Name of file to import
line (str) – Line to import to
res_data (str) – Resistivity (data) channel
ip_data (str) – GXIP (data) channel (can be “”)
res_model (str) – Image model resistivity channel (can be “”)
ip_model (str) – Image model GXIP channel (can be “”)
res_synth (str) – Image model synthetic resistivity channel (can be “”)
ip_synth (str) – Image model synthetic GXIP channel (can be “”)
res_poly (str) – Resistivity (polygon) channel (can be “”)
ip_poly (str) – GXIP (polygon) channel (can be “”)
res_zonge (str) – Zonge Resistivity channel (can be “”)
ip_zonge (str) – Zonge GXIP channel (can be “”)
mode (int) – IP_I2XIMPMODE constants

New in version 6.1.

License: Geosoft Extended End-User License

Note: Imports a single ”.I2X” file to a specified line. If the line does not exist, it will be created.

import_instrumentation_gdd(db, file)¶

Imports an Instrumentation GDD format file.

Parameters:	db (GXDB) – Database to import to file (str) – GDD file name

New in version 8.0.

License: Geosoft Extended End-User License

import_ipdata(db, file, chan)¶

Imports data in the Geosoft IPDATA format.

Parameters:	db (GXDB) – Database to import to file (str) – IPDATA file name chan (str) – Channel to import to

New in version 5.0.

License: Geosoft Extended End-User License

import_ipdata2(db, file, chan, chan2)¶

Imports data in the Geosoft IPDATA format - up to two arrays.

Parameters:	db (GXDB) – Database to import to file (str) – IPDATA file name chan (str) – Channel to import to (default is “`GXIP`”) chan2 (str) – (optional) Second channel to import to

New in version 5.1.

License: Geosoft Extended End-User License

Note: The second channel may be specified for frequency domain data sets with two array channels; e.g. amplitude and phase, or real and imaginary parts. If the second channel is specified, and no time or frequncy information is specified in the header (using the T= or F= fields) then the import is assumed to be frequency domain.

import_ipred(db, file, chan)¶

Imports data from the Geosoft IPRED format.

Parameters:	db (GXDB) – Database to import to file (str) – File to import from chan (str) – Channel to import

New in version 5.1.

License: Geosoft Extended End-User License

Note: This import produces a limited GXIP data set with no Current “I”, Voltage “Vp” or Apparent Resistivity “ResApp” values.

import_merge_ipred(db, file, chan)¶

Imports IPRED data to an existing line.

Parameters:	db (GXDB) – Database to import to file (str) – File to import from chan (str) – Channel to import

New in version 5.1.8.

License: Geosoft Extended End-User License

Note: Exits with error if the line does not exist. Data is merged on basis of Stn and N value.

import_sgdf(db, file)¶

Imports data from a Scintrex Geophysical Data Format file.

Parameters:	db (GXDB) – Database to import to file (str) – SGDF file name

New in version 5.0.

License: Geosoft Extended End-User License

import_topo_csv(db, csv)¶

Imports topography data from a CSV line-station file

Parameters:	db (GXDB) – Database to calculate topography for csv (str) – The name of CSV file

New in version 5.0.

License: Geosoft Extended End-User License

Note: The elevation of each point in the current database is interpolated from the input topography values.

import_topo_grid(db, grid)¶

Imports topography data from a grid

Parameters:	db (GXDB) – Database to calculate topography for grid (str) – The name of the grid file, with decorations

New in version 5.0.

License: Geosoft Extended End-User License

Note: The elevation of each point in the current database is interpolated from the input topography grid.

classmethod import_ubc2_dmod(file, type)¶

Import a MOD file from the UBC IPINV2D program.

Parameters:	file (str) – UBC MOD file name to import type (int) – 0 - CON, 1 - CHG
Returns:	`GXPG` Object
Return type:	GXPG

New in version 7.1.

License: Geosoft Extended End-User License

Note: Imports the MOD file values to a GXPG object. The CON/CHG selection is necessary because the import sets padding values to dummies based on the type of file.

classmethod import_ubc2_dmsh(file, x, z, vv_x, vv_z)¶

Import a MSH file from the UBC IPINV2D program.

Parameters:	file (str) – UBC MSH file to import x (float_ref) – Returned origin X (top left corner) z (float_ref) – Returned origin Z (top left corner) vv_x (GXVV) – Cell widths (left to right) (real) vv_z (GXVV) – Cell heights (top down) (real)

New in version 7.1.

License: Geosoft Extended End-User License

Note: Imports the MSH file geometry.

classmethod import_ubc_2d_topo(file, elev0, vv_x, vv_z)¶

Import a Topography file from the UBC IPINV2D program.

Parameters:	file (str) – UBC Topo file to import elev0 (float_ref) – Returned top of mesh elevation vv_x (GXVV) – Topography X values vv_z (GXVV) – Topography Z values (elevations)

New in version 7.1.

License: Geosoft Extended End-User License

Note: Imports the maximum elevation (top of mesh) as well as the topo (X, Z) values.

import_zonge_avg(db, file, line, scale, mult)¶

Imports a Zonge AVG format file.

Parameters:	db (GXDB) – Database to import to file (str) – FLD file name line (float) – Line number (will be scaled if applicable) scale (int) – IP_STNSCALE constants mult (float) – Line, station multiplier (for `IP_STNSCALE_VALUE`)

New in version 5.0.

License: Geosoft Extended End-User License

Note: See import_zonge_fld

import_zonge_fld(db, file, scale, mult)¶

Imports a Zonge FLD format file.

Parameters:	db (GXDB) – Database to import to file (str) – FLD file name scale (int) – IP_STNSCALE constants mult (float) – Line, station multiplier (for `IP_STNSCALE_VALUE`)

New in version 5.0.

License: Geosoft Extended End-User License

Note: The Zonge Line and Station numbers may not be the X or Y position values, and a conversion is required. The line direction is taken from the GXIP setup values.

is_null()¶

Check if this is a null (undefined) instance

Returns:	True if this is a null (undefined) instance, False otherwise.
Return type:	bool

is_valid_line(db, line)¶

See if a given database line is registered for the GXIP system

Parameters:	db (GXDB) – Database line (str) – Line name
Returns:	1 if the line is a valid `GXIP` line, 0 if not
Return type:	int

New in version 8.1.

License: Geosoft Extended End-User License

line_array_type(db, line)¶

Return the type of GXIP array for the input line. If necessary, first imports the specified line into the GXIP object

Parameters:	db (GXDB) – Database line (str) – Line name
Returns:	IP_ARRAY constants
Return type:	int

New in version 8.1.

License: Geosoft Extended End-User License

new_xy_database(db, new_db, chan_vv, mask, pr_n_val)¶

Create a subset database using a mask channel, “N” value

Parameters:	db (GXDB) – `GXDB` object new_db (GXDB) – New `GXDB` object chan_vv (GXVV) – Channel list mask (str) – Mask channel pr_n_val (float) – “N” Value

New in version 5.0.

License: Geosoft Extended End-User License

Note: A mask channel can be used to select a subset of the data. A single N value can also be selected (Dummy for all).

classmethod null()¶

A null (undefined) instance of GXIP

Returns:	A null `GXIP`
Return type:	GXIP

open_job(job, type)¶

Open a GXIP plotting job

Parameters:	job (str) – Job file name type (int) – Job type IP_PLOT constants

New in version 6.1.

License: Geosoft Extended End-User License

pldp_convention()¶

Return the user’s plot point convention for pole-dipole arrays.

Returns:	The user’s PLDP plot point convention IP_PLDP_CONV constants
Return type:	int

New in version 8.1.

License: Geosoft Extended End-User License

ps_stack(db, chan, con_file, map)¶

Create a stacked pseudo-section plot using a control file.

Parameters:	db (GXDB) – `GXDB` object chan (str) – Channel to plot con_file (str) – “IPPLOT” INI file name map (str) – Map name to create

New in version 5.0.

License: Geosoft Extended End-User License

Note: The control file is created using the IPSTAKCON GX. It may then be modified by hand as required.

ps_stack2(db, chan, con_file, type, map)¶

As ps_stack, but select section spacing option.

Parameters:	db (GXDB) – `GXDB` object chan (str) – Channel to plot con_file (str) – “IPPLOT” INI file name type (int) – IP_STACK_TYPE constants map (str) – Map name to create

New in version 5.1.

License: Geosoft Extended End-User License

ps_stack2_dir(db, chan, con_file, type, map, dir)¶

Same as pseudo_plot2, but with directory specified.

Parameters:	db (GXDB) – `GXDB` object chan (str) – Channel to plot con_file (str) – “IPPLOT” INI file name type (int) – IP_STACK_TYPE constants map (str) – Map name to create dir (str) – Directory to create files

New in version 6.4.

License: Geosoft Extended End-User License

pseudo_plot(db, ini_file, cur_line, map)¶

Create pseudo-sections of a single line using a control file.

Parameters:	db (GXDB) – Database ini_file (str) – “IPPLOT” INI file name cur_line (str) – Current line name map (str) – Map name to create

New in version 5.0.

License: Geosoft Extended End-User License

Note: The control file is created using the IPPLTCON GX. It may then be modified by hand as required.

pseudo_plot2(db, ini_file, cur_line, tag, map)¶

Same as pseudo_plot, but specify a tag for grids created.

Parameters:	db (GXDB) – Database ini_file (str) – “IPPLOT” INI file name cur_line (str) – Current line name tag (str) – Tag for created grids map (str) – Map name to create

New in version 5.1.8.

License: Geosoft Extended End-User License

Note: The control file is created using the IPPLTCON GX. It may then be modified by hand as required.

pseudo_plot2_dir(db, ini_file, cur_line, tag, map, dir)¶

Same as pseudo_plot2, but with directory specified.

Parameters:	db (GXDB) – Database ini_file (str) – “IPPLOT” INI file name cur_line (str) – Current line name tag (str) – Tag for created grids map (str) – Map name to create dir (str) – Directory to create files

New in version 6.4.

License: Geosoft Extended End-User License

Note: The control file is created using the IPPLTCON GX. It may then be modified by hand as required.

qc_chan_lst(db, lst)¶

Fill a list with QC channels.

Parameters:	db (GXDB) – Database lst (GXLST) – `GXLST` object

New in version 7.3.

License: Geosoft Extended End-User License

Note: Searches for the following QC channels existing in a database: QC, QC_RES.

recalculate(db)¶

Recalculate derived channel values.

Parameters:	db (GXDB) – Database

New in version 5.0.

License: Geosoft Extended End-User License

Note: This function recalculates “derived” channel values from “core” data.

Recalculates the “STN” and “N” channels, using the TX1, TX2, RX1 and RX2 channels (depending on the system).

Recalculates the apparent resistivity “ResCalc”, average “IP_Avg” and metal factor “MF” channels

Recalculates the “X” and “Y” channels. One of these will be equal to “STN”, the other to the internally stored line number for the current line.

Recalculate the “Z” channel, based on the current “Topo” channel, and the “N” values.

Warning: If you make a change to an electrode location, you would have to call recalculate, then recalculate “Topo” (since the X and Y values would have changed), then call recalculate_z, since “Z” values are based on “Topo” values.

recalculate_ex(db, recalculate_xyz)¶

Recalculate derived channel values, with option for including/excluding location calculations.

Parameters:	db (GXDB) – Database recalculate_xyz (int) – Recalculate XYZ locations (TRUE or FALSE)?

New in version 8.0.

License: Geosoft Extended End-User License

Note: See recalculate. This version allows you to suppress the recalculation of the current X, Y and Z channel values from the station locations.

recalculate_z(db)¶

Recalculate Z channel values.

Parameters:	db (GXDB) – Database

New in version 5.1.1.

License: Geosoft Extended End-User License

Note: The “Z” channel values are calculated as follows: If the “Topo” value is defined, then Z = Topo - 0.5*N*A, where “N” is the N-spacing, and A is the A-spacing. If the Topography is not defined, then it is assumed to be equal to 0.

IP_ARRAY constants¶

GXIP Array options

IP_ARRAY_DPDP¶

Dpdp

gxapi.IP_ARRAY_DPDP = 0

IP_ARRAY_PLDP¶

Pldp

gxapi.IP_ARRAY_PLDP = 1

IP_ARRAY_PLPL¶

Plpl

gxapi.IP_ARRAY_PLPL = 2

IP_ARRAY_GRAD¶

Grad

gxapi.IP_ARRAY_GRAD = 3

IP_ARRAY_WENNER¶

Wenner

gxapi.IP_ARRAY_WENNER = 5

IP_ARRAY_SCHLUMBERGER¶

Schlumberger

gxapi.IP_ARRAY_SCHLUMBERGER = 6

IP_ARRAY_UNKNOWN¶

Unknown

gxapi.IP_ARRAY_UNKNOWN = 7

IP_ARRAY_3D¶

3d

gxapi.IP_ARRAY_3D = 9

IP_ARRAY_3D_PLDP¶

3d pldp

gxapi.IP_ARRAY_3D_PLDP = 10

IP_ARRAY_3D_PLPL¶

3d plpl

gxapi.IP_ARRAY_3D_PLPL = 11

IP_CHANNELS constants¶

Channels to display

IP_CHANNELS_DISPLAYED¶

Displayed

gxapi.IP_CHANNELS_DISPLAYED = 0

IP_CHANNELS_SELECTED¶

Selected

gxapi.IP_CHANNELS_SELECTED = 1

IP_CHANNELS_ALL¶

All

gxapi.IP_CHANNELS_ALL = 2

IP_DOMAIN constants¶

Types of Domains

IP_DOMAIN_NONE¶

None

gxapi.IP_DOMAIN_NONE = -1

IP_DOMAIN_TIME¶

Time

gxapi.IP_DOMAIN_TIME = 0

IP_DOMAIN_FREQUENCY¶

Frequency

gxapi.IP_DOMAIN_FREQUENCY = 1

IP_DOMAIN_BOTH¶

Both

gxapi.IP_DOMAIN_BOTH = 2

IP_DUPLICATE constants¶

How to handle duplicates

IP_DUPLICATE_APPEND¶

Append

gxapi.IP_DUPLICATE_APPEND = 0

IP_DUPLICATE_OVERWRITE¶

Overwrite

gxapi.IP_DUPLICATE_OVERWRITE = 1

IP_FILTER constants¶

Fraser Filters

IP_FILTER_PANTLEG¶

Regular pant-leg filter:


   _!_
  /*_*\\   n1
 /*/ \\*\\  n2`
/*/   \\*\\ n3
   :  :

gxapi.IP_FILTER_PANTLEG = 1

IP_FILTER_PANTLEGP¶

Regular pant-leg filter with top at first point:

   !  nscp:
  /*\\   n1
 /*_*\\  n2
/*/ \\*\\ n3
  :  :

gxapi.IP_FILTER_PANTLEGP = 2

IP_FILTER_PYRIAMID¶

Regular pyramid filter:

   _!_  maxn:
  /* *\\   n1
 /* * *\\  n2
/* * * *\\ n3
   :  :

gxapi.IP_FILTER_PYRIAMID = 3

IP_FILTER_PYRIAMIDP¶

Regular pyramid filter with peak on a point:

   !  maxn:
  /*\\   n1
 /* *\\  n2
/* * *\\ n3
  :  :

gxapi.IP_FILTER_PYRIAMIDP = 4

IP_I2XIMPMODE constants¶

Interpext Import Mode

IP_I2XIMPMODE_REPLACE¶

Recreates the line from scratch.

gxapi.IP_I2XIMPMODE_REPLACE = 0

IP_I2XIMPMODE_MERGE¶

Looks for matching Tx1 and N values and replaces data in matching lines only.

gxapi.IP_I2XIMPMODE_MERGE = 1

IP_I2XINV constants¶

Type of Inversion

IP_I2XINV_IMAGE¶

Image

gxapi.IP_I2XINV_IMAGE = 0

IP_I2XINV_ZONGE¶

Zonge

gxapi.IP_I2XINV_ZONGE = 1

IP_LINES constants¶

Lines to display

IP_LINES_DISPLAYED¶

Displayed

gxapi.IP_LINES_DISPLAYED = 0

IP_LINES_SELECTED¶

Selected

gxapi.IP_LINES_SELECTED = 1

IP_LINES_ALL¶

All

gxapi.IP_LINES_ALL = 2

IP_PLOT constants¶

Type of Plot

IP_PLOT_PSEUDOSECTION¶

Pseudosection

gxapi.IP_PLOT_PSEUDOSECTION = 0

IP_PLOT_STACKEDSECTION¶

Stackedsection

gxapi.IP_PLOT_STACKEDSECTION = 1

IP_QCTYPE constants¶

Type of Measurement

IP_QCTYPE_RESISTIVITY¶

Resistivity

gxapi.IP_QCTYPE_RESISTIVITY = 0

IP_QCTYPE_IP¶

GXIP

gxapi.IP_QCTYPE_IP = 1

IP_STACK_TYPE constants¶

Spacing Types

IP_STACK_TYPE_MAP¶

Use map-based spacing, and preserve the directions of the original lines by rotating the sections as desired to their true locations. (At present only N-S and E-W sections are supported).

gxapi.IP_STACK_TYPE_MAP = 0

IP_STACK_TYPE_EQUAL¶

Spaces the sections equally, with enough room to guarantee no overlap with high N-values or closely spaced lines.

gxapi.IP_STACK_TYPE_EQUAL = 1

IP_STACK_TYPE_GEOGRAPHIC¶

Now the same as IP_STACK_MAP

gxapi.IP_STACK_TYPE_GEOGRAPHIC = 2

IP_STNSCALE constants¶

Station Scaling

IP_STNSCALE_NONE¶

Station numbers become X or Y locations

gxapi.IP_STNSCALE_NONE = 0

IP_STNSCALE_ASPACE¶

Multiply station numbers by the A spacing

gxapi.IP_STNSCALE_ASPACE = 1

IP_STNSCALE_VALUE¶

Multiply by an input value.

gxapi.IP_STNSCALE_VALUE = 2

IP_STNSCALE_FILE¶

Look up locations from a CSV Line/Station/X/Y file

gxapi.IP_STNSCALE_FILE = 3

IP_SYS constants¶

Instrument

IP_SYS_IPDATA¶

Ipdata

gxapi.IP_SYS_IPDATA = 0

IP_SYS_IP2¶

Ip2

gxapi.IP_SYS_IP2 = 1

IP_SYS_IP6¶

Ip6

gxapi.IP_SYS_IP6 = 2

IP_SYS_IP10¶

Ip10

gxapi.IP_SYS_IP10 = 3

IP_SYS_SYSCALR2¶

Syscalr2

gxapi.IP_SYS_SYSCALR2 = 4

IP_SYS_IPR11¶

Ipr11

gxapi.IP_SYS_IPR11 = 5

IP_SYS_IPR12¶

Ipr12

gxapi.IP_SYS_IPR12 = 6

IP_SYS_PHOENIX¶

Phoenix

gxapi.IP_SYS_PHOENIX = 7

IP_SYS_PHOENIX_V2¶

Phoenix v2

gxapi.IP_SYS_PHOENIX_V2 = 8

IP_SYS_ELREC_PRO¶

Elrec pro

gxapi.IP_SYS_ELREC_PRO = 9

IP_SYS_PROSYS_II¶

Prosys ii

gxapi.IP_SYS_PROSYS_II = 10

IP_UBC_CONTROL constants¶

Types of Domains

IP_UBC_CONTROL_NONE¶

None

gxapi.IP_UBC_CONTROL_NONE = -1

IP_UBC_CONTROL_DEFAULT¶

Default

gxapi.IP_UBC_CONTROL_DEFAULT = 0

IP_UBC_CONTROL_FILE¶

File

gxapi.IP_UBC_CONTROL_FILE = 1

IP_UBC_CONTROL_VALUE¶

Value

gxapi.IP_UBC_CONTROL_VALUE = 2

IP_UBC_CONTROL_LENGTH¶

Length

gxapi.IP_UBC_CONTROL_LENGTH = 3

IP_PLDP_CONV constants¶

Types of Domains

IP_PLDP_CONV_CLOSE_RX¶

Close rx

gxapi.IP_PLDP_CONV_CLOSE_RX = 0

IP_PLDP_CONV_MID_RX¶

Mid rx

gxapi.IP_PLDP_CONV_MID_RX = 1

IP_PLDP_CONV_DISTANT_RX¶

Distant rx

gxapi.IP_PLDP_CONV_DISTANT_RX = 2

Table Of Contents

This Page

GXIP class¶

IP_ARRAY constants¶

IP_CHANNELS constants¶

IP_DOMAIN constants¶

IP_DUPLICATE constants¶

IP_FILTER constants¶

IP_I2XIMPMODE constants¶

IP_I2XINV constants¶

IP_LINES constants¶

IP_PLOT constants¶

IP_QCTYPE constants¶

IP_STACK_TYPE constants¶

IP_STNSCALE constants¶

IP_SYS constants¶

IP_UBC_CONTROL constants¶

IP_PLDP_CONV constants¶

Parameters:	pg (GXPG) – Input model (unchanged) trim_xl (int) – Cells to remove on left trim_xr (int) – Cells to remove on right trim_z (int) – Cells to remove on the bottom vv_x (GXVV) – Column widths (modified) vv_z (GXVV) – Row heights (modified) x (float_ref) – Top left corner X (modified)
Returns:	`GXPG` Object
Return type:	GXPG