Добавить атрибуты геометрии (Управление данными)—ArcGIS Pro

Сводка

Добавляет новые поля атрибутов ко входным объектам, отображающие пространственные или геометрические характеристики и местоположение каждого объекта, например, длину, площадь, координаты x, y, z и m.

Использование

Внимание:

Этот инструмент изменяет входные значения. Более подробно о стратегиях предотвращения нежелательных изменений данных см. в разделе Инструменты, которые изменяют или обновляют входные данные.

Одно или несколько атрибутивных полей будут добавлены ко входным объектам, в зависимости от опций, указанных в параметре Свойства геометрии. Если поля уже присутствуют во входных объектах, значения в них будут перезаписаны. Воспользуйтесь следующей таблицей для определения полей, которые будут добавлены к каждому свойству геометрии:


Свойство геометрии	Добавленные поля
AREA	POLY_AREA: площадь полигона.
AREA_GEODESIC	AREA_GEO: геодезическая площадь полигона.
CENTROID	CENTROID_X: координата x точки центроида. CENTROID_Y: координата y точки центроида. CENTROID_Z: координата z точки центроида. Поле добавляется, только если для входных объектов активированы значения z. CENTROID_M: координата m точки центроида. Поле добавляется, только если для входных объектов активированы значения m.
CENTROID_INSIDE	INSIDE_X: координата x точки центроида внутри или на входном объекте. INSIDE_Y: координата y точки центроида внутри или на входном объекте. INSIDE_Z: координата z точки центроида внутри или на входном объекте. Поле добавляется, только если для входных объектов активированы значения z. INSIDE_M: координата m точки центроида внутри или на входном объекте. Поле добавляется, только если для входных объектов активированы значения m.
EXTENT	EXT_MIN_X: минимальная координата x объекта. EXT_MIN_Y: минимальная координата y объекта. EXT_MAX_X: максимальная координата x объекта. EXT_MAX_Y: максимальная координата y объекта.
LENGTH	LENGTH: длина линии.
LENGTH_GEODESIC	LENGTH_GEO: геодезическая длина линии.
LENGTH_3D	LENGTH_3D: 3D-длина линии.
LINE_BEARING	BEARING: азимут линии. Значения находятся в диапазоне от 0 до 360, причем нулю соответствует северное направление, 180 – южное, 270 – западное и т.д.
LINE_START_MID_END	START_X: координата x первой точки линии или границы полигона. START_Y: координата y первой точки линии или границы полигона. START_Z: координата z первой точки линии или границы полигона. Поле добавляется, только если для входных объектов активированы значения z. START_M: координата m первой точки линии или границы полигона. Поле добавляется, только если для входных объектов активированы значения m. MID_X: координата x точки середины линии или границы полигона. MID_Y: координата y точки середины линии или границы полигона. MID_Z: координата z точки середины линии или границы полигона. Поле добавляется, только если для входных объектов активированы значения z. MID_M: координата m точки середины линии или границы полигона. Поле добавляется, только если для входных объектов активированы значения m. END_X: координата x последней точки линии или границы полигона. END_Y: координата y последней точки линии или границы полигона. END_Z: координата z последней точки линии или границы полигона. Поле добавляется, только если для входных объектов активированы значения z. END_M: координата m последней точки линии или границы полигона. Поле добавляется, только если для входных объектов активированы значения m.
PART_COUNT	PART_COUNT: число сегментов объекта.
PERIMETER_LENGTH	PERIMETER: длина периметра полигона или границы.
PERIMETER_LENGTH_GEODESIC	PERIM_GEO: геодезическая длина периметра полигона или границы.
POINT_COUNT	PNT_COUNT: число точек объекта.
POINT_X_Y_Z_M	POINT_X: X-координата точки. POINT_Y: Y-координата точки. POINT_Z: Z-координата точки. Поле добавляется, только если для входных объектов активированы значения z. POINT_M: M-координата точки. Поле добавляется, только если для входных объектов активированы значения m.

Если указана система координат, длина и площадь будет вычисляться в единицах этой системы, если другие единицы измерения не будут указаны в качестве параметров Единицы измерения длины и Единицы измерения площади.
Поля атрибутов, добавленные данным инструментом, являются такими же, как и все поля, которые вы можете добавить к векторному слою. Вы можете перезаписать значения в поле, удалить или переименовать поля. Значение в этих полях автоматически не пересчитываются после внесения изменений. При редактировании вами объектов необходимо еще раз запустить инструмент, чтобы обновить значения полей.
Если во входных объектах сделана выборка, только выбранные объекты получат вычисленные в добавленных полях значения, а все остальные объекты – нулевые значения.
Этот инструмент работает с точечными, мультиточечными, полилинейными, полигональными классы, а также классами объектов-аннотаций. Аннотации рассматриваются как класс полигональных объектов.

Синтаксис

arcpy.management.AddGeometryAttributes(Input_Features, Geometry_Properties, {Length_Unit}, {Area_Unit}, {Coordinate_System})

Parameter	Объяснение	Тип данных
Input_Features	Новые поля атрибутов будут добавлены ко входным объектам для сохранения таких свойств, как длина, площадь, координаты x, y, z и m.	Feature Layer
Geometry_Properties [Geometry_Properties,...]	Определяет свойства геометрии и формы, которые будут вычислены в новых полях атрибутов. AREA —Добавляет атрибут, хранящий площадь полигональных объектов. AREA_GEODESIC —Добавляет атрибут, хранящий геодезическую площадь полигональных объектов. CENTROID —Добавляет атрибуты, хранящие координаты центроидов объектов. CENTROID_INSIDE —Добавляет атрибуты, хранящие координаты центроидов внутри или на объектах. EXTENT —Добавляет атрибуты, хранящие координаты экстента объектов. LENGTH —Добавляет атрибут, хранящий длины линейных объектов. LENGTH_GEODESIC —Добавляет атрибут, хранящий геодезические длины линейных объектов. LENGTH_3D —Добавляет атрибут, хранящий 3D-длины линейных объектов. LINE_BEARING —Добавляет атрибут, хранящий азимуты линейных объектов. Значения находятся в диапазоне от 0 до 360, причем нулю соответствует северное направление, 180 – южное, 270 – западное и т.д. LINE_START_MID_END —Добавляет атрибут, хранящий координаты начальных, средних и конечных точек объектов. PART_COUNT —Добавляет атрибут, хранящий число сегментов объектов. PERIMETER_LENGTH —Добавляет атрибут, хранящий длину периметра или границы полигональных объектов. PERIMETER_LENGTH_GEODESIC —Добавляет атрибут, хранящий геодезические длины периметра или границы полигональных объектов. POINT_COUNT —Добавляет атрибут, хранящий число точек или вершин объектов. POINT_X_Y_Z_M —Добавляет атрибут, хранящий координаты x, y, z, и m точечных объектов.	String
Length_Unit (Дополнительный)	Единица измерения для вычисления длины. FEET_US —Длина в футах (U.S.) METERS —Длина в метрах KILOMETERS —Длина в километрах MILES_US —Длина в милях (U.S.) NAUTICAL_MILES —Длина в морских милях (U.S.) YARDS —Длина в ярдах (U.S.)	String
Area_Unit (Дополнительный)	Единица измерения для вычисления площади. ACRES —Площадь в акрах HECTARES —Площадь в гектарах SQUARE_MILES_US —Площадь в квадратных милях (U.S.) SQUARE_KILOMETERS —Площадь в квадратных километрах SQUARE_METERS —Площадь в квадратных метрах SQUARE_FEET_US —Площадь в квадратных футах (U.S.) SQUARE_YARDS —Площадь в квадратных ярдах (U.S.) SQUARE_NAUTICAL_MILES —Площадь в квадратных морских милях (U.S.)	String
Coordinate_System (Дополнительный)	Система координат, в которой будут вычислены координаты, длина и площадь. По умолчанию используется система координат входных объектов.	Coordinate System

Производные выходные данные

Name	Объяснение	Тип данных
Modified_Input_Features	Обновленные входные объекты	Векторный слой

Пример кода

AddGeometryAttributes, пример (окно Python)

В следующем скрипте окна Python показано, как используется инструмент AddGeometryAttributes.

import arcpy
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.AddGeometryAttributes_management("roads", "LENGTH;LINE_START_MID_END")

AddGeometryAttributes, пример (автономный скрипт)

Берет прямоугольник экстента каждой линии и строит сетку 10х10 внутри этого экстента.

# Name: GridCreation.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"
properties = "EXTENT"
length_unit = ""
area_unit = ""
coordinate_system = ""
# Generate the extent coordinates using Add Geometry Properties tool
arcpy.AddGeometryAttributes_management(in_features, properties, length_unit,
                                                              area_unit,
                                                              coordinate_system)
# Use Search Cursor to walk through each feature and generate grids
with arcpy.da.SearchCursor(in_features, ["OID@", "EXT_MIN_X", "EXT_MIN_Y",
                                           "EXT_MAX_X", "EXT_MAX_Y"]) as sCur:
    for row in sCur:
        minX, minY, maxX, maxY = row[1], row[2], row[3], row[4]
        arcpy.CreateFishnet_management("fishnet_{0}".format(row[0]),
                    number_rows = 10,
                    number_columns = 10,
                    template = "{0} {1} {2} {3}".format(minX, maxX, minY, maxY),
                    origin_coord = "{0} {1}".format(minX, minY),
                    y_axis_coord = "{0} {1}".format(minX, maxY),
                    corner_coord = "{0} {1}".format(maxX, maxY),
                    geometry_type = "POLYGON",
                    labels = "NO_LABELS")

Environments

Выходная система координат, Текущая рабочая область

Информация о лицензиях

Basic: Да
Standard: Да
Advanced: Да

Связанные разделы

Отзыв по этому разделу?