geost.read_cpt_table#

Read tabular CPT information. This is a file (parquet, csv or Excel) that includes row data for each CPT depth interval and must at least include the following header information as columns:

nr - Object id x - X-coordinates according to the given horizontal_reference y - Y-coordinates according to the given horizontal_reference surface - Surface elevation according to the given vertical_reference end - End depth according to the given vertical_reference depth - Depth in meters below the surface

Parameters:

file (str | Path) – File with the CPT information to read.
horizontal_reference (str | int | CRS, optional) – EPSG of the data’s horizontal reference. Takes anything that can be interpreted by pyproj.crs.CRS.from_user_input(). The default is 28992.
vertical_reference (str | int | CRS, optional) – EPSG of the data’s vertical datum. Takes anything that can be interpreted by pyproj.crs.CRS.from_user_input(). However, it must be a vertical datum. FYI: “NAP” is EPSG 5709 and The Belgian reference system (Ostend height) is ESPG 5710. The default is 5709.
as_collection (bool, optional) – If True, the CPT table will be read as a Collection which includes a header object and spatial selection functionality. If False, a DiscreteData object is returned. The default is True.
column_mapper (dict, optional) – If the file to be read uses different column names than the ones given in the description above, you can use a dictionary mapping to translate the column names to the required format. column_mapper is None by default, in which case the user is asked for input if not all required columns are encountered in the file.
kwargs (optional) – Optional keyword arguments for Pandas.read_parquet, Pandas.read_csv or Pandas.read_excel.

Returns:

Instance of CptCollection.

Return type:

CptCollection