GA 图层转等值线 (地统计分析工具)
汇总
根据地统计图层创建等值线的要素类。 输出要素类可以是由等值线构成的线要素类,或由填充的等值线构成的面要素类。
用法
对于支持 Null 值的数据格式,例如文件地理数据库要素类,将使用 Null 值来表示无法对该位置做出预测,而在将 Null 值用作输入时,该值将被忽略。 对于不支持空值的数据格式,例如 shapefile,使用值 -1.7976931348623158e+308(这是 C++ 定义的常量 DBL_MAX 的负值)来表示无法对该位置做出预测。
输出面或折线要素会根据计算机 CPU 核的数量,包含略有不同的几何。 这是因为等值线算法中使用的块数量不同(核越多,允许的块越多,因此输出等值线更优)。 要在 CPU 核数量不同的计算机上获得可重现的结果,可使用并行处理因子 环境来控制该工具允许使用的核数量。
如果输入地统计图层代表 3D 插值模型,则必须使用输出高程参数指定要导出的等高线的高程。
参数
|
标注
|
说明
|
数据类型
|
|
输入地统计图层
|
要分析的地统计图层。
|
Geostatistical Layer
|
|
等值线类型
|
表示地统计图层的等值线类型。
|
String
|
|
输出要素类
|
输出要素类可以是折线或面,具体取决于所选的等值线类型。
|
Feature Class
|
|
等值线质量
(可选)
|
确定等值线制图表达的平滑度。
|
String
|
|
分类类型
(可选)
|
指定如何计算等值线中断值。
几何间隔—根据几何间隔计算等值线中断值。
相等间隔—根据相等间隔计算等值线中断值。
分位数—根据输入数据的分位数计算等值线中断值。
手动—指定您自己的中断值。
|
String
|
|
类数
(可选)
|
指定输出要素类的类数。
如果将等值线类型设置为输出填充的等值线面,则创建的面数将等于该参数中指定的值。 如果将其设置为输出等值线折线,则折线数将比该参数中指定的值少一个(因为 N 个类间隔定义 N-1 个等值线中断值)。
如果将分类类型设置为手动,则该参数不适用。
|
Long
|
|
分类间隔
(可选)
|
将分类类型设置为手动时的中断值列表。
|
Double
|
|
输出高程
(可选)
|
对于 3D 插值模型,可以导出任何高程处的等值线。 可以使用此参数来指定要导出的高程。 如果留空,则将从输入图层继承高程。 单位将默认与输入图层的单位相同。
|
Linear Unit
|
arcpy.ga.GALayerToContour(in_geostat_layer, contour_type, out_feature_class, {contour_quality}, {classification_type}, {classes_count}, {classes_breaks}, {out_elevation})
|
名称
|
说明
|
数据类型
|
|
in_geostat_layer
|
要分析的地统计图层。
|
Geostatistical Layer
|
|
contour_type
|
表示地统计图层的等值线类型。
CONTOUR—表示地统计图层的等值线或等值线图。 可按草稿质量或演示质量显示线。
FILLED_CONTOUR—表示地统计图层的面。 假设图形显示的等值线之间的值在面范围内的所有位置都是相同的。 可按草稿质量或演示质量显示线。
SAME_AS_LAYER—使用输入地统计图层的当前渲染器。
|
String
|
|
out_feature_class
|
输出要素类可以是折线或面,具体取决于所选的等值线类型。
|
Feature Class
|
|
contour_quality
(可选)
|
确定等值线制图表达的平滑度。
|
String
|
|
classification_type
(可选)
|
指定如何计算等值线中断值。
GEOMETRIC_INTERVAL—根据几何间隔计算等值线中断值。
EQUAL_INTERVAL—根据相等间隔计算等值线中断值。
QUANTILE—根据输入数据的分位数计算等值线中断值。
MANUAL—指定您自己的中断值。
|
String
|
|
classes_count
(可选)
|
指定输出要素类的类数。
如果将 contour_type 设置为输出填充的等值线面,则创建的面数将等于该参数中指定的值。 如果将其设置为输出等值线折线,则折线数将比该参数中指定的值少一个(因为 N 个类间隔定义 N-1 个等值线中断值)。
如果将 classification_type 设置为 Manual,则该参数不适用。
|
Long
|
|
classes_breaks
[classes_breaks,...]
(可选)
|
将 classification_type 设置为 Manual 时的中断值列表。 应以列表的形式传递这些值,且可以按任意顺序排列。
|
Double
|
|
out_elevation
(可选)
|
对于 3D 插值模型,可以导出任何高程处的等值线。 可以使用此参数来指定要导出的高程。 如果留空,则将从输入图层继承高程。 单位将默认与输入图层的单位相同。
|
Linear Unit
|
代码示例
将地统计图层导出为等值线要素类。
import arcpy
from arcpy import env
env.workspace = "C:/gapyexamples/data"
arcpy.ga.GALayerToContour("kriging.lyr", "Contour", "krig_contour",
"Presentation", "GEOMETRIC_INTERVAL", 10, "")
将地统计图层导出为等值线要素类。
# Name: GALayerToContour_Example_02.py
# Description: Exports a geostatistical layer to filled contours with
# class breaks at 100, 500 and 2000.
# Requirements: Geostatistical Analyst extension
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/gapyexamples/data"
# Set local variables
in_geostat_layer = "kriging.lyr"
contour_type = "Filled_contour"
out_feature_class = "C:/gapyexamples/output/krig_filled_contour.shp"
contour_quality = "Presentation"
classification_type = "Manual"
classes_count = ""
classes_breaks = [100, 500, 2000]
# Run GALayerToContour
arcpy.ga.GALayerToContour(in_geostat_layer, contour_type, out_feature_class,
contour_quality, classification_type, classes_count,
classes_breaks)
环境
当前工作空间, 范围, 地理变换, 输出坐标系, 并行处理因子, 临时工作空间
许可信息
- 基本: 需要 Geostatistical Analyst
- 标准: 需要 Geostatistical Analyst
- 高级: 需要 Geostatistical Analyst