GA 图层转等值线 (地统计分析)

需要 Geostatistical Analyst 许可。

摘要

在地统计图层中创建等值线要素类。输出要素类可以是由等值线构成的线要素类,或由填充的等值线构成的面要素类。

使用情况

  • 对于支持空值的数据格式(如文件地理数据库要素类),使用空值表示无法对该位置做出预测或该值用作输入时应被忽略。对于不支持空值的数据格式(如 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
(可选)

确定等值线制图表达的平滑度。

  • DRAFT 默认的质量选项为“草稿”,即显示一条概化版本的等值线以获得较快的显示。
  • PRESENTATION“显示”选项可确保为输出要素类显示更为精细的等值线。
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

代码示例

GALayerToContour 交互式窗口示例

将地统计图层导出为等值线要素类。

import arcpy
from arcpy import env
env.workspace = "C:/gapyexamples/data"
arcpy.GALayerToContour_ga("kriging.lyr", "Contour", "krig_contour",
                          "Presentation", "GEOMETRIC_INTERVAL", 10, "")
GALayerToContour 脚本示例

将地统计图层导出为等值线要素类。

# 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]

# Execute GALayerToContour
arcpy.GALayerToContour_ga(in_geostat_layer, contour_type, out_feature_class,
                          contour_quality, classification_type, classes_count,
                          classes_breaks)

许可信息

  • Basic: 需要 地统计分析
  • Standard: 需要 地统计分析
  • Advanced: 需要 地统计分析

相关主题