Tutorial setup Cpt class interpretation using GEOLIB+

By following the next steps the user can read, process and interpret a cpt file. The formats that can be read by GEOLIB+ are the gef and bro xml files. The gef format is formulated as in [14]. The bro xml is formulated in [15].

  1. First the user must define where the cpt file is located. This process is the same for both xml and gef files.

from pathlib import Path
cpt_file_gef = Path("cpt", "gef", "test_cpt.gef")
cpt_file_xml = Path("cpt", "xml", "test_cpt.xml")

2. Then the corresponding class should be initialized. For gef initialize class GefCpt. For bro xml initialize the class BroXmlCpt.

from geolib_plus.gef_cpt import GefCpt
from geolib_plus.bro_xml_cpt import BroXmlCpt

# initialize models
cpt_gef = GefCpt()
cpt_xml = BroXmlCpt()

3. After that, the raw data can be read for both of the cpts. In this case the raw data from the files are allocated into the properties of the class AbstractCPT. For example the penetration length of the cpt is property penetration_length of the class AbstractCPT. As it is of type Iterable you can print out the first element.

# read the cpt for each type of file
cpt_gef.read(cpt_file_gef)
cpt_xml.read(cpt_file_xml)
print(cpt_gef.penetration_length[0])
print(cpt_xml.penetration_length[0])

4. Until step 3 only the raw data are part of the class. With GEOLIB+ the user can also run the pre-processing methods. These methods are required before plotting and interpretation the results. Both the gef and the bro xml cpt classes can call the pre_process_data method. However, these are two different methods. For the gef cpt pre_process_data() is called. Where the following processes take place:

  • The perform_pre_drill_interpretation() method where all the values are updated if a pre-drill operation was performed in the cpt.

  • The pre_process_data() method. This includes methods that calculate the depth depending on the inputs of the cpt, correcting negative values and calculating the pore pressures.

For the bro xml cpt the pre_process_data() method is called. Where the following process take place:

  • The pre_process_data() method. This includes methods that calculate the depth depending on the inputs of the cpt, correcting negative values and calculating the pore pressures.

# do pre-processing
cpt_gef.pre_process_data()
cpt_xml.pre_process_data()