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

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

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

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

Внимание:

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

• Длина и площадь будет вычисляться в единицах системы координат входных объектов, если другие единицы измерения не будут указаны в качестве параметров Единицы измерения длины и Единицы измерения площади. Если параметр Система координат задан, длина и площадь будут вычисляться в единицах системы координат, если только в параметрах Единицы измерения длины и Единицы измерения площади не будут указаны другие единицы.

  Подробнее о единицах измерения длины и площади в инструментах геообработки

• Свойства геодезической длины и площади используют алгоритм сохранения формы. Это позволяет получить очень точные результаты, на которые не влияет допущение, что входные линейные или полигональные объекты создаются с использованием геодезических дуг между вершинами, однако это допущение применяется для традиционной геодезической длины и площади.

• Если во входных объектах есть выборка, только выбранные объекты получат вычисленные в добавленных полях значения, а все остальные объекты сохранят свои существующие значения.

Параметры

Диалог

Подпись	Описание	Тип данных
Входные объекты	Объекты с полем, которое будет обновлено вычисленными значениями геометрии.	Feature Layer
Атрибуты геометрии	Поля, в которых будут вычислены заданные свойства геометрии. Можно выбрать существующее поле или ввести имя нового поля. Если указано имя нового поля, тип поля определяется типом значений, которые в него записываются. Атрибуты численности записываются в поля типа длинное целочисленное, атрибуты площади, длины, координат x, y, z и m-значений в поля типа двойной точности, обозначения координат, такие как Градусы Минуты Секунды или MGRS, записываются в текстовые поля. Если не указано иное, свойства площади и длины представляют собой измерения на плоскости с использованием декартовой системы координат 2D. Площадь - Будет добавлен атрибут для хранения площади каждого полигонального объекта. Площадь (геодезическая) - Будет добавлен атрибут для хранения сохраняющей форму геодезической площади каждого полигонального объекта. Координата x центроида - Будет добавлен атрибут для хранения координаты x центроида каждого объекта. Координата y центроида - Будет добавлен атрибут для хранения координаты y центроида каждого объекта. Координата z центроида - Будет добавлен атрибут для хранения координаты z центроида каждого объекта. Значение m центроида - Будет добавлен атрибут для хранения значения m центроида каждого объекта. Координата x центральной точки - Будет добавлен атрибут для хранения координаты x центральной точки внутри или на каждом объекте. Эта точка совпадает с центроидом, если центроид внутри объекта, в противном случае – это внутренняя точка надписи. Координата y центральной точки - Будет добавлен атрибут для хранения координаты y центральной точки внутри или на каждом объекте. Эта точка совпадает с центроидом, если центроид внутри объекта, в противном случае – это внутренняя точка надписи. Координата z центральной точки - Будет добавлен атрибут для хранения координаты z центральной точки внутри или на каждом объекте. Эта точка совпадает с центроидом, если центроид внутри объекта, в противном случае – это внутренняя точка надписи. Значение m центральной точки - Будет добавлен атрибут для хранения значения m центральной точки внутри или на каждом объекте. Эта точка совпадает с центроидом, если центроид внутри объекта, в противном случае – это внутренняя точка надписи. Количество кривых - Будет добавлен атрибут для хранения количества кривых в каждом объекте. К кривым относятся эллиптические и круговые дуги, а также параметрические кривые. Число внутренних контуров - Будет добавлен атрибут для хранения количества внутренних контуров в каждом полигональном объекте. Минимальная координата x — Будет добавлен атрибут для хранения минимальной координаты x экстента каждого объекта. Минимальная координата y — Будет добавлен атрибут для хранения минимальной координаты y экстента каждого объекта. Минимальная координата z — Будет добавлен атрибут для хранения минимальной координаты z экстента каждого объекта. Максимальная координата x — Будет добавлен атрибут для хранения максимальной координаты x экстента каждого объекта. Максимальная координата y — Будет добавлен атрибут для хранения максимальной координаты y экстента каждого объекта. Максимальная координата z — Будет добавлен атрибут для хранения максимальной координаты z экстента каждого объекта. Длина — Будет добавлен атрибут для хранения длины каждого линейного объекта. Длина (геодезическая) — Будет добавлен атрибут для хранения сохраняющей форму геодезической длины каждого линейного объекта. Длина (3D) — Будет добавлен атрибут для хранения 3D длины каждого линейного объекта. Направление линии — Будет добавлен атрибут для хранения азимута каждого линейного объекта. Значения находятся в диапазоне от 0 до 360, причем нулю соответствует северное направление, 180 – южное, 270 – западное и т.д. Координата x начала линии — Будет добавлен атрибут для хранения координаты x начальной точки каждого линейного объекта. Координата y начала линии — Будет добавлен атрибут для хранения координаты y начальной точки каждого линейного объекта. Координата z начала линии — Будет добавлен атрибут для хранения координаты z начальной точки каждого линейного объекта. Значение m начала линии — Будет добавлен атрибут для хранения значения m начальной точки каждого линейного объекта. Координата x конца линии — Будет добавлен атрибут для хранения координаты x конечной точки каждого линейного объекта. Координата y конца линии — Будет добавлен атрибут для хранения координаты y конечной точки каждого линейного объекта. Координата z конца линии — Будет добавлен атрибут для хранения координаты z конечной точки каждого линейного объекта. Значение m конца линии — Будет добавлен атрибут для хранения значения m конечной точки каждого линейного объекта. Количество частей — Будет добавлен атрибут для хранения количества частей, составляющих каждый объект. Количество вершин — Будет добавлен атрибут для хранения количества точек или вершин, составляющих каждый объект. Длина периметра ——Будет добавлен атрибут для хранения периметра или границы каждого полигонального объекта. Длина периметра (геодезическая) — Будет добавлен атрибут для хранения сохраняющей форму геодезической длины периметра или границы каждого полигонального объекта. Координата x точки — Будет добавлен атрибут для хранения координаты x каждого точечного объекта. Координата y точки — Будет добавлен атрибут для хранения координаты y каждого точечного объекта. Координата z точки — Будет добавлен атрибут для хранения координаты z каждого точечного объекта. Значение m точки — Будет добавлен атрибут для хранения значения m каждого точечного объекта. Обозначение координат x и y точки — Будет добавлен атрибут для хранения координат x и y каждого точечного объекта, отформатированных в определенном обозначении координат.	Value Table
Единицы длины (Дополнительный)	Задает единицы измерения, используемые для вычисления длины. Километры—Единицами длины будут колиметры. Метры—Единицами длины будут метры. Сухопутные мили—Единицами длины будут сухопутные мили. Международные морские мили—Единицами длины будут международные морские мили. Международные ярды—Единицами длины будут международные ярды. Международные футы—Единицами длины будут международные футы. Геодезические мили США—Единицами длины будут геодезические мили США. Геодезические морские мили США—Единицами длины будут геодезические морские мили США. Геодезические ярды США—Единицами длины будут геодезические ярды США. Геодезические футы США—Единицами длины будут геодезические футы США.	String
Единицы площади (Дополнительный)	Задает единицы измерения для вычисления площади. Квадратные километры—Единицами измерения площади будут квадратные километры. Гектары—Единицами измерения площади будут гектары. Квадратные метры—Единицами измерения площади будут квадратные метры. Квадратные сухопутные мили—Единицами измерения площади будут квадратные сухопутные мили. Квадратные международные морские мили—Единицами измерения площади будут квадратные международные морские мили. Международные акры—Единицами измерения площади будут международные акры. Международные квадратные ярды—Единицами измерения площади будут квадратные международные ярды. Квадратные международные футы—Единицами измерения площади будут квадратные международные футы. Квадратные геодезические мили США—Единицами измерения площади будут квадратные геодезические мили США. Квадратные геодезические морские мили США—Единицами измерения площади будут квадратные геодезические морские мили США. Геодезические акры США—Единицами измерения площади будут геодезические акры США. Квадратные геодезические ярды США—Единицами измерения площади будут квадратные геодезические ярды США. Квадратные геодезические футы США—Единицами измерения площади будут квадратные геодезические футы США.	String
Система координат (Дополнительный)	Система координат, в которой будут вычислены координаты, длина и площадь. По умолчанию используется система координат входных объектов.	Coordinate System
Формат координат (Дополнительный)	Задает формат координат, в котором будут вычислены координаты x и y. По умолчанию используется формат координат, соответствующий единицам пространственной привязки входных объектов. Несколько форматов координат - Градусы, минуты, секунды; градусы, десятичные минуты и другие - требуют выполнения вычисления в текстовом поле. Как у входных данных—Единицы пространственной привязки входных объектов, используемые для форматирования координат. Это значение по умолчанию Десятичные градусы—Форматом координат будут Десятичные градусы. Градусы Минуты Секунды (DDD° MM' SSS.ss" <N|S|E|W>)—Форматом координат будут Градусы Минуты Секунды с обозначением стороны света в конце (DDD ° MM 'SSS.ss "<N | S | E | W>). Градусы Минуты Секунды (<N|S|E|W> DDD° MM' SSS.ss")—Форматом координат будут Градусы Минуты Секунды с направлением по сторонам света вначале (<N|S|E|W> DDD° MM' SSS.ss"). Градусы Минуты Секунды (<+|-> DDD° MM' SSS.ss")—Форматом координат будут Градусы Минуты Секунды с положительным или отрицательным направлением вначале (<+|-> DDD° MM' SSS.ss"). Градусы Минуты Секунды (<+|-> DDD.MMSSSss)—Форматом координат будут Градусы Минуты Секунды, упакованные в одно значение с положительной или отрицательной составляющей направления в начале (<+|-> DDD.MMSSSss). Градусы Десятичные минуты (DDD° MM.mmm' <N|S|E|W>)—Форматом координат будут Градусы Десятичные минуты с обозначением стороны света в конце (DDD ° MM '<N | S | E | W>). Градусы Десятичные минуты (<N|S|E|W> DDD° MM.mmm')—Форматом координат будут Градусы Десятичные минуты с направлением по сторонам света вначале (<N|S|E|W> DDD° MM.mmm'). Градусы Десятичные минуты (<+|-> DDD° MM.mmm')—Форматом координат будут Градусы Десятичные минуты с положительным и отрицательным знаком направления вначале (<+|-> DDD° MM' ). GARS (Global Area Reference System)—Форматом координат будет Глобальная система координат (Global Area Reference System). Система Global Area Reference System основывается на широте и долготе, а мир разделен на ячейки. GEOREF – Мировая географическая система привязки (World Geographic Reference System)—Форматом координат будет Всемирная система географических координат (World Geographic Reference System). Система World Geographic Reference System основывается на широте и долготе, но использует более простое и более гибкое обозначение. MGRS (Military Grid Reference System)—Форматом координат будет Военная система координат (Military Grid Reference System). USNG (United States National Grid)—Форматом координат будет Национальная сетка США (United States National Grid). Универсальная поперечная проекция Меркатора (Universal Transverse Mercator, UTM)—Форматом координат будет Универсальная поперечная проекция Меркатора. UTM (без пробелов)—Форматом координат будет Универсальная поперечная проекция Меркатора без пробелов.	String

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

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

Python

arcpy.management.CalculateGeometryAttributes(in_features, geometry_property, {length_unit}, {area_unit}, {coordinate_system}, {coordinate_format})

Имя	Описание	Тип данных
in_features	Объекты с полем, которое будет обновлено вычисленными значениями геометрии.	Feature Layer
geometry_property [[Field, Property],...]	Поля, в которых будут вычислены заданные свойства геометрии. Можно выбрать существующее поле или ввести имя нового поля. Если указано имя нового поля, тип поля определяется типом значений, которые в него записываются. Атрибуты численности записываются в поля типа длинное целочисленное, атрибуты площади, длины, координат x, y, z и m-значений в поля типа двойной точности, обозначения координат, такие как Градусы Минуты Секунды или MGRS, записываются в текстовые поля. Если не указано иное, свойства площади и длины представляют собой измерения на плоскости с использованием декартовой системы координат 2D. 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, причем нулю соответствует северное направление, 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 — Будет добавлен атрибут для хранения количества частей, составляющих каждый объект. POINT_COUNT — Будет добавлен атрибут для хранения количества точек или вершин, составляющих каждый объект. PERIMETER_LENGTH — Будет добавлен атрибут для хранения периметра или границы каждого полигонального объекта. PERIMETER_LENGTH_GEODESIC — Будет добавлен атрибут для хранения сохраняющей форму геодезической длины периметра или границы каждого полигонального объекта. POINT_X — Будет добавлен атрибут для хранения координаты x каждого точечного объекта. POINT_Y — Будет добавлен атрибут для хранения координаты y каждого точечного объекта. POINT_Z — Будет добавлен атрибут для хранения координаты z каждого точечного объекта. POINT_M — Будет добавлен атрибут для хранения значения m каждого точечного объекта. POINT_COORD_NOTATION — Будет добавлен атрибут для хранения координат x и y каждого точечного объекта, отформатированных в определенном обозначении координат.	Value Table
length_unit (Дополнительный)	Задает единицы измерения, используемые для вычисления длины. KILOMETERS—Единицами длины будут колиметры. METERS—Единицами длины будут метры. MILES_INT—Единицами длины будут сухопутные мили. NAUTICAL_MILES_INT—Единицами длины будут международные морские мили. YARDS_INT—Единицами длины будут международные ярды. FEET_INT—Единицами длины будут международные футы. MILES_US—Единицами длины будут геодезические мили США. NAUTICAL_MILES—Единицами длины будут геодезические морские мили США. YARDS—Единицами длины будут геодезические ярды США. FEET_US—Единицами длины будут геодезические футы США.	String
area_unit (Дополнительный)	Задает единицы измерения для вычисления площади. SQUARE_KILOMETERS—Единицами измерения площади будут квадратные километры. HECTARES—Единицами измерения площади будут гектары. SQUARE_METERS—Единицами измерения площади будут квадратные метры. SQUARE_MILES_INT—Единицами измерения площади будут квадратные сухопутные мили. SQUARE_NAUTICAL_MILES—Единицами измерения площади будут квадратные международные морские мили. ACRES—Единицами измерения площади будут международные акры. SQUARE_YARDS—Единицами измерения площади будут квадратные международные ярды. SQUARE_FEET_INT—Единицами измерения площади будут квадратные международные футы. SQUARE_MILES_US—Единицами измерения площади будут квадратные геодезические мили США. SQUARE_NAUTICAL_MILES_US—Единицами измерения площади будут квадратные геодезические морские мили США. ACRES_US—Единицами измерения площади будут геодезические акры США. SQUARE_YARDS_US—Единицами измерения площади будут квадратные геодезические ярды США. SQUARE_FEET_US—Единицами измерения площади будут квадратные геодезические футы США.	String
coordinate_system (Дополнительный)	Система координат, в которой будут вычислены координаты, длина и площадь. По умолчанию используется система координат входных объектов.	Coordinate System
coordinate_format (Дополнительный)	Задает формат координат, в котором будут вычислены координаты x и y. По умолчанию используется формат координат, соответствующий единицам пространственной привязки входных объектов. Несколько форматов координат - Градусы, минуты, секунды; градусы, десятичные минуты и другие - требуют выполнения вычисления в текстовом поле. SAME_AS_INPUT—Единицы пространственной привязки входных объектов, используемые для форматирования координат. Это значение по умолчанию DD—Форматом координат будут Десятичные градусы. DMS_DIR_LAST—Форматом координат будут Градусы Минуты Секунды с обозначением стороны света в конце (DDD ° MM 'SSS.ss "<N | S | E | W>). DMS_DIR_FIRST—Форматом координат будут Градусы Минуты Секунды с направлением по сторонам света вначале (<N|S|E|W> DDD° MM' SSS.ss"). DMS_POS_NEG—Форматом координат будут Градусы Минуты Секунды с положительным или отрицательным направлением вначале (<+|-> DDD° MM' SSS.ss"). DMS_PACKED—Форматом координат будут Градусы Минуты Секунды, упакованные в одно значение с положительной или отрицательной составляющей направления в начале (<+|-> DDD.MMSSSss). DDM_DIR_LAST—Форматом координат будут Градусы Десятичные минуты с обозначением стороны света в конце (DDD ° MM '<N | S | E | W>). DDM_DIR_FIRST—Форматом координат будут Градусы Десятичные минуты с направлением по сторонам света вначале (<N|S|E|W> DDD° MM.mmm'). DDM_POS_NEG—Форматом координат будут Градусы Десятичные минуты с положительным и отрицательным знаком направления вначале (<+|-> DDD° MM' ). GARS—Форматом координат будет Глобальная система координат (Global Area Reference System). Система Global Area Reference System основывается на широте и долготе, а мир разделен на ячейки. GEOREF—Форматом координат будет Всемирная система географических координат (World Geographic Reference System). Система World Geographic Reference System основывается на широте и долготе, но использует более простое и более гибкое обозначение. MGRS—Форматом координат будет Военная система координат (Military Grid Reference System). USNG—Форматом координат будет Национальная сетка США (United States National Grid). UTM—Форматом координат будет Универсальная поперечная проекция Меркатора. UTMNS—Форматом координат будет Универсальная поперечная проекция Меркатора без пробелов.	String

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

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

Пример кода

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

Пример скрипта в окне Python для использования функции CalculateGeometryAttributes.

import arcpy
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.management.CalculateGeometryAttributes("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.management.CalculateGeometryAttributes(in_features, [["Left", "EXTENT_MIN_X"],
                                                           ["Bottom", "EXTENT_MIN_Y"],
                                                           ["Right", "EXTENT_MAX_X"],
                                                           ["Top", "EXTENT_MAX_Y"]])

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

Выходная система координат, Географические преобразования, Текущая рабочая область

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

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