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
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.
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.
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:
| Value Table |
length_unit (Opcional) | La unidad utilizada para calcular la longitud.
| String |
area_unit (Opcional) | La unidad utilizada para calcular el área.
| 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.
| String |
Salida derivada
Nombre | Explicación | Tipo de datos |
updated_features | Las entidades de entrada actualizadas. | Capa de entidades |
Muestra de código
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")
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"]])
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí