read_data技术文档

read_data是用于读取地质表面数据的函数，是Gempy中SurfacePoints类的一个方法。该函数的作用是读取包含地质表面数据的CSV或者Excel文件并将其存储为pandas DataFrame对象。

参数

• path_to_data（必选参数）：包含地质表面数据的CSV或者Excel文件路径。
• delimiter（可选参数）：CSV文件的分隔符，默认为逗号（,）。
• sheetname（可选参数）：Excel文件的工作表名称，与CSV文件不同，如果未提供该参数，将自动尝试读取默认的第一个工作表。
• xyz（可选参数）：数据中地质表面的XYZ坐标列的名称，必须包含X、Y、Z这三列数据。

返回值

该函数返回一个pandas DataFrame对象，包含地质表面的XYZ坐标和所在的地层序列。

示例

import gempy as gp

# 定义SurfacePoints对象
geo_data = gp.create_data('example')

# 读取csv格式的地质表面数据
geo_data.surface_points.df = gp.read_data('path/to/surface_points.csv', xyz=['X', 'Y', 'Z'])

# 读取excel格式的地质表面数据
geo_data.surface_points.df = gp.read_data('path/to/surface_points.xlsx', sheetname='Sheet1', xyz=['X', 'Y', 'Z'])

异常

• FileNotFoundError：如果未找到指定路径的文件，则引发此异常。
• ValueError：如果文件不符合所需格式，则引发此异常。该异常可能由于以下原因之一而引起：未提供xyz列名，所提供的列名与文件中实际列名称不匹配等。