class watex.geology.drilling.Borehole(lat=None, lon=None, area=None, status=None, depth=None, base_depth=None, geol=None, staticlevel=None, airlift=None, id=None, qmax=None, **kwds)[source]#

Bases: Geology

Focused on Wells and Borehole offered to the population. To use the data for prediction purpose, each Borehole provided must be referenced on coordinates values or provided the same as the one used on ves or erp file.

fit(data)[source]#

Fit Borehole data and populate the corrsponding attributes

class watex.geology.drilling.Drill(well_filename=None, auto=True, **kwargs)[source]#

Bases: Geology

This class is focus on well logs . How to generate well Log for Oasis:

Parameters:

  • **well_filename** (string ,) – The well filename. 02 options is set : 1rst option is to build well data manually and the program will generate a report. 2nd option is to send to the program a typical file type to be parsed . the programm parses only the typical well datafile. If None , the program will redirect to build mannually option .

  • **auto** (bool) –

    option to automatically well data . set to True

    if you want to build manually a well data .

    default is False

  • ========================================= (==================== ==========) –

  • Description (Key Words/Attributes Type) –

  • ========================================= –

  • S. (utm_zone str utm WGS84 zone. should be N or) – default is 49N .

  • provided. (compute_azimuth bool if no azimuth is) – set to True to letprogram to compute azimuth .*Default* is False.

  • 90 (Drill_dip float The dip of drill hole.*default* is) –

  • drill (Drill_buttom float The average bottom of) – can be filled during the well buiding . default is None

:paramcan be filled during the well

buiding . default is None

Parameters:

  • data. (mask int the mask of DrillHole(DH)) – *Default * is 1.

  • ========================================= (==================== ==========) –

  • ======================================================= (==================) –

  • Description (Methods) –

  • ======================================================= –

  • dataframe (_collar build _collar data return collar log) – format dhGeology build DH log geology return geology log dataframe.

  • sample (dhSample build DH Geochemistry-Strutural) – log dataframe

  • Sample (*return*) – log dataframe

  • Elevation (dhSurveyElevAz build DH Elevation & Azimuth logs.*return *) – & Azimuth dataframes

  • log (writeDHDATA output) – Oasis Montaj

  • ======================================================= –

:param : :type : Example: :param >>> from watex.geoloy.drilling import Drill: :param >>> parser_file =’nbleDH.csv’: :param >>> drill_obj=Drill(well_filename=’data/drill/drill_example_files’): :param >>> scollar=drill._collar(DH_Top=None): :param >>> sgeo=drill.dhGeology(): :param >>> ssam=drill.dhSample(): :param >>> selevaz=drill.dhSurveyElevAz( add_elevation=None: :param : :param … add_azimuth=None): :param >>> swrite=drill.writeDHData(data2write =”*”: :param savepath =None):

dhGeology(dh_geomask=None)[source]#

Method to build geology drillhole log. The name of input rock must feell exaction accordinag to a convention AGSO file . If not sure for the name of rock and Description and label. You may consult the geocode folder before building the well_filename. If the entirely rock name is given , program will search on the AGSO file the corresponding Label and code . If the rock name is founc then it will take its CODE else it will generate exception.

Parameters:

dh_geomask (*) – geology mask. send mask value can take exactly the np.ndarray(num_of_geology set ,). The better way to set geology maskis to fill on the wellfilename. if not , programm will take the general mask value. The default is None.

Returns:

geology drillhole log.

Return type:

pd.DataFrame

dhSample(path_to_agso_codefile=None, dh_sampmask=None)[source]#

Method to build Sample log. This method focuses on the sample obtained during the DH trip.it may georeferenced as the well_filename needed. A main thing is to set the AGSO_STCODES file. AGSO_STCODES is the conventional code of structurals sample. If you have an own AGSO_STCODES , you may provide the path * kwargs=path_to_ags_codefile * . the program will read and generate logs according to the DESCRIPTION and STCODES figured. if None, the program will take it STCODES and set the samplelogs. When you set the Sample code aor sample name , make sur that the name match the same name on STCODES. If not , program will raises an error.

Parameters:

  • path_to_agso_codefile (*) – path to conventional AGSO_STRUCTURAL CODES. The default is None.

  • dh_sampmask (*) – Structural mask. The default is None.

Returns:

Sample DH log.

Return type:

pd.DataFrame

dhSurveyElevAz(add_elevation=None, add_azimuth=None, **kwargs)[source]#

Method to build Elevation & Azimuth DH logs. if add_elevation and . add_azimuth are set . The programm will ignore the computated azimuth, and it will replace to the new azimuth provided . all elevation will be ignore and set by the new elevation . *kwargs arguments {add_elevation , add-azimuth } must match the same size like the number of Drillholes . Each one must be on ndarray(num_of_holes, 1).

Parameters:

  • add_elevation (*) – elevation data (num_of_holes, 1) The default is None.

  • add_azimuth (*) – azimuth data (num_of_holes,1). The default is None.

  • DH_RL (*) – if not provided , it’s set to 0. means No topography is added’.

Returns:

  • pd.Dataframe – Elevation DH log .

  • pd.DataFrame – Azimuth DH log.

writeDHData(data2write=None, **kwargs)[source]#

Method to write allDH logs. It depends to the users to sort which data want to export and which format. the program support only two format (.xlsx and .csv) if one is set , it will ouptput the convenience format. Users can give a list of the name of log he want to export. Program is dynamic and flexible. It tolerates quite symbols number to

extract data logs.

Parameters:

  • data2write (*) – the search key. The default is None.

  • datafn (*) – savepath to exported file Default is current work directory.

  • write_index_on_sheet (*) – choice to write the sheet with pandas.Dataframe index.

  • writeType (*) – file type . its may .csv or *.xlsx . *Default is *.xlsx

  • add_header (*) – add head on exported sheet. set False to mask heads. Default is True.

  • csv_separateType (*) – Indicated for csv exported files , the type of comma delimited . defaut is ‘,’.