Calcular atributos de geometría (Administración de datos)

Resumen

Agrega información a campos de atributos de una entidad que representan las características espaciales o geométricas y la ubicación de cada entidad, como la longitud o el área y las coordenadas x, y, z y m.

Una herramienta similar que agrega varios atributos de geometría a nuevos campos de atributos es la herramienta Agregar atributos de geometría.

Uso

Precaución:

Esta herramienta modifica los datos de entrada. Consulte Herramientas que modifican o actualizan los datos de entrada para obtener más información y estrategias para evitar cambios de datos no deseados.

• Si se ha especificado un sistema de coordenadas, los cálculos de longitud y área se expresarán en las unidades propias de ese sistema de coordenadas a menos que se seleccionen otras unidades en los parámetros Unidad de longitud y Unidad de área.

• Si existe una selección en las entidades de entrada, solamente las entidades seleccionadas tendrán valores calculados en los campos agregados. Las demás mantendrán el valor que ya tengan.

• Esta herramienta funciona con clases de entidad de punto, multipunto, polilínea y polígono.

Sintaxis

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

Parámetro	Explicación	Tipo de datos
in_features	La capa de entidades con un campo que se actualizará con cálculos de geometría.	Feature Layer
geometry_property [[Target Field, Property],...]	Especifica los campos en los que calcular las propiedades de geometría y las propiedades que hay que calcular. A continuación, se muestran propiedades de geometría compatibles: AREA —El área de cada entidad poligonal. AREA_GEODESIC —El área geodésica que conserva su forma de cada entidad poligonal. CENTROID_X —La coordenada x centroide de cada entidad. CENTROID_Y —La coordenada y centroide de cada entidad. CENTROID_Z —La coordenada z centroide de cada entidad. CENTROID_M —La coordenada m centroide de cada entidad. INSIDE_X —La coordenada x de un punto central dentro o sobre cada entidad. Este punto es el mismo que el centroide, siempre que el centroide esté dentro de la entidad; de lo contrario, es un punto de etiqueta interior. INSIDE_Y —La coordenada y de un punto central dentro o sobre cada entidad. Este punto es el mismo que el centroide, siempre que el centroide esté dentro de la entidad; de lo contrario, es un punto de etiqueta interior. INSIDE_Z —La coordenada z de un punto central dentro o sobre cada entidad. Este punto es el mismo que el centroide, siempre que el centroide esté dentro de la entidad; de lo contrario, es un punto de etiqueta interior. INSIDE_M —La coordenada m de un punto central dentro o sobre cada entidad. Este punto es el mismo que el centroide, siempre que el centroide esté dentro de la entidad; de lo contrario, es un punto de etiqueta interior. CURVE_COUNT —El número de curvas de cada entidad. Las curvas incluyen arcos elípticos, arcos circulares y curvas de Bézier. HOLE_COUNT —El número de agujeros interiores dentro de cada entidad poligonal. EXTENT_MIN_X —La coordenada x mínima de la extensión de cada entidad. EXTENT_MIN_Y —La coordenada y mínima de la extensión de cada entidad. EXTENT_MIN_Z —La coordenada z mínima de la extensión de cada entidad. EXTENT_MAX_X —La coordenada x máxima de la extensión de cada entidad. EXTENT_MAX_Y —La coordenada y máxima de la extensión de cada entidad. EXTENT_MAX_Z —La coordenada z máxima de la extensión de cada entidad. LENGTH —La longitud de cada entidad de línea. LENGTH_GEODESIC —La longitud geodésica que conserva su forma de cada entidad de línea. LENGTH_3D —La longitud 3D de cada entidad de línea. LINE_BEARING —El rumbo de principio a fin de cada entidad de línea. Los valores están entre 0 y 360, donde 0 apunta hacia el norte, 90 hacia el este, 180 hacia el sur, 270 hacia el oeste, etc. LINE_START_X —La coordenada x del punto inicial de cada entidad de línea. LINE_START_Y —La coordenada y del punto inicial de cada entidad de línea. LINE_START_Z —La coordenada z del punto inicial de cada entidad de línea. LINE_START_M —La coordenada m del punto inicial de cada entidad de línea. LINE_END_X —La coordenada x del extremo de cada entidad de línea. LINE_END_Y —La coordenada y del extremo de cada entidad de línea. LINE_END_Z —La coordenada z del extremo de cada entidad de línea. LINE_END_M —La coordenada m del extremo de cada entidad de línea. PART_COUNT —El número de partes que conforman cada entidad. PERIMETER_LENGTH —La longitud del perímetro o borde de cada entidad poligonal. PERIMETER_LENGTH_GEODESIC —La longitud geodésica que conserva su forma del perímetro o borde de cada entidad poligonal. POINT_COUNT —El número de puntos o vértices que conforman cada entidad. POINT_X —La coordenada x de cada entidad de punto. POINT_Y —La coordenada y de cada entidad de punto. POINT_Z —La coordenada z de cada entidad de punto. POINT_M —La coordenada m de cada entidad de punto. POINT_COORD_NOTATION —Las coordenadas x e y de cada entidad de punto formateada como una notación de coordenadas especificada.	Value Table
length_unit (Opcional)	La unidad utilizada para calcular la longitud. FEET_US —Longitud en pies (Estados Unidos) METERS —Longitud en metros KILOMETERS —Longitud en kilómetros MILES_US —Longitud en millas (Estados Unidos) NAUTICAL_MILES —Longitud en millas náuticas (Estados Unidos) YARDS —Longitud en yardas (Estados Unidos)	String
area_unit (Opcional)	La unidad utilizada para calcular el área. ACRES —Área en acres HECTARES —Área en hectáreas SQUARE_MILES_US —Área en millas cuadradas (Estados Unidos) SQUARE_KILOMETERS —Área en kilómetros cuadrados SQUARE_METERS —Área en metros cuadrados SQUARE_FEET_US —Área en pies cuadrados (Estados Unidos) SQUARE_YARDS —Área en yardas cuadradas (Estados Unidos) SQUARE_NAUTICAL_MILES —Área en millas náuticas cuadradas (Estados Unidos)	String
coordinate_system (Opcional)	Sistema de coordenadas en el cual se calcularán las coordenadas, la longitud y el área. De forma predeterminada se utiliza el sistema de coordenadas de las entidades de entrada. En el caso de las propiedades de geometría basadas en coordenadas, el sistema de coordenadas solamente se aplicará si el formato de coordenadas coincide con el de la entrada; de lo contrario, se usará el sistema de coordenadas geográficas WGS_1984.	Coordinate System
coordinate_format (Opcional)	El formato de coordenadas en el que se calcularán las coordenadas x e y. Se utiliza de forma predeterminada el formato de coordenadas que coincida con las unidades de referencia espacial de las entidades de entrada. Varios formatos de coordenadas, incluidos Grados minutos segundos, Grados minutos decimales y otros, requieren que el cálculo se realice en un campo de texto. SAME_AS_INPUT —Las unidades de referencia espacial de las entidades de entrada se utilizan para formatear las coordenadas. Esta es la opción predeterminada. DD —Grados decimales. DMS_DIR_LAST —Grados minutos segundos con componente de dirección cardinal al final (DDD° MM' SSS.ss" <N|S|E|W>). DMS_DIR_FIRST —Grados minutos segundos con componente de dirección cardinal al principio (<N|S|E|W> DDD° MM' SSS.ss"). DMS_POS_NEG —Grados minutos segundos con componente de dirección positiva o negativa al principio (<+|-> DDD° MM' SSS.ss"). DMS_PACKED —Grados minutos segundos agrupados en un solo valor con componente de dirección positiva o negativa al principio (<+|-> DDD.MMSSSss). DDM_DIR_LAST —Grados minutos decimales con componente de dirección cardinal al final (DDD° MM.mmm' <N|S|E|W>). DDM_DIR_FIRST —Grados minutos decimales con componente de dirección cardinal al principio (<N|S|E|W> DDD° MM.mmm'). DDM_POS_NEG —Grados minutos decimales con componente de dirección positiva o negativa al principio (<+|-> DDD° MM.mmm'). GARS —El Sistema de Referencia de Área Global se basa en latitud y longitud y divide y subdivide el mundo en celdas. GEOREF —El Sistema de Referencia Geográfica Mundial se basa en el sistema geográfico de latitud y longitud, pero utiliza una notación más sencilla y flexible. MGRS —Sistema de Referencia de Cuadrícula Militar. USNG —Cuadrícula nacional de Estados Unidos. UTM —Proyección universal transversal de Mercator. UTMNS —Proyección universal transversal de Mercator sin espacios.	String

Salida derivada

Nombre	Explicación	Tipo de datos
updated_features	Las entidades de entrada actualizadas.	Capa de entidades

Muestra de código

Ejemplo de CalculateGeometryAttributes (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la herramienta CalculateGeometryAttributes.

import arcpy
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.CalculateGeometryAttributes_management("roads", [["Length_mi", "LENGTH"], ["Stops", "POINT_COUNT"]], "MILES_US")

Ejemplo de CalculateGeometryAttributes (script independiente)

Obtener el rectángulo de extensión de cada entidad.

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

Entornos

Sistema de coordenadas de salida, Espacio de trabajo actual

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí