Calcular atributos de geometría

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 no crean datasets de salida 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

CalculateGeometryAttributes_management (in_features, field, geometry_property, {length_unit}, {area_unit}, {coordinate_system})

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
field	El campo que se actualizará con cálculos de geometría.	Field
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.	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.	Coordinate System

Salida derivada

Nombre	Explicación	Tipo de datos
updated_features

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