Core geology#

The core module deals with geological data, the structural infos and borehole data.

class watex.geology.core.Base(verbose=0, **kwargs)[source]#

Bases: object

Base class of container of geological informations for stratigraphy model log creation of exploration area.

Each station is condidered as an attribute and framed by two closest points from the station offsets. The class deals with the true resistivity values collected on exploration area from drilling or geolgical companies. Indeed, the input true resistivity values into the occam2d inversion data could yield an accuracy underground map. The challenge to build a pseudolog framed between two stations allow to know the layers disposal or supperposition from to top to the investigation depth. The aim is to emphasize a large conductive zone usefful in of groundwater exploration. The class Geodrill deals at this time with Occam 2D inversion files or Bo Yang model (x,y,z) files. We intend to extend later with other external softwares like the Modular System EM (MODEM) and else. It’s also possible to generate output straighforwardly for others external softwares like Golder sofwares(‘surfer’)or Oasis Montaj:

Surfer: :https://www.goldensoftware.com/products/surfer)

Oasis: http://updates.geosoft.com/downloads/files/how-to-guides/Oasis_montaj_Gridding.pdf

<https://www.seequent.com/products-solutions/geosoft-oasis-montaj/>

Note

If the user has a golder software installed on its computer, it ‘s possible to use the output files generated here to yield a 2D map so to compare both maps to see the difference between model map (

only inversion files and detail-sequences map after including the input true resistivity values and layer names)

Futhermore, the “pseudosequences model” could match and describe better the layers disposal (thcikness and contact) in underground than the raw model map which seems to be close to the reality when step descent parameter is not too small at all.

watex.geology.core.fetching_data_from_repo(repo_file, savepath=None)[source]#

Try to retrieve data from github repository.

Parameters:: repo_file – str or Path-like object Give the full path from the repository root to the file name. For instance, we want to retrieve the file ‘AGSO.csv’ which is located in <watex/etc/> directory then the full path is: –> ‘watex/etc/AGSO.csv’

:return:`status`: Either ``False` for failed downloading: or True for successfully downloading

watex.geology.core.get_agso_properties(config_file=None, orient='series')[source]#

Get the geostructures files from <’watex/etc/’> and set the properties according to the desire type. When orient is series it will return a dictionnary with key equal to properties name and values are the properties items.

Parameters:

config_file – Path_Like or str Can be any property file provided hat its obey the disposal of property files found in __agso_properties.
orient – string value, (‘dict’, ‘list’, ‘series’, ‘split’, ‘records’, ‘’index’) Defines which dtype to convert Columns(series into).For example, ‘list’ would return a dictionary of lists with Key=Column name and Value=List (Converted series). For furthers details, please refer to https://www.geeksforgeeks.org/python-pandas-dataframe-to_dict/

Example:

>>> import watex.utils.geotools as GU
>>> data=get_agso_properties('watex/etc/AGSO_STCODES.csv')
>>> code_descr={key:value for key , value in zip (data["CODE"],
                                               data['__DESCRIPTION'])}

watex.geology.core.mapping_stratum(download_files=True)[source]#

Map the rocks properties from _geocodes files and fit each rock to its properties.

Parameters:: download_files – bool Fetching data from repository if the geostrutures files are missing.
Returns:: Rocks and structures data in two diferent dictionnaries

watex.geology.core.set_agso_properties(download_files=True)[source]#: Set the rocks and their properties from inner files located in < ‘watex/etc/’> folder.