add_features

描述

add_features是gempy.core.model.Project类的一个方法。它用于在Gempy Project对象中添加新的地质特征（Geological Feature）。

语法

add_features(features_to_add: Union[dict, List[dict]])

参数

• features_to_add：要添加的地质特征。此参数可以是一个包含一个或多个特征字典的列表，也可以是一个单独的特征字典。特征字典必须具有以下关键字：

  • 'feature_name'：特征名称（字符串）；
  • 'domain'：特征所覆盖的地质单元（字符串或列表）；
  • 'range'：特征属性（字符串或列表）；
  • 'position'：特征属性的空间位置（列表，具有三个元素，分别表示特征属性的x、y和z坐标）。

返回值

添加操作执行完毕后，该方法不返回任何值。

用法示例

import gempy as gp
import pandas as pd
import numpy as np

# 创建一个新的Project对象
proj = gp.Project()

# 创建三个地质单元
proj.add_surfaces(['rock1','rock2','rock3'])

# 定义一个特征字典
feature_dict = {
    'feature_name': 'my_feature',
    'domain': 'rock1',
    'range': 'type1',
    'position': [0, 0, 0]
}

# 将特征添加到Project对象中
proj.add_features(feature_dict)

这个例子中，我们创建了一个新的Gempy Project对象，并在其中添加了三个地质单元。然后，我们定义了一个特征字典，表示一个名为“my_feature”的新地质特征，其属性值为“type1”，覆盖了“rock1”这个地质单元的某些位置。最后，我们调用add_features方法将该特征添加到Project对象中。

异常

• GeoFeatValError：如果特征字典中的某些关键字值不是一个有效的类型或格式，则会引发此异常。
• FeatureAlreadyExistError：如果尝试添加一个已经存在的特征名称，则会引发此异常。