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

Краткая информация

Добавляет новые поля атрибутов ко входным объектам, отображающие пространственные или геометрические характеристики и местоположение каждого объекта, например, длину, площадь, координаты 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, где 0 означает север, 90 – восток, 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.

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

Подпись	Объяснение	Тип данных
Входные объекты	Входные объекты, к которым будут добавлены новые атрибутивные поля для хранения таких свойств, как длина, площадь, координаты x, y, z и m.	Feature Layer
Свойства геометрии	Определяет свойства геометрии или формы, которые будут вычислены в новых атрибутивных полях. Площадь–Будет добавлен атрибут для хранения площади каждого полигонального объекта. Геодезическая площадь–Будет добавлен атрибут для хранения сохраняющей форму геодезической площади каждого полигонального объекта. Координаты центроида–Будут добавлены атрибуты для хранения координат центроида каждого объекта. Координаты центральной точки–Будут добавлены атрибуты для хранения координат центральной точки внутри или на каждом объекте. Координаты экстента–Будут добавлены атрибуты для хранения координат экстента каждого объекта. Длина–Будет добавлен атрибут для хранения длины каждого линейного объекта. Геодезическая длина–Будет добавлен атрибут для хранения сохраняющей форму геодезической длины каждого линейного объекта. 3D-длина–Будет добавлен атрибут для хранения 3D-длины каждого линейного объекта. Направление линии–Будет добавлен атрибут для хранения азимута каждого линейного объекта. Диапазон значений от 0 до 360, где 0 означает север, 90 – восток, 180 – юг, а 270 – запад. Координаты начальной, конечной и средней точки линии–Будут добавлены атрибуты для хранения координат начальной, средней и конечной точек каждого объекта. Количество частей–Будет добавлен атрибут для хранения количества частей, составляющих каждый объект. Длина периметра–Будет добавлен атрибут для хранения периметра или границы каждого полигонального объекта. Геодезическая длина периметра–Будет добавлен атрибут для хранения сохраняющей форму геодезической длины периметра или границы каждого полигонального объекта. Количество вершин–Будет добавлен атрибут для хранения количества точек или вершин, составляющих каждый объект. Координаты x-, y-, z- и m- для точки–Будут добавлены атрибуты для хранения x-, y-, z- и m-координат каждого точечного объекта.	String
Единицы длины (Дополнительный)	Указывает единицы, в которых рассчитывается длина. Футы (U.S.)–Длина в футах (U.S.) Метры–Длина в метрах Километры–Длина в километрах Мили (U.S.)–Длина в милях (U.S.) Морские мили (U.S.)–Длина в морских милях (U.S.) Ярды (U.S.)–Длина в ярдах (U.S.)	String
Единица площади (Дополнительный)	Указывает единицы, в которых рассчитывается площадь. Акры–Площадь в акрах Гектары–Площадь в гектарах Квадратные мили (U.S.)–Площадь в квадратных милях (U.S.) Квадратные километры–Площадь в квадратных километрах Квадратные метры–Площадь в квадратных метрах Квадратные футы (U.S.)–Площадь в квадратных футах (U.S.) Квадратные ярды (U.S.)–Площадь в квадратных ярдах (U.S.) Квадратные морские мили (U.S.)–Площадь в квадратных морских милях (U.S.)	String
Система координат (Дополнительный)	Система координат, в которой будут вычислены координаты, длина и площадь. По умолчанию используется система координат входных объектов.	Coordinate System

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

Подпись	Объяснение	Тип данных
Измененные входные объекты	Обновленные входные объекты	Feature Layer

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

Имя	Объяснение	Тип данных
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, где 0 означает север, 90 – восток, 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

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

Имя	Объяснение	Тип данных
Modified_Input_Features	Обновленные входные объекты	Feature Layer

Пример кода

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

Следующий скрипт окна Python демонстрирует использование функции AddGeometryAttributes.

import arcpy
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.management.AddGeometryAttributes("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.management.AddGeometryAttributes(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.management.CreateFishnet("fishnet_{0}".format(row[0]),
                    number_rows = 10,
                    number_columns = 10,
                    template = "{} {} {} {}".format(minX, maxX, minY, maxY),
                    origin_coord = "{} {}".format(minX, minY),
                    y_axis_coord = "{} {}".format(minX, maxY),
                    corner_coord = "{} {}".format(maxX, maxY),
                    geometry_type = "POLYGON",
                    labels = "NO_LABELS")

Параметры среды

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

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

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