ArcMap

计算几何属性

此 ArcGIS 10.6 文档已 存档，并且不再对其进行更新。 其中的内容和链接可能已过期。 请参阅最新文档。

摘要

向表示各要素空间或几何特性和位置的要素属性字段添加信息，如长度或面积以及 x、y、z 与 m 坐标。

可将多个几何属性添加到新属性字段的类似工具是添加几何属性工具。

用法

  • 如果已指定了坐标系，则长度和面积将以该坐标系的单位进行计算，除非在长度单位和面积单位参数中选择了不同的单位。

  • 如果输入要素具有选择内容，则在添加的字段中仅计算所选要素的值；其余所有要素将保留现有值。

  • 此工具适用于点、多点、折线和面要素类。

语法

CalculateGeometryAttributes_management (in_features, field, geometry_property, {length_unit}, {area_unit}, {coordinate_system})
参数说明数据类型
in_features

要素图层，其中包含将使用几何计算进行更新的字段。

Feature Layer
field

该字段将通过几何计算更新。

Field
geometry_property
[[Target Field, Property],...]

指定要在其中计算几何属性的字段以及要计算的几何属性。支持以下几何属性：

  • AREA —各个面要素的面积。
  • AREA_GEODESIC —各个面要素形状不变的测地线面积。
  • CENTROID_X —各个要素的质心 x 坐标。
  • CENTROID_Y —各个要素的质心 y 坐标。
  • CENTROID_Z —各个要素的质心 z 坐标。
  • CENTROID_M —各个要素的质心 m 坐标。
  • INSIDE_X —各个要素内或要素上中心点的 x 坐标。如果质心位于要素内，则此点与质心相同，否则为内部标注点。
  • INSIDE_Y —各个要素内或要素上中心点的 y 坐标。如果质心位于要素内，则此点与质心相同，否则为内部标注点。
  • INSIDE_Z —各个要素内或要素上中心点的 z 坐标。如果质心位于要素内，则此点与质心相同，否则为内部标注点。
  • INSIDE_M —各个要素内或要素上中心点的 m 坐标。如果质心位于要素内，则此点与质心相同，否则为内部标注点。
  • CURVE_COUNT —各个要素中的曲线数量。曲线包括椭圆弧、圆弧和贝塞尔曲线。
  • HOLE_COUNT —各个面要素中的内部孔洞数量。
  • EXTENT_MIN_X —各个要素范围的最小 x 坐标。
  • EXTENT_MIN_Y —各个要素范围的最小 y 坐标。
  • EXTENT_MIN_Z —各个要素范围的最小 z 坐标。
  • EXTENT_MAX_X —各个要素范围的最大 x 坐标。
  • EXTENT_MAX_Y —各个要素范围的最大 y 坐标。
  • EXTENT_MAX_Z —各个要素范围的最大 z 坐标。
  • LENGTH —各个线要素的长度。
  • LENGTH_GEODESIC —各个线要素形状不变的测地线长度。
  • LENGTH_3D —各个线要素的 3D 长度。
  • LINE_BEARING —各个线要素的始端到末端的方位角。值范围介于 0 至 360 之间，其中 0 表示北，90 表示东，180 表示南，270 表示西，以此类推。
  • LINE_START_X —各个线要素上起点的 x 坐标。
  • LINE_START_Y —各个线要素上起点的 y 坐标。
  • LINE_START_Z —各个线要素上起点的 z 坐标。
  • LINE_START_M —各个线要素上起点的 m 坐标。
  • LINE_END_X —各个线要素上终点的 x 坐标。
  • LINE_END_Y —各个线要素上终点的 y 坐标。
  • LINE_END_Z —各个线要素上终点的 z 坐标。
  • LINE_END_M —各个线要素上终点的 m 坐标。
  • PART_COUNT —构成各个要素的部分数量。
  • PERIMETER_LENGTH —各个面要素的周长或边界长度。
  • PERIMETER_LENGTH_GEODESIC —各个面要素周长或边界形状不变的测地线长度。
  • POINT_COUNT —构成各个要素的点或折点数量。
  • POINT_X —各个点要素的 x 坐标。
  • POINT_Y —各个点要素的 y 坐标。
  • POINT_Z —各个点要素的 z 坐标。
  • POINT_M —各个点要素的 m 坐标。
Value Table
length_unit
(可选)

用于计算长度的单位。

  • FEET_US —长度单位为英尺（美国）
  • METERS —长度单位为米
  • KILOMETERS —长度单位为千米
  • MILES_US —长度单位为英里（美国）
  • NAUTICAL_MILES —长度单位为海里（美国）
  • YARDS —长度单位为码（美国）
String
area_unit
(可选)

用于计算面积的单位。

  • ACRES —面积单位为英亩
  • HECTARES —面积单位为公顷
  • SQUARE_MILES_US —面积单位为平方英里（美国）
  • SQUARE_KILOMETERS —面积单位为平方千米
  • SQUARE_METERS —面积单位为平方米
  • SQUARE_FEET_US —面积单位为平方英尺（美国）
  • SQUARE_YARDS —面积单位为平方码（美国）
  • SQUARE_NAUTICAL_MILES —面积单位为平方海里（美国）
String
coordinate_system
(可选)

用以计算坐标、长度和面积的坐标系。默认使用输入要素的坐标系。

Coordinate System

派生输出

名称说明数据类型
updated_features

代码示例

CalculateGeometryAttributes 示例（Python 窗口）

下面的 Python 窗口脚本演示了如何使用 CalculateGeometryAttributes 工具。

import arcpy
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.CalculateGeometryAttributes_management("roads", [["Length_mi", "LENGTH"], ["Stops", "POINT_COUNT"]], "MILES_US")
CalculateGeometryAttributes 示例（独立脚本）

获取各个要素的范围矩形。

# Name: ExtentCreation.py
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.env.outputCoordinateSystem = arcpy.Describe("roads").spatialReference
# Set local variables
in_features = "roads"
# Generate the extent coordinates using CalculateGeometry
arcpy.CalculateGeometryAttributes_management(in_features, [["Left", "EXTENT_MIN_X"],
																																																											["Bottom", "EXTENT_MIN_Y"],
																																																											["Right", "EXTENT_MAX_X"],
																																																											["Top", "EXTENT_MAX_Y"]])

环境