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ámetroExplicaciónTipo 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:

  • AREAEl área de cada entidad poligonal.
  • AREA_GEODESICEl área geodésica que conserva su forma de cada entidad poligonal.
  • CENTROID_XLa coordenada x centroide de cada entidad.
  • CENTROID_YLa coordenada y centroide de cada entidad.
  • CENTROID_ZLa coordenada z centroide de cada entidad.
  • CENTROID_MLa coordenada m centroide de cada entidad.
  • INSIDE_XLa 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_YLa 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_ZLa 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_MLa 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_COUNTEl número de curvas de cada entidad. Las curvas incluyen arcos elípticos, arcos circulares y curvas de Bézier.
  • HOLE_COUNTEl número de agujeros interiores dentro de cada entidad poligonal.
  • EXTENT_MIN_XLa coordenada x mínima de la extensión de cada entidad.
  • EXTENT_MIN_YLa coordenada y mínima de la extensión de cada entidad.
  • EXTENT_MIN_ZLa coordenada z mínima de la extensión de cada entidad.
  • EXTENT_MAX_XLa coordenada x máxima de la extensión de cada entidad.
  • EXTENT_MAX_YLa coordenada y máxima de la extensión de cada entidad.
  • EXTENT_MAX_ZLa coordenada z máxima de la extensión de cada entidad.
  • LENGTHLa longitud de cada entidad de línea.
  • LENGTH_GEODESICLa longitud geodésica que conserva su forma de cada entidad de línea.
  • LENGTH_3DLa longitud 3D de cada entidad de línea.
  • LINE_BEARINGEl 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_XLa coordenada x del punto inicial de cada entidad de línea.
  • LINE_START_YLa coordenada y del punto inicial de cada entidad de línea.
  • LINE_START_ZLa coordenada z del punto inicial de cada entidad de línea.
  • LINE_START_MLa coordenada m del punto inicial de cada entidad de línea.
  • LINE_END_XLa coordenada x del extremo de cada entidad de línea.
  • LINE_END_YLa coordenada y del extremo de cada entidad de línea.
  • LINE_END_ZLa coordenada z del extremo de cada entidad de línea.
  • LINE_END_MLa coordenada m del extremo de cada entidad de línea.
  • PART_COUNTEl número de partes que conforman cada entidad.
  • PERIMETER_LENGTHLa longitud del perímetro o borde de cada entidad poligonal.
  • PERIMETER_LENGTH_GEODESICLa longitud geodésica que conserva su forma del perímetro o borde de cada entidad poligonal.
  • POINT_COUNTEl número de puntos o vértices que conforman cada entidad.
  • POINT_XLa coordenada x de cada entidad de punto.
  • POINT_YLa coordenada y de cada entidad de punto.
  • POINT_ZLa coordenada z de cada entidad de punto.
  • POINT_MLa coordenada m de cada entidad de punto.
  • POINT_COORD_NOTATIONLas 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_USLongitud en pies (Estados Unidos)
  • METERSLongitud en metros
  • KILOMETERSLongitud en kilómetros
  • MILES_USLongitud en millas (Estados Unidos)
  • NAUTICAL_MILESLongitud en millas náuticas (Estados Unidos)
  • YARDSLongitud 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_INPUTLas unidades de referencia espacial de las entidades de entrada se utilizan para formatear las coordenadas. Esta es la opción predeterminada.
  • DDGrados decimales.
  • DMS_DIR_LASTGrados minutos segundos con componente de dirección cardinal al final (DDD° MM' SSS.ss" <N|S|E|W>).
  • DMS_DIR_FIRSTGrados minutos segundos con componente de dirección cardinal al principio (<N|S|E|W> DDD° MM' SSS.ss").
  • DMS_POS_NEGGrados minutos segundos con componente de dirección positiva o negativa al principio (<+|-> DDD° MM' SSS.ss").
  • DMS_PACKEDGrados minutos segundos agrupados en un solo valor con componente de dirección positiva o negativa al principio (<+|-> DDD.MMSSSss).
  • DDM_DIR_LASTGrados minutos decimales con componente de dirección cardinal al final (DDD° MM.mmm' <N|S|E|W>).
  • DDM_DIR_FIRSTGrados minutos decimales con componente de dirección cardinal al principio (<N|S|E|W> DDD° MM.mmm').
  • DDM_POS_NEGGrados minutos decimales con componente de dirección positiva o negativa al principio (<+|-> DDD° MM.mmm').
  • GARSEl Sistema de Referencia de Área Global se basa en latitud y longitud y divide y subdivide el mundo en celdas.
  • GEOREFEl 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.
  • MGRSSistema de Referencia de Cuadrícula Militar.
  • USNGCuadrícula nacional de Estados Unidos.
  • UTMProyección universal transversal de Mercator.
  • UTMNSProyección universal transversal de Mercator sin espacios.
String

Salida derivada

NombreExplicaciónTipo 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"]])

Información de licenciamiento

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

Temas relacionados