Drillholes Utils

linear_desurveying(drillholes, convention=<DipDownward.NEGATIVE: 'NEGATIVE'>)

Take assay and collar dataframes TO compute true location of points in the drillhole.

Parameters:

Name	Type	Description	Default
drillholes	DataFrame	Merged DataFrames from a drillholes dataset.	required
convention	DipDownward	Specify if downward drillholes have negative dip values.	<DipDownward.NEGATIVE: 'NEGATIVE'>

Returns:

Type	Description
DataFrame	Dataframe containing new columns with true locations of start-, mid- and end-point.

Notes

Function only works for linear drill-hole : does not work for deviated drillholes.

Formula

• $x = x_0 + depth \times sin(AZIMUTH) \times cos(DIP)$
• $y = y_0 + depth \times cos(AZIMUTH) \times cos(DIP)$
• $z = z_0 + depth \times sin(DIP)$

merge_tables(collar, intervals, survey=None, name_dictionary={'X': 'X', 'Y': 'Y', 'Z': 'Z', 'X_BEGIN': 'X_B', 'Y_BEGIN': 'Y_B', 'Z_BEGIN': 'Z_B', 'X_MID': 'X_M', 'Y_MID': 'Y_M', 'Z_MID': 'Z_M', 'X_END': 'X_E', 'Y_END': 'Y_E', 'Z_END': 'Z_E', 'DEPTH': 'DEPTH', 'FROM': 'FROM', 'TO': 'TO', 'HOLEID': 'HOLEID', 'AZIMUTH': 'AZIMUTH', 'DIP': 'DIP', 'GEOMETRY': 'geometry'})

Merge DatFrames from drillholes dataset.

Parameters:

Name	Type	Description	Default
collar	DataFrame	Collar DataFrame.	required
survey	DataFrame	Survey DataFrame.	None
intervals	Union[List[pandas.core.frame.DataFrame], pandas.core.frame.DataFrame]	DataFrame(s) of composite information (eg: geology, lithology, chemistry).	required
name_dictionary	Dict[str, str]	Correspondence table mapping names to attributes.	{'X': 'X', 'Y': 'Y', 'Z': 'Z', 'X_BEGIN': 'X_B', 'Y_BEGIN': 'Y_B', 'Z_BEGIN': 'Z_B', 'X_MID': 'X_M', 'Y_MID': 'Y_M', 'Z_MID': 'Z_M', 'X_END': 'X_E', 'Y_END': 'Y_E', 'Z_END': 'Z_E', 'DEPTH': 'DEPTH', 'FROM': 'FROM', 'TO': 'TO', 'HOLEID': 'HOLEID', 'AZIMUTH': 'AZIMUTH', 'DIP': 'DIP', 'GEOMETRY': 'geometry'}

Returns:

Type	Description
DataFrame	Merged DataFrames with all information.

Exceptions:

Type	Description
ValueError	If no HOLEID in Collar. If no X in Collar. If no Y in Collar