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

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

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

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"]])

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