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.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

La capa de entidades con un campo que se actualizará con cálculos de geometría.

Feature Layer
Atributos de geometría

Especifica los campos en los que se calcularán las propiedades de geometría seleccionadas.

Puede seleccionar un campo existente o proporcionar un nombre de campo nuevo. Si se especifica un nuevo nombre de campo, el tipo de campo viene determinado por el tipo de valores que se escriben en el campo.

  • Los atributos de recuento se escriben en campos de tipo entero largo.
  • Los atributos de área, longitud y coordenadas x, y, z y m se escriben en campos dobles.
  • Las notaciones de coordenadas como Grados Minutos Segundos o MGRS se escriben en campos de texto.

  • 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
Unidad de longitud
(Opcional)

Especifica la unidad que se utilizará para calcular la longitud.

  • Pies (Estados Unidos)La unidad de longitud será pies (Estados Unidos).
  • MetrosLa unidad de longitud será metros.
  • KilómetrosLa unidad de longitud será kilómetros.
  • Millas (Estados Unidos)La unidad de longitud será millas (Estados Unidos).
  • Millas náuticas (Estados Unidos)La unidad de longitud será millas náuticas (Estados Unidos).
  • Yardas (Estados Unidos)La unidad de longitud será yardas (Estados Unidos).
String
Unidad de área
(Opcional)

Especifica la unidad que se usará para calcular el área.

  • AcresLa unidad de área será acres.
  • HectáreasLa unidad de área será hectáreas.
  • Millas cuadradas (Estados Unidos)La unidad de área será millas cuadradas (Estados Unidos).
  • Kilómetros cuadradosLa unidad de área será kilómetros cuadrados.
  • Metros cuadradosLa unidad de área será metros cuadrados.
  • Pies cuadrados (Estados Unidos)La unidad de área será pies cuadrados (Estados Unidos).
  • Yardas cuadradas (Estados Unidos)La unidad de área será yardas cuadradas (Estados Unidos).
  • Millas náuticas cuadradas (Estados Unidos)La unidad de área será millas náuticas cuadradas (Estados Unidos).
String
Sistema de coordenadas
(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 WGS84.

Coordinate System
Formato de coordenadas
(Opcional)

Especifica 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.

  • Igual que la entradaLas unidades de referencia espacial de las entidades de entrada se utilizarán para formatear las coordenadas. Esta es la opción predeterminada.
  • Grados decimalesGrados decimales.
  • Grados minutos segundos (DDD° MM' SSS.ss" <N|S|E|W>)Grados minutos segundos con componente de dirección cardinal al final (DDD° MM' SSS.ss" <N|S|E|W>).
  • Grados minutos segundos (<N|S|E|W> DDD° MM' SSS.ss")Grados minutos segundos con componente de dirección cardinal al principio (<N|S|E|W> DDD° MM' SSS.ss").
  • Grados minutos segundos (<+|-> DDD° MM' SSS.ss")Grados minutos segundos con componente de dirección positiva o negativa al principio (<+|-> DDD° MM' SSS.ss").
  • Grados minutos segundos (<+|-> DDD.MMSSSss)Grados minutos segundos agrupados en un solo valor con componente de dirección positiva o negativa al principio (<+|-> DDD.MMSSSss).
  • Grados minutos decimales (DDD° MM.mmm' <N|S|E|W>)Grados minutos decimales con componente de dirección cardinal al final (DDD° MM.mmm' <N|S|E|W>).
  • Grados minutos decimales (<N|S|E|W> DDD° MM.mmm')Grados minutos decimales con componente de dirección cardinal al principio (<N|S|E|W> DDD° MM.mmm').
  • Grados minutos decimales (<+|-> DDD° MM.mmm')Grados minutos decimales con componente de dirección positiva o negativa al principio (<+|-> DDD° MM.mmm').
  • GARS (Sistema de Referencia de Área Global)El Sistema de Referencia de Área Global se basa en latitud y longitud y divide y subdivide el mundo en celdas.
  • GEOREF (Sistema de referencia geográfica mundial)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 de EE.UU.)Sistema de Referencia de Cuadrícula Militar.
  • USNG (Cuadrícula Cartográfica Nacional de EE. UU)Cuadrícula nacional de Estados Unidos.
  • UTM (Proyección Universal Transversal de Mercator)Proyección universal transversal de Mercator.
  • UTM sin espaciosProyección universal transversal de Mercator sin espacios.
String

Salida derivada

EtiquetaExplicaciónTipo de datos
Entidades actualizadas

Las entidades de entrada actualizadas.

Feature Layer

arcpy.management.CalculateGeometryAttributes(in_features, geometry_property, {length_unit}, {area_unit}, {coordinate_system}, {coordinate_format})
NombreExplicació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
[[Field, Property],...]

Especifica los campos en los que se calcularán las propiedades de geometría seleccionadas.

Puede seleccionar un campo existente o proporcionar un nombre de campo nuevo. Si se especifica un nuevo nombre de campo, el tipo de campo viene determinado por el tipo de valores que se escriben en el campo.

  • Los atributos de recuento se escriben en campos de tipo entero largo.
  • Los atributos de área, longitud y coordenadas x, y, z y m se escriben en campos dobles.
  • Las notaciones de coordenadas como Grados Minutos Segundos o MGRS se escriben en campos de texto.

  • 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)

Especifica la unidad que se utilizará para calcular la longitud.

  • FEET_USLa unidad de longitud será pies (Estados Unidos).
  • METERSLa unidad de longitud será metros.
  • KILOMETERSLa unidad de longitud será kilómetros.
  • MILES_USLa unidad de longitud será millas (Estados Unidos).
  • NAUTICAL_MILESLa unidad de longitud será millas náuticas (Estados Unidos).
  • YARDSLa unidad de longitud será yardas (Estados Unidos).
String
area_unit
(Opcional)

Especifica la unidad que se usará para calcular el área.

  • ACRESLa unidad de área será acres.
  • HECTARESLa unidad de área será hectáreas.
  • SQUARE_MILES_USLa unidad de área será millas cuadradas (Estados Unidos).
  • SQUARE_KILOMETERSLa unidad de área será kilómetros cuadrados.
  • SQUARE_METERSLa unidad de área será metros cuadrados.
  • SQUARE_FEET_USLa unidad de área será pies cuadrados (Estados Unidos).
  • SQUARE_YARDSLa unidad de área será yardas cuadradas (Estados Unidos).
  • SQUARE_NAUTICAL_MILESLa unidad de área será 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 WGS84.

Coordinate System
coordinate_format
(Opcional)

Especifica 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 utilizarán 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.

Feature Layer

Muestra de código

Ejemplo de CalculateGeometryAttributes (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función 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