new_model

功能

new_model 是 gempy.core.model.Project 中的一个方法，用于创建新的地质模型。

语法

new_model(
    name: str,
    overwrite: bool = False,
    input_data: Optional[Tuple[pd.DataFrame, pd.DataFrame, pd.DataFrame]] = None
) -> Tuple[str, str, Optional[Tuple[pd.DataFrame, pd.DataFrame, pd.DataFrame]]]

参数

• name：字符串类型，表示要创建新地质模型的名称。
• overwrite：布尔类型，表示如果已存在同名模型是否要覆盖。默认值为 False，即不覆盖。
• input_data：元组类型，包含三个 Pandas DataFrame 类型的对象，即 GeoDataFrame、OrientationsDataFrame、SurfacePointsDataFrame 对象。这些数据可用于创建地质模型。如果不提供，则需要在后续步骤中通过其他方式提供。

返回值

• Tuple[str, str, Optional[Tuple[pd.DataFrame, pd.DataFrame, pd.DataFrame]]]：长度为 3 的元组，包含：
  • str 类型的元素，表示创建的新地质模型的名称。
  • str 类型的元素，表示创建的新地质模型的路径。
  • 可选的元素，包含三个 Pandas DataFrame 类型的对象，分别为 GeoDataFrame、OrientationsDataFrame、SurfacePointsDataFrame。

示例

创建一个新的地质模型：

import gempy as gp

# 创建一个新的地质模型，
# 使用 'new_model_test' 作为模型名称
# 不覆盖同名模型
name, path, input_data = gp.create_project('new_model_test')

# 打印模型名称和路径
print('Model name:', name)
print('Model path:', path)

# 检查是否有 SurfacePointsDataFrame 对象
if input_data is None:
    print('No input data provided')
else:
    print(f'SurfacePointsDataFrame:\n{input_data[2]}')

输出结果：

Model name: new_model_test
Model path: /path/to/new_model_test
No input data provided

异常

• gempy.core.model.ProjectException：如果给定名称的模型已经存在并且 overwrite 参数为 False，则会抛出异常。