需要 Geostatistical Analyst 许可。
描述
将地统计图层导出为点。该工具还可用于预测未测定位置上的值,或验证对测定位置的预测。
使用方法
对于支持空值的数据格式(如文件地理数据库要素类),使用空值表示无法对该位置做出预测或该值用作输入时应被忽略。对于不支持空值的数据格式(如 shapefile),使用值 -1.7976931348623158e+308(C++ 定义的常量 DBL_MAX 的负数)表示无法对该位置做出预测。
在提供 z-验证字段以及不提供验证字段这两种情况下,预测值和标准误差的计算有所不同。有关详细信息,请参阅以下参考:
- Krivoruchko, K., A. Gribov, and J. M. Ver Hoef, 2006, "A new method for handling the nugget effect in kriging," T. C. Coburn, J. M. Yarus, and R. L. Chambers, Eds., Stochastic modeling and geostatistics: Principles, methods, and case studies, volume II: AAPG Computer Applications and Geology 5, p. 81–89.
语法
arcpy.ga.GALayerToPoints(in_geostat_layer, in_locations, {z_field}, out_feature_class, {append_all_fields}, {elevation_field}, {elevation_units})
参数 | 说明 | 数据类型 |
in_geostat_layer | 要分析的地统计图层。 | Geostatistical Layer |
in_locations | 将执行预测或验证的点位置。 | Feature Layer |
z_field (可选) | 如果此字段留空,则在相应点位置上进行预测。如果选中此字段,则在点位置上进行预测,并将预测结果与点位置的 Z_value_field 值进行比较,然后执行验证分析。 | Field |
out_feature_class | 包含预测值或预测值和验证结果的输出要素类。 此要素类中的字段可能包括以下字段(如适用):
| Feature Class |
append_all_fields (可选) | 确定是否所有字段都将从输入要素复制到输出要素类。
| Boolean |
elevation_field (可选) | 包含每个输入点的高程的字段。该参数仅适用于 3D 地统计模型。 如果高程值存储为 Shape.Z 中的几何属性,则建议您使用该字段。如果高程存储在属性字段中,则高程必须表示距海平面的距离。正值表示海平面以上的距离,负值表示海平面以下的距离。 | Field |
elevation_units (可选) | 高程字段的单位。该参数仅适用于 3D 地统计模型。如果提供 Shape.Z 作为高程字段,则单位将自动匹配垂直坐标系的 Z 单位。
| String |
代码示例
将地统计图层导出为点要素类。
import arcpy
arcpy.env.workspace = "C:/gapyexamples/data"
arcpy.GALayerToPoints_ga("C:/gapyexamples/data/kriging.lyr",
"C:/gapyexamples/data/obs_pts.shp",
"", "C:/gapyexamples/output/krig_pts")
将地统计图层导出为点要素类。
# Name: GALayerToPoints_Example_02.py
# Description: Exports a geostatistical layer to points.
# Requirements: Geostatistical Analyst Extension
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/gapyexamples/data"
# Set local variables
inLayer = "C:/gapyexamples/data/kriging.lyr"
inPoints = "C:/gapyexamples/data/obs_pts.shp"
zField = ""
outPoints = "C:/gapyexamples/output/krig_pts"
# Execute GALayerToPoints
arcpy.GALayerToPoints_ga(inLayer, inPoints, zField, outPoints)
许可信息
- Basic: 需要 地统计分析
- Standard: 需要 地统计分析
- Advanced: 需要 地统计分析