GXCHIMERA class¶

class GXCHIMERA(handle=0)¶

GXCHIMERA class.

GXCHIMERA GX function library.

classmethod atomic_weight(element)¶

Return the atomic weight of a particular element.

Parameters:	element (str) – Element name (case insensitive)
Returns:	The atomic weight of the given element.
Return type:	float

New in version 6.4.2.

License: Geosoft Extended End-User License

Note: If the input string is not an element symbol (elements in the range 1-92, “H” to “U”), then returns a dummy (GS_R8DM).

classmethod bar_plot(mview, data_group, offset_group, xvv, yvv, dvv, cvv, col, offset, offset_size, width)¶

Plot a Bar plot of up to 8 channels.

Parameters:

mview (GXMVIEW) – View object to plot to
data_group (str) – Data group name
offset_group (str) – Offset group name
xvv (GXVV) – X locations
yvv (GXVV) – Y locations
dvv (GXVV) – Data handles, stored as INT values
cvv (GXVV) – Colors
col (int) – Color for edges
offset (int) – Offset symbols (0: No, 1: Yes)
offset_size (float) – Offset symbol size
width (float) – Single bar width in data units.

New in version 5.0.7.

License: Geosoft Extended End-User License

Note: The number of channels is taken from the Data handles GXVV. Plots a bar plot with the center of the “X” axis at the symbol location. See the note on offset symbols in rose_plot

classmethod categorize_by_value(vv_r, vv_i, vv_o)¶

Transform values to the index of input data ranges.

Parameters:	vv_r (GXVV) – Input range minima vv_i (GXVV) – Input data `GXVV`. (REAL) vv_o (GXVV) – Output (altered) `GXVV`.(REAL)

New in version 6.1.

License: Geosoft Extended End-User License

Note: A list of minima (e.g. M1, M2, M3, M4, M5) is input. A list of values V is input and transformed to outputs N in the following manner:

if(V) >= M5) N = 5 else if(V) >= M4) N = 4 ... ... else if(V) >= M1) N = 1 else N = 0

classmethod categorize_by_value_det_limit(vv_r, vv_i, det_limit, vv_o)¶

Transform values to the index of input data ranges, with detection limit.

Parameters:	vv_r (GXVV) – Input range minima vv_i (GXVV) – Input data `GXVV`. (REAL) det_limit (float) – Detection limit (can be `rDUMMY`) vv_o (GXVV) – Output (altered) `GXVV`.(REAL)

New in version 6.2.

License: Geosoft Extended End-User License

Note: Same as categorize_by_value, but if the input value is less than the detection limit, the output value is set to zero.

classmethod clip_to_detect_limit(vv, det_limit, conv)¶

Apply detection limit clipping of data.

Parameters:	vv (GXVV) – Input data vv (altered). det_limit (float) – Detection limit conv (int) – Auto-convert negatives?

New in version 5.0.8.

License: Geosoft Extended End-User License

Note: Flow:

If auto-converting negatives, then all negative values

are replaced by -0.5*value, and detection limit is ignored.
If not auto-converting negatives, and the detection limit is not rDUMMY, then values less than the detection limit are converted to one-half the detection limit.

classmethod draw_circle_offset_markers(mview, vv_xi, vv_yi, vv_xo, vv_yo, off_size)¶

Plots location marker and joining line for circle offset symbols

Parameters:	mview (GXMVIEW) – View vv_xi (GXVV) – Original (marker) X location vv_yi (GXVV) – Original (marker) Y location vv_xo (GXVV) – Offset (new) X location vv_yo (GXVV) – Offset (new) Y location off_size (float) – Marker symbol radius

New in version 5.0.7.

License: Geosoft Extended End-User License

Note: Draws black filled circle (symbols.gfn #7) and a joining line.

classmethod draw_rectangle_offset_markers(mview, vv_xi, vv_yi, vv_xo, vv_yo, off_size, x_size, y_size)¶

Plots location marker and joining line for rectangle offset symbols

Parameters:	mview (GXMVIEW) – View vv_xi (GXVV) – Original (marker) X location vv_yi (GXVV) – Original (marker) Y location vv_xo (GXVV) – Offset (new) X location vv_yo (GXVV) – Offset (new) Y location off_size (float) – Offset symbol width x_size (float) – Offset symbol height y_size (float) – Marker symbol radius

New in version 5.0.7.

License: Geosoft Extended End-User License

Note: Draws black filled circle (symbols.gfn #7) and a joining line.

classmethod duplicate_chem(mview, vv, log, det_lim, old, vv_tol, title, unit, x0, y0, xs, ys)¶

Plot an ASSAY Duplicate result in a graph window.

Parameters:

mview (GXMVIEW) – View
vv (GXVV) – Duplicate data
log (int) – Log-transform: 0 - linear, 1 - log
det_lim (float) – Detect Limit
old (int) – Number of old samples in the GXVV
vv_tol (GXVV) – Tolerances (1-5 values)
title (str) – Title
unit (str) – Unit
x0 (float) – X location (bottom left corner of graph)
y0 (float) – Y location
xs (float) – Graph width
ys (float) – Graph height

New in version 5.0.7.

License: Geosoft Extended End-User License

classmethod duplicate_chem_view(map, view, group, ipj, vv, log, det_lim, old, vv_tol, title, unit, vvx, vv_line, vv_fid, db, min_y, max_y)¶

Plot an ASSAY Duplicate result in a new view.

Parameters:

map (GXMAP) – Map
view (str) – New view name
group (str) – New group name
vv (GXVV) – Duplicate data
log (int) – Log-transform: 0 - linear, 1 - log
det_lim (float) – Detect Limit
old (int) – Number of old samples in the GXVV
vv_tol (GXVV) – Tolerances (1-5 values)
title (str) – Title
unit (str) – Unit
vvx (GXVV) – GXVV X
vv_line (GXVV) – GXVV Line
vv_fid (GXVV) – GXVV Fid
db (GXDB) – Database
min_y (float_ref) – Returned MinY
max_y (float_ref) – Returned MaxY

New in version 8.3.

License: Geosoft Extended End-User License

classmethod fixed_symbol_scatter_plot(mview, title, x1, y1, width, height, x_vv, y_vv, m_vv, mask_col, symbol_font, symbol_number, symbol_size, symbol_angle, symbol_color, symbol_fill, db, line_vv, fid_vv, annotn, x_chan, y_chan, x_units, y_units, x_min, x_max, y_min, y_max, x_lin, y_lin, overlay)¶

Plot a scatter plot using a single fixed symbol. Optional data masking with masking Color. Optional database linking.

Parameters:

mview (GXMVIEW) – View
title (str) – Title
x1 (float) – X location (bottom left corner of box)
y1 (float) – Y location
width (float) – Box width
height (float) – Box height
x_vv (GXVV) – Horizontal channel data
y_vv (GXVV) – Vertical channel data
m_vv (GXVV) – Mask channel data (can be NULL)
mask_col (int) – Mask Color; overrides symbol Color where mask data is not dummy. Pass an empty string to GXMVIEW.color for no plot.
symbol_font (str) – Decorated font name, “” for default symbol font (normally symbols.gfn)
symbol_number (int) – Symbol number (>=0)
symbol_size (float) – Symbol size ( >=0)
symbol_angle (float) – Symbol angle (-360 to 360)
symbol_color (int) – Symbol Color
symbol_fill (int) – Symbol fill Color
db (GXDB) – Database (source of data)
line_vv (GXVV) – Line handles for data
fid_vv (GXVV) – Fid values for data
annotn (int) – Annotation style 0 - outside, 1 - inside
x_chan (str) – Horizontal channel name
y_chan (str) – Vertical channel name
x_units (str) – Horizontal channel units
y_units (str) – Vertical channel units
x_min (float) – Min. Horizontal value, rDUMMY for default
x_max (float) – Max. Horizontal value
y_min (float) – Min. Vertical value
y_max (float) – Max. Vertical value
x_lin (int) – Horizontal axis scaling: 0 - linear, 1 - log
y_lin (int) – Vertical axis scaling
overlay (str) – Plot overlay (“” for none)

New in version 8.0.1.

License: Geosoft Extended End-User License

Note: Plot a scatter plot using a single fixed symbol.

classmethod fixed_symbol_tri_plot(mview, title, x1, y1, side, x_vv, y_vv, z_vv, m_vv, mask_col, symbol_font, symbol_number, symbol_size, symbol_angle, symbol_color, symbol_fill, db, line_vv, fid_vv, x_chan, y_chan, z_chan, grid, tic, grid_inc, overlay)¶

Plot a tri-plot using a single fixed symbol. Optional data masking with masking color. Optional database linking.

Parameters:

mview (GXMVIEW) – View
title (str) – Title
x1 (float) – X location (bottom left corner of box)
y1 (float) – Y location
side (float) – Triangle side length
x_vv (GXVV) – X channel data
y_vv (GXVV) – Y channel data
z_vv (GXVV) – Z channel data
m_vv (GXVV) – Mask channel data
mask_col (int) – Mask color; overrides symbol color where mask data is not dummy. Pass an empty string to GXMVIEW.color for no plot.
symbol_font (str) – Decorated font name, “” for default symbol font (normally symbols.gfn)
symbol_number (int) – Symbol number (>=0)
symbol_size (float) – Symbol size ( >=0)
symbol_angle (float) – Symbol angle (-360 to 360)
symbol_color (int) – Symbol color
symbol_fill (int) – Symbol fill color
db (GXDB) – Database (source of data)
line_vv (GXVV) – Line handles for data
fid_vv (GXVV) – Fid values for data
x_chan (str) – X channel name
y_chan (str) – Y channel name
z_chan (str) – Z channel name
grid (int) – Plot Grid lines? (0: Just outside edge tics, 1: Grid lines).
tic (float) – Tic Increment (in percent)
grid_inc (float) – Grid increment (in percent)
overlay (str) – Plot overlay (“” for none)

New in version 8.0.1.

License: Geosoft Extended End-User License

Note: Plot a tri plot using a single fixed symbol.

classmethod get_expression_data_vv(db, line, stage, exp, ini, gvv)¶

Get data from a line using a channel expression.

Parameters:	db (GXDB) – Database line (int) – Line to read stage (str) – Geochem stage (just “raw data stage” for now). exp (str) – Channel expression ini (str) – INI file name with required units (e.g. PARAMETER.CU=”ppm”) (optional) gvv (GXVV) – Returned data

New in version 6.4.

License: Geosoft Extended End-User License

Note: Input a channel expression. Units for individual channels are stored in the input INI. Returns a GXVV for the given line with the calculated expression values.

classmethod get_lithogeochem_data(db, lst, m_ch, vv_trans, remove_dummy_rows, vv_dummy, warn, vv_d, vv_line, vv_n, vv_used, vv_index, vv_fids, vv_fidi)¶

Get all rows of non-dummy data in a database.

Parameters:

db (GXDB) – [i] database handle
lst (GXLST) – [i] channels of data to get
m_ch (int) – [i] mask channel (can be NULLSYMB)
vv_trans (GXVV) – [i] transforms to apply
remove_dummy_rows (int) – [i] remove dummy rows?
vv_dummy (GXVV) – [i] dummy row if this channel value is dummy (0:No, 1:Yes)? Effective only if “remove dummy rows” value is TRUE
warn (int) – [i] warn if rows removed because of dummy data items?
vv_d (GXVV) – [o] (INT) returned data - one GXVV handle per channel
vv_line (GXVV) – [o] line symbols selected
vv_n (GXVV) – [o] number of original data items in each line
vv_used (GXVV) – [o] number of non-dummy rows
vv_index (GXVV) – [o] indices into original data
vv_fids (GXVV) – [o] Fid Starts (REAL)
vv_fidi (GXVV) – [o] Fid Increments (REAL)

New in version 6.2.

License: Geosoft Extended End-User License

Note: This function is a quick way to get all rows of data, guaranteeing no dummy items. Book-keeping VVs returned let you easily write back results to new channels in the correct locations. Set the “Dummy Row” GXVV to 1 if you wish to remove any row where a value for the corresponding channel is a dummy.

Transforms to apply:

-1 - Channel default (will be either raw or log) 0 - Raw Transform 1 - Log transform: base e with log min = CHIMERA_LOG_MIN 2 - Lambda transform

classmethod get_transform(db, chan, trans_opt, trans, lda)¶

Get channel transform options and lambda values.

Parameters:	db (GXDB) – `GXDB` handle chan (str) – Channel name trans_opt (int) – Transform option: -1, 0, 1 or 2 trans (int_ref) – Returned transform used lda (float_ref) – Returned lambda value for option==2

New in version 6.2.

License: Geosoft Extended End-User License

Note: If the lambda transform is requested, the channel must have the lambda value defined.

Input Transform options

-1 - Channel default (will be either raw or log) 0 - Raw Transform 1 - Log transform: base e with log min = CHIMERA_LOG_MIN 2 - Lambda transform

classmethod is_acquire_chan(input_chan, chan, units, factor, oxide)¶

Is this channel in acQuire format (e.g. “Ag_ppm_4AWR”)

Parameters:	input_chan (str) – String to test chan (str_ref) – Returned channel name units (str_ref) – Returned units factor (float_ref) – Buffer factor (e.g. ppm = 1.e-6) oxide (bool_ref) – is this an oxide?
Return type:	bool

New in version 7.2.

License: Geosoft Extended End-User License

Note: Expressions can take acQuire-type named channels if the exact element/oxide is not found. This function extracts the channel name, and units from an acQuire-formatted channel name.

classmethod is_element(chan, case)¶

Tests a string to see if it is an element symbol

Parameters:	chan (str) – String to test case (int) – STR_CASE constants
Return type:	bool

New in version 5.0.7.

License: Geosoft Extended End-User License

Note: Suggested use - testing to see if a channel name is an element so that the “ASSAY” class can be set.

is_null()¶

Check if this is a null (undefined) instance

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

classmethod launch_histogram(db, chan)¶

Launch histogram tool on a database.

Parameters:	db (str) – Database name chan (str) – First chan name

New in version 5.0.6.

License: Geosoft Extended End-User License

Note: The database should be a currently open database. This function supercedes GXEDB.launch_histogram, (which now just gets the name of the GXEDB and calls this function).

classmethod launch_probability(db, chan)¶

Launch probability tool on a database.

Parameters:	db (str) – Database name chan (str) – First chan name

New in version 5.1.8.

License: Geosoft Extended End-User License

Note: The database should be a currently open database.

classmethod launch_scatter(db)¶

Launch scatter tool on a database.

Parameters:	db (str) – Database name

New in version 5.0.6.

License: Geosoft Extended End-User License

Note: The scatter tool uses the following INI parameters

SCATTER.STM	name of the scatter template, “none” for none
SCATTER.STM_NAME	name of last template section, “” for none.
SCATTER.X	name of channel to display in X
SCATTER.Y	name of channel to display in Y
SCATTER.MASK	name of channel to use for mask

The database should be a currently open database. This function supercedes GXEDB.launch_scatter, (which now just gets the name of the GXEDB and calls this function).

classmethod launch_triplot(db)¶

Launch Triplot tool on a database.

Parameters:	db (str) – Database name

New in version 5.0.7.

License: Geosoft Extended End-User License

Note: The Triplot tool uses the following INI parameters

TRIPLOT.TTM	name of the triplot template, “none” for none
TRIPLOT.TTM_NAME	name of last template section, “” for none.
TRIPLOT.X	name of channel to display in X
TRIPLOT.Y	name of channel to display in Y
TRIPLOT.Z	name of channel to display in Z
TRIPLOT.MASK	name of channel to use for mask

The database should be a currently open database.

classmethod mask_chan_lst(db, lst)¶

Load a GXLST with mask channels.

Parameters:	db (GXDB) – hDB - Database Object lst (GXLST) – `GXLST` object to populate

New in version 5.0.7.

License: Geosoft Extended End-User License

Note: Loads a GXLST with all channels with CLASS “MASK”, as well as all channels containing the string “MASK”, as long as the CLASS for these channels is not set to something other than “” or “MASK”.

This function has been duplicated by GXDB.mask_chan_lst, which is safe to use in applications which do not have GXCHIMERA loaded.

classmethod null()¶

A null (undefined) instance of GXCHIMERA

Returns:	A null `GXCHIMERA`
Return type:	GXCHIMERA

classmethod ordered_channel_lst(db, lst)¶

Fill a list with the channels in the preferred order.

Parameters:	db (GXDB) – hDB - Database Object lst (GXLST) – `GXLST` object to populate [recommended 2*`STR_DB_SYMBOL <geosoft.gxapi.STR_DB_SYMBOL>`]

New in version 5.1.8.

License: Geosoft Extended End-User License

Note: Loads a GXLST with all channels in the preferred order:

First: Sample, E, N, assay channels, Middle: Data from survey (other channels), Last: Duplicate, Standard, Chemmask (and other masks), weight, lab, batch

If the input GXLST object has values, it is used as the channel GXLST, otherwise, get all the database channels. (This allows you to pass in the currently displayed channels and only reload those).

classmethod pie_plot(mview, data_group, offset_group, xvv, yvv, dvv, cvv, col, offset, offset_size, radius)¶

Plot a Pie plot of up to 8 channels.

Parameters:

mview (GXMVIEW) – View object to plot to
data_group (str) – Data group name
offset_group (str) – Offset group name
xvv (GXVV) – X locations
yvv (GXVV) – Y locations
dvv (GXVV) – Data handles, stored as INT values
cvv (GXVV) – Colors
col (int) – Color for edges
offset (int) – Offset symbols (0: No, 1: Yes)
offset_size (float) – Offset symbol size
radius (float) – Pie plot radius in data units.

New in version 5.0.7.

License: Geosoft Extended End-User License

Note: The number of channels is taken from the Data handles GXVV. The values in each data GXVV are summed and the pie arc is is given by the percent contribution of each constituent. See the note on offset symbols in rose_plot

classmethod pie_plot2(mview, data_group, offset_group, xvv, yvv, dvv, cvv, col, offset, offset_size, radius, start_angle)¶

Same as pie_plot, with a starting angle.

Parameters:

mview (GXMVIEW) – View object to plot to
data_group (str) – Data group name
offset_group (str) – Offset group name
xvv (GXVV) – X locations
yvv (GXVV) – Y locations
dvv (GXVV) – Data handles, stored as INT values
cvv (GXVV) – Colors
col (int) – Color for edges
offset (int) – Offset symbols (0: No, 1: Yes)
offset_size (float) – Offset symbol size
radius (float) – Pie plot radius in data units.
start_angle (float) – Starting angle in degrees CCW from horizontal (rDUMMY gives 0.0)

New in version 5.1.5.

License: Geosoft Extended End-User License

Note: The starting angle is the location of the edge of the first pie slice, counted in degrees counter-clockwise from horizontal (3 o’clock). Zero degrees gives the same plot as pie_plot.

classmethod plot_string_classified_symbols_legend_from_class_file(mview, title, x, y_min, y_max, class_file, index_vv)¶

Plot legend for the string classified symbols

Parameters:	mview (GXMVIEW) – Map view object title (str) – Title x (float) – Left side X location y_min (float) – Bottom Y bound y_max (float) – Top Y bound class_file (str) – Class file name (`GXTPAT`) index_vv (GXVV) – Class indices (INT `GXVV`)

New in version 8.0.1.

License: Geosoft Extended End-User License

Note: Plot in a legend the classes in the class file found in the input class indices.

classmethod rose_plot(mview, data_group, offset_group, xvv, yvv, dvv, cvv, col, offset, offset_size)¶

Plot a Rose plot of up to 8 channels.

Parameters:

mview (GXMVIEW) – View object to plot to
data_group (str) – Data group name
offset_group (str) – Offset group name
xvv (GXVV) – X locations
yvv (GXVV) – Y locations
dvv (GXVV) – Data handles, stored as INT values
cvv (GXVV) – Colors
col (int) – Color for edges
offset (int) – Offset symbols (0: No, 1: Yes)
offset_size (float) – Offset symbol size

New in version 5.0.7.

License: Geosoft Extended End-User License

Note: The number of channels is taken from the Data handles GXVV. The values in each data GXVV give the radius, in view units, of the sector arc to plots. Values <=0 or dummies are not plotted.

Offset symbols: When selected, the symbols plot without overlap, away from the original locations. The original location is marked with a small symbol and a line joins the original position and the relocated symbol. Care should be taken when choosing the symbol size, because if the point density is too high, all the points will get pushed to the outside edge and your plot will look like a hedgehog (it also takes a lot longer!).

classmethod rose_plot2(mview, data_group, offset_group, xvv, yvv, dvv, cvv, col, offset, offset_size, start_angle)¶

Same as rose_plot, with a starting angle.

Parameters:

mview (GXMVIEW) – View object to plot to
data_group (str) – Data group name
offset_group (str) – Offset group name
xvv (GXVV) – X locations
yvv (GXVV) – Y locations
dvv (GXVV) – Data handles, stored as INT values
cvv (GXVV) – Colors
col (int) – Color for edges
offset (int) – Offset symbols (0: No, 1: Yes)
offset_size (float) – Offset symbol size
start_angle (float) – Starting angle in degrees CCW from horizontal (rDUMMY gives 0.0)

New in version 5.1.5.

License: Geosoft Extended End-User License

Note: The starting angle is the location of the edge of the first pie slice, counted in degrees counter-clockwise from horizontal (3 o’clock). Zero degrees gives the same plot as rose_plot.

classmethod scatter2(mview, title, x1, y1, width, height, horz_vv, vert_vv, sym_font, sym_num_vv, sym_siz_vv, sym_col_vv, annot_style, h_chan, v_chan, h_units, v_units, h_min, h_max, v_min, v_max, hr_min, hr_max, vr_min, vr_max, use_hr_min, use_hr_max, use_vr_min, use_vr_max, h_scaling, v_scaling)¶

Plot the scatter plot on a map using symbol number, size and color VVs.

Parameters:

mview (GXMVIEW) – View
title (str) – Title
x1 (float) – X location (bottom left corner of box)
y1 (float) – Y location
width (float) – Box width
height (float) – Box height
horz_vv (GXVV) – Horizontal channel
vert_vv (GXVV) – Vertical channel
sym_font (str) – Decorated font name, “” for default symbol font (normally symbols.gfn)
sym_num_vv (GXVV) – Symbol numbers
sym_siz_vv (GXVV) – Symbol sizes
sym_col_vv (GXVV) – Colors if symbol number or Color == 0, do not plot
annot_style (int) – Annotation style 0 - outside, 1 - inside
h_chan (str) – Horizontal channel name
v_chan (str) – Vertical channel name
h_units (str) – Horizontal channel units
v_units (str) – Vertical channel units
h_min (float) – Min. Horizontal value, rDUMMY for default
h_max (float) – Max. Horizontal value
v_min (float) – Min. Vertical value
v_max (float) – Max. Vertical value
hr_min (float) – Min. Horizontal range value
hr_max (float) – Max. Horizontal range value
vr_min (float) – Min. Vertical range value
vr_max (float) – Max. Vertical range value
use_hr_min (int) – Use Min Horz. Range selection?
use_hr_max (int) – Use Max Horz. Range selection?
use_vr_min (int) – Use Min Vert. Range selection?
use_vr_max (int) – Use Max Vert. Range selection?
h_scaling (int) – Horizontal axis scaling: 0 - linear, 1 - log
v_scaling (int) – Vertical axis scaling: 0 - linear, 1 - log

New in version 5.0.7.

License: Geosoft Extended End-User License

Note: The view scaling is not altered with any projection. The base view is best as the input.

classmethod set_lithogeochem_data(db, lst, vv_d, vv_line, vv_n, vv_used, vv_index, vv_fids, vv_fidi, vv_dummy)¶

Set data back into a database.

Parameters:

db (GXDB) – [i] database handle
lst (GXLST) – [i] channels of data to set
vv_d (GXVV) – [i] (INT) input data - one GXVV handle per channel
vv_line (GXVV) – [i] line symbols selected
vv_n (GXVV) – [i] number of original data items in each line
vv_used (GXVV) – [i] number of non-dummy rows
vv_index (GXVV) – [i] indices into original data
vv_fids (GXVV) – [i] Fid Starts (REAL)
vv_fidi (GXVV) – [i] Fid Increments (REAL)
vv_dummy (GXVV) – [i] init channel values to dummies first (0:No, 1:Yes)?

New in version 6.2.

License: Geosoft Extended End-User License

Note: This function would normally be called after AAGetLithogeochemData_CHIMERA to write processed values back into a database, in the correct lines, and in the correct fiducial locations wrt the other data. The book-keeping VVs would all be set up in AAGetLithogeochemData_CHIMERA.

Values NOT in the data (missing indices) will be initialized to dummy if the channel is new, or if the value in the last GXVV below is set to 1.

New channel types will be set using the data GXVV type. Any metadata (CLASS, display formats) should be set separately.

classmethod stacked_bar_plot(mview, data_group, offset_group, xvv, yvv, dvv, cvv, col, offset, offset_size, width)¶

Plot a Bar plot of up to 8 channels, bars stacked on each other.

Parameters:

mview (GXMVIEW) – View object to plot to
data_group (str) – Data group name
offset_group (str) – Offset group name
xvv (GXVV) – X locations
yvv (GXVV) – Y locations
dvv (GXVV) – Data handles, stored as INT values
cvv (GXVV) – Colors
col (int) – Color for edges
offset (int) – Offset symbols (0: No, 1: Yes)
offset_size (float) – Offset symbol size
width (float) – Single bar width in data units.

New in version 5.1.8.

License: Geosoft Extended End-User License

Note: The number of channels is taken from the Data handles GXVV. Plots a bar plot with the center of the “X” axis at the symbol location. See the note on offset symbols in rose_plot

classmethod standard(mview, vv, old, tol, min, max, title, unit, x0, y0, xs, ys)¶

Plot ASSAY Standard result in a graph window.

Parameters:

mview (GXMVIEW) – View
vv (GXVV) – Standard data
old (int) – Number of old samples in the GXVV
tol (float) – Tolerance as a function of std dev
min (float) – Minimum acceptable value
max (float) – Maximum acceptable value
title (str) – Title
unit (str) – Unit
x0 (float) – X location (bottom left corner of graph)
y0 (float) – Y location
xs (float) – Graph width
ys (float) – Graph height

New in version 5.0.7.

License: Geosoft Extended End-User License

Note: If the tolerance is rDUMMY, then the minimum and maximum values are used, and must be specified.

classmethod standard_view(map, view, group, ipj, vvy, old, tol, min, max, title, unit, xs, vvx, vv_line, vv_fid, db, min_y, max_y)¶

Plot ASSAY Standard result in a graph window.

Parameters:

map (GXMAP) – Map
view (str) – New view name
group (str) – New group name
vvy (GXVV) – Standard data (GXVV Y)
old (int) – Number of old samples in the GXVV
tol (float) – Tolerance as a function of std dev
min (float) – Minimum acceptable value
max (float) – Maximum acceptable value
title (str) – Title
unit (str) – Unit
xs (float) – Size X
vvx (GXVV) – GXVV X
vv_line (GXVV) – GXVV Line
vv_fid (GXVV) – GXVV Fid
db (GXDB) – Database
min_y (float_ref) – Returned MinY
max_y (float_ref) – Returned MaxY

New in version 8.3.

License: Geosoft Extended End-User License

Note: Same as standard but plot in a new view.

classmethod string_classified_scatter_plot(mview, title, x1, y1, width, height, x_vv, y_vv, m_vv, mask_col, class_vv, class_file, symbol_size_override, db, line_vv, fid_vv, annotn, x_chan, y_chan, x_units, y_units, x_min, x_max, y_min, y_max, x_lin, y_lin, overlay)¶

Plot a scatter plot using symbols based on a symbol class file. Optional data masking with masking color. Optional database linking.

Parameters:

mview (GXMVIEW) – View
title (str) – Title
x1 (float) – X location (bottom left corner of box)
y1 (float) – Y location
width (float) – Box width
height (float) – Box height
x_vv (GXVV) – Horizontal channel data
y_vv (GXVV) – Vertical channel data
m_vv (GXVV) – Mask channel data
mask_col (int) – Mask color; overrides symbol color. Pass an empty string to GXMVIEW.color for no plot.
class_vv (GXVV) – Class channel data
class_file (str) – Class file (GXTPAT) name.
symbol_size_override (float) – Symbol size override. Set to 0.0 to use class file symbol sizes.
db (GXDB) – Database (source of data)
line_vv (GXVV) – Line handles for data
fid_vv (GXVV) – Fid values for data
annotn (int) – Annotation style 0 - outside, 1 - inside
x_chan (str) – Horizontal channel name
y_chan (str) – Vertical channel name
x_units (str) – Horizontal channel units
y_units (str) – Vertical channel units
x_min (float) – Min. Horizontal value, rDUMMY for default
x_max (float) – Max. Horizontal value
y_min (float) – Min. Vertical value
y_max (float) – Max. Vertical value
x_lin (int) – Horizontal axis scaling: 0 - linear, 1 - log
y_lin (int) – Vertical axis scaling
overlay (str) – Plot overlay (“” for none)

New in version 8.0.1.

License: Geosoft Extended End-User License

Note: Plot a scatter plot using symbols based on a symbol class file.

classmethod string_classified_tri_plot(mview, title, x1, y1, side, x_vv, y_vv, z_vv, m_vv, mask_col, class_vv, class_file, symbol_size_override, db, line_vv, fid_vv, x_chan, y_chan, z_chan, grid, tic, grid_inc, overlay)¶

Plot a tri-plot using symbols based on a symbol class file. Optional data masking with masking color. Optional database linking.

Parameters:

mview (GXMVIEW) – View
title (str) – Title
x1 (float) – X location (bottom left corner of box)
y1 (float) – Y location
side (float) – Triangle side length
x_vv (GXVV) – X channel data
y_vv (GXVV) – Y channel data
z_vv (GXVV) – Z channel data
m_vv (GXVV) – Mask channel data
mask_col (int) – Mask color; overrides symbol color. Pass an empty string to GXMVIEW.color for no plot.
class_vv (GXVV) – Class channel data
class_file (str) – Class file (GXTPAT) name.
symbol_size_override (float) – Symbol size override. Set to 0.0 to use class file symbol sizes.
db (GXDB) – Database (source of data)
line_vv (GXVV) – Line handles for data
fid_vv (GXVV) – Fid values for data
x_chan (str) – X channel name
y_chan (str) – Y channel name
z_chan (str) – Z channel name
grid (int) – Plot Grid lines? (0: Just outside edge tics, 1: Grid lines).
tic (float) – Tic Increment (in percent)
grid_inc (float) – Grid increment (in percent)
overlay (str) – Plot overlay (“” for none)

New in version 8.0.1.

License: Geosoft Extended End-User License

Note: Plot a tri-plot using symbols based on a symbol class file.

classmethod tri_plot2(mview, title, x1, y1, width, height, x_vv, y_vv, z_vv, m_vv, sym_font, sym_num_vv, sym_siz_vv, sym_col_vv, x_chan, y_chan, z_chan, xr_min, xr_max, yr_min, yr_max, zr_min, zr_max, use_xr_min, use_xr_max, use_yr_min, use_yr_max, use_zr_min, use_zr_max, grid, tic, grid_inc)¶

Plot the TriPlot on a map using symbol number, size and color VVs.

Parameters:

mview (GXMVIEW) – View
title (str) – Title
x1 (float) – X location (bottom left corner of box)
y1 (float) – Y location
width (float) – Box width
height (float) – Box height
x_vv (GXVV) – X channel
y_vv (GXVV) – Y channel
z_vv (GXVV) – Z channel
m_vv (GXVV) – Mask channel
sym_font (str) – Decorated font name, “” for default symbol font (normally symbols.gfn)
sym_num_vv (GXVV) – Symbol numbers
sym_siz_vv (GXVV) – Symbol sizes
sym_col_vv (GXVV) – Colors if symbol number or color == 0, do not plot
x_chan (str) – X channel name
y_chan (str) – Y channel name
z_chan (str) – Z channel name
xr_min (float) – Min. X range value
xr_max (float) – Max. X range value
yr_min (float) – Min. Y range value
yr_max (float) – Max. Y range value
zr_min (float) – Min. Z range value
zr_max (float) – Max. Z range value
use_xr_min (int) – Use Min X Range selection?
use_xr_max (int) – Use Max X Range selection?
use_yr_min (int) – Use Min Y Range selection?
use_yr_max (int) – Use Max Y Range selection?
use_zr_min (int) – Use Min Z Range selection?
use_zr_max (int) – Use Max Z Range selection?
grid (int) – Plot Grid lines? (0: Just outside edge tics, 1: Grid lines).
tic (float) – Tic Increment (in percent)
grid_inc (float) – Grid increment (in percent)

New in version 5.1.6.

License: Geosoft Extended End-User License

Note: The mask channel GXVV is used for plotting precedence; those points with mask = dummy are plotted first, then overwritten with the non-masked values, so you don’t get “good” points being covered up by masked values. The view scaling is not altered with any projection. The base view is best as the input.

classmethod zone_coloured_scatter_plot(mview, title, x1, y1, width, height, x_vv, y_vv, m_vv, mask_col, zone_data_vv, zone_file, symbol_font, symbol_number, symbol_size, symbol_angle, symbol_color, symbol_fill, fix_edge_color, db, line_vv, fid_vv, annotn, x_chan, y_chan, x_units, y_units, x_min, x_max, y_min, y_max, x_lin, y_lin, overlay)¶

Plot a scatter plot using colors based on a zone file. Optional data masking with masking color. Optional database linking.

Parameters:

mview (GXMVIEW) – View
title (str) – Title
x1 (float) – X location (bottom left corner of box)
y1 (float) – Y location
width (float) – Box width
height (float) – Box height
x_vv (GXVV) – Horizontal channel data
y_vv (GXVV) – Vertical channel data
m_vv (GXVV) – Mask channel data (can be NULL)
mask_col (int) – Mask color; overrides symbol color where mask data is not dummy. Pass an empty string to GXMVIEW.color for no plot.
zone_data_vv (GXVV) – Zone channel data
zone_file (str) – Zone file name
symbol_font (str) – Decorated font name, “” for default symbol font (normally symbols.gfn)
symbol_number (int) – Symbol number (>=0)
symbol_size (float) – Symbol size ( >=0)
symbol_angle (float) – Symbol angle (-360 to 360)
symbol_color (int) – Symbol color
symbol_fill (int) – Symbol fill color
fix_edge_color (int) – Fix symbol edge color?
db (GXDB) – Database (source of data)
line_vv (GXVV) – Line handles for data
fid_vv (GXVV) – Fid values for data
annotn (int) – Annotation style 0 - outside, 1 - inside
x_chan (str) – Horizontal channel name
y_chan (str) – Vertical channel name
x_units (str) – Horizontal channel units
y_units (str) – Vertical channel units
x_min (float) – Min. Horizontal value, rDUMMY for default
x_max (float) – Max. Horizontal value
y_min (float) – Min. Vertical value
y_max (float) – Max. Vertical value
x_lin (int) – Horizontal axis scaling: 0 - linear, 1 - log
y_lin (int) – Vertical axis scaling
overlay (str) – Plot overlay (“” for none)

New in version 8.0.1.

License: Geosoft Extended End-User License

Note: Plot a scatter plot using colors based on a zone file.

classmethod zone_coloured_tri_plot(mview, title, x1, y1, side, x_vv, y_vv, z_vv, m_vv, mask_col, zone_data_vv, zone_file, symbol_font, symbol_number, symbol_size, symbol_angle, symbol_color, symbol_fill, fix_edge_color, db, line_vv, fid_vv, x_chan, y_chan, z_chan, grid, tic, grid_inc, overlay)¶

Plot a tri-plot using colors based on a zone file. Optional data masking with masking color. Optional database linking.

Parameters:

mview (GXMVIEW) – View
title (str) – Title
x1 (float) – X location (bottom left corner of box)
y1 (float) – Y location
side (float) – Triangle side length
x_vv (GXVV) – X channel data
y_vv (GXVV) – Y channel data
z_vv (GXVV) – Z channel data
m_vv (GXVV) – Mask channel data
mask_col (int) – Mask color; overrides symbol color where mask data is not dummy. Pass an empty string to GXMVIEW.color for no plot.
zone_data_vv (GXVV) – Zone channel data
zone_file (str) – Zone file name
symbol_font (str) – Decorated font name, “” for default symbol font (normally symbols.gfn)
symbol_number (int) – Symbol number (>=0)
symbol_size (float) – Symbol size ( >=0)
symbol_angle (float) – Symbol angle (-360 to 360)
symbol_color (int) – Symbol color
symbol_fill (int) – Symbol fill color
fix_edge_color (int) – Fix symbol edge color?
db (GXDB) – Database (source of data)
line_vv (GXVV) – Line handles for data
fid_vv (GXVV) – Fid values for data
x_chan (str) – X channel name
y_chan (str) – Y channel name
z_chan (str) – Z channel name
grid (int) – Plot Grid lines? (0: Just outside edge tics, 1: Grid lines).
tic (float) – Tic Increment (in percent)
grid_inc (float) – Grid increment (in percent)
overlay (str) – Plot overlay (“” for none)

New in version 8.0.1.

License: Geosoft Extended End-User License

Note: Plot a tri plot using colors based on a zone file.

CHIMERA_MAX_CHAN constants¶

Maximum channels in Chimera database

CHIMERA_MAX_CHAN¶

Chimera max chan

gxapi.CHIMERA_MAX_CHAN = 128

CHIMERA_PLOT constants¶

Chimera plot type

CHIMERA_PLOT_ROSE¶

Rose

gxapi.CHIMERA_PLOT_ROSE = 0

CHIMERA_PLOT_PIE¶

Pie

gxapi.CHIMERA_PLOT_PIE = 1

CHIMERA_PLOT_BAR¶

Bar

gxapi.CHIMERA_PLOT_BAR = 2

Table Of Contents

This Page

GXCHIMERA class¶

CHIMERA_MAX_CHAN constants¶

CHIMERA_PLOT constants¶