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 los valores m.

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.

• Los cálculos de longitud y área se expresarán en las unidades propias del sistema de coordenadas de las entidades de entrada a menos que se seleccionen otras unidades en los parámetros Unidad de longitud y Unidad de área. Si se ha especificado el parámetro 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 especifiquen otras unidades en los parámetros Unidad de longitud y Unidad de área.

  Más información sobre las unidades de longitud y área de las herramientas de geoprocesamiento

• Las propiedades de área y longitud geodésica utilizan un algoritmo que conserva la forma. Produce resultados muy precisos que no están sesgados por la suposición de que las entidades poligonales o de línea de entrada se construyen con arcos geodésicos entre los vértices, que es la suposición respecto a la longitud y el área geodésicas tradicionales.

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

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Entidades de entrada	Las entidades con un campo que se actualizará con cálculos de geometría.	Feature Layer
Atributos de geometría	Los campos en los que se calcularán las propiedades de geometría específicas. Puede seleccionar un campo existente o proporcionar un nombre de campo nuevo. Si se proporciona 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 largos, los atributos de área, longitud y coordenadas x, y, z, y los valores m se escriben en campos dobles y las notaciones de coordenadas como Grados Minutos Segundos o MGRS se escriben en campos de texto. A menos que se indique lo contrario, las propiedades de área y longitud son mediciones planares que utilizan matemáticas cartesianas 2D. Área: se agregará un atributo para almacenar el área de cada entidad poligonal. Área (geodésica): se agregará un atributo para almacenar el área geodésica que conserva su forma de cada entidad poligonal. Coordenada x centroide: se agregará un atributo para almacenar la coordenada x del centroide de cada entidad. Coordenada y centroide: se agregará un atributo para almacenar la coordenada y del centroide de cada entidad. Coordenada z centroide: se agregará un atributo para almacenar la coordenada z del centroide de cada entidad. Valor m centroide: se agregará un atributo para almacenar el valor m del centroide de cada entidad. Coordenada x del punto central: se agregará un atributo para almacenar la coordenada x de un punto central dentro o en 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. Coordenada y del punto central: se agregará un atributo para almacenar la coordenada y de un punto central dentro o en 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. Coordenada z del punto central: se agregará un atributo para almacenar la coordenada z de un punto central dentro o en 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. Valor m del punto central: se agregará un atributo para almacenar el valor m de un punto central dentro o en 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. Número de curvas: se agregará un atributo para almacenar el número de curvas de cada entidad. Las curvas incluyen arcos elípticos, arcos circulares y curvas de Bézier. Número de agujeros: se agregará un atributo para almacenar el número de agujeros interiores dentro de cada entidad poligonal. Coordenada x mínima: se agregará un atributo para almacenar la coordenada x mínima de la extensión de cada entidad. Coordenada y mínima: se agregará un atributo para almacenar la coordenada y mínima de la extensión de cada entidad. Coordenada z mínima: se agregará un atributo para almacenar la coordenada z mínima de la extensión de cada entidad. Coordenada x máxima: se agregará un atributo para almacenar la coordenada x máxima de la extensión de cada entidad. Coordenada y máxima: se agregará un atributo para almacenar la coordenada y máxima de la extensión de cada entidad. Coordenada z máxima: se agregará un atributo para almacenar la coordenada z máxima de la extensión de cada entidad. Longitud: se agregará un atributo para almacenar la longitud de cada entidad de línea. Longitud (geodésica): se agregará un atributo para almacenar la longitud geodésica que conserva la forma de cada entidad de línea. Longitud (3D): se agregará un atributo para almacenar la longitud 3D de cada entidad de línea. Rumbo de línea: se agregará un atributo para almacenar 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. Coordenada x de inicio de línea: se agregará un atributo para almacenar la coordenada x del punto de inicio de cada entidad de línea. Coordenada y de inicio de línea: se agregará un atributo para almacenar la coordenada y del punto de inicio de cada entidad de línea. Coordenada z de inicio de línea: se agregará un atributo para almacenar la coordenada z del punto de inicio de cada entidad de línea. Valor m de inicio de línea: se agregará un atributo para almacenar el valor m del punto de inicio de cada entidad de línea. Coordenada x de final de línea: se agregará un atributo para almacenar la coordenada x del punto final de cada entidad de línea. Coordenada y de final de línea: se agregará un atributo para almacenar la coordenada y del punto final de cada entidad de línea. Coordenada z de final de línea: se agregará un atributo para almacenar la coordenada z del punto final de cada entidad de línea. Valor m de final de línea: se agregará un atributo para almacenar el valor m del punto final de cada entidad de línea. Número de partes: se agregará un atributo para almacenar el número de partes que conforman cada entidad. Número de vértices: se agregará un atributo para almacenar el número de puntos o vértices que conforman cada entidad. Longitud del perímetro: se agregará un atributo para almacenar la longitud del perímetro o borde de cada entidad poligonal. Longitud del perímetro (geodésica): se agregará un atributo para almacenar la longitud geodésica que conserva su forma del perímetro o borde de cada entidad poligonal. Coordenada x de punto: se agregará un atributo para almacenar la coordenada x de cada entidad de punto. Coordenada y de punto: se agregará un atributo para almacenar la coordenada y de cada entidad de punto. Coordenada z de punto: se agregará un atributo para almacenar la coordenada z de cada entidad de punto. Valor m de punto: se agregará un atributo para almacenar el valor m de cada entidad de punto. Notación de coordenadas x e y de puntos: se agregará un atributo para almacenar las 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. Kilómetros—La unidad de longitud será kilómetros. Metros—La unidad de longitud será metros. Millas terrestres—La unidad de longitud será millas terrestres. Millas náuticas internacionales—La unidad de longitud será millas náuticas internacionales. Yardas internacionales—La unidad de longitud será yardas internacionales. Pies internacionales—La unidad de longitud será pies internacionales. Millas de agrimensura de EE. UU.—La unidad de longitud será millas topográficas de EE. UU. Millas náuticas topográficas de EE. UU.—La unidad de longitud será millas náuticas topográficas de EE. UU. Yardas de agrimensura de EE. UU.—La unidad de longitud será yardas topográficas de EE. UU. Pies de agrimensura de EE. UU.—La unidad de longitud será pies topográficos de EE. UU.	String
Unidad de área (Opcional)	Especifica la unidad que se usará para calcular el área. Kilómetros cuadrados—La unidad de área será kilómetros cuadrados. Hectáreas—La unidad de área será hectáreas. Metros cuadrados—La unidad de área será metros cuadrados. Millas terrestres cuadradas—La unidad de área será millas terrestres cuadradas. Millas náuticas cuadradas internacionales—La unidad de área será millas náuticas cuadradas internacionales. Acres internacionales—La unidad de área será acres internacionales. Yardas cuadradas internacionales—La unidad de área será yardas cuadradas internacionales. Pies cuadrados internacionales—La unidad de área será pies cuadrados internacionales. Millas cuadradas de agrimensura de EE. UU.—La unidad de área será millas cuadradas topográficas de EE. UU. Millas náuticas cuadradas topográficas de EE. UU.—La unidad de área será millas náuticas cuadradas topográficas de EE. UU. Acres topográficos de EE. UU.—La unidad de área será acres topográficos de EE. UU. Yardas cuadradas de agrimensura de EE. UU.—La unidad de área será yardas cuadradas topográficas de EE. UU. Pies cuadrados de agrimensura de EE. UU.—La unidad de área será pies cuadrados topográficos de EE. UU.	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.	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 entrada—Las unidades de referencia espacial de las entidades de entrada se utilizarán para formatear las coordenadas. Esta es la opción predeterminada. Grados decimales—El formato de las coordenadas será grados decimales. Grados minutos segundos (DDD° MM' SSS.ss" <N|S|E|W>)—El formato de las coordenadas será 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")—El formato de las coordenadas será 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")—El formato de las coordenadas será Grados Minutos Segundos con componente de dirección positiva o negativa al principio (<+|-> DDD° MM' SSS.ss"). Grados minutos segundos (<+|-> DDD.MMSSSss)—El formato de las coordenadas será 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>)—El formato de las coordenadas será 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')—El formato de las coordenadas será Grados Minutos decimales con componente de dirección cardinal al principio (<N|S|E|W> DDD° MM.mmm'). Grados minutos decimales (<+|-> DDD° MM.mmm')—El formato de las coordenadas será Grados Minutos decimales con componente de dirección positiva o negativa al principio (<+|-> DDD° MM.mmm'). GARS (Sistema de Referencia de Área Global)—El formato de las coordenadas será el 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 formato de las coordenadas será el 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.)—El formato de las coordenadas será el Sistema de Referencia de Cuadrícula Militar. USNG (Cuadrícula Cartográfica Nacional de EE. UU)—El formato de las coordenadas será la Cuadrícula Nacional de Estados Unidos. UTM (Proyección Universal Transversal de Mercator)—El formato de las coordenadas será la Proyección Universal Transversa de Mercator. UTM sin espacios—El formato de las coordenadas será la Proyección Universal Transversa de Mercator sin espacios.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Entidades actualizadas	Las entidades de entrada actualizadas.	Feature Layer

Python

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

Nombre	Explicación	Tipo de datos
in_features	Las entidades con un campo que se actualizará con cálculos de geometría.	Feature Layer
geometry_property [[Field, Property],...]	Los campos en los que se calcularán las propiedades de geometría específicas. Puede seleccionar un campo existente o proporcionar un nombre de campo nuevo. Si se proporciona 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 largos, los atributos de área, longitud y coordenadas x, y, z, y los valores m se escriben en campos dobles y las notaciones de coordenadas como Grados Minutos Segundos o MGRS se escriben en campos de texto. A menos que se indique lo contrario, las propiedades de área y longitud son mediciones planares que utilizan matemáticas cartesianas 2D. AREA: se agregará un atributo para almacenar el área de cada entidad poligonal. AREA_GEODESIC: se agregará un atributo para almacenar el área geodésica que conserva su forma de cada entidad poligonal. CENTROID_X: se agregará un atributo para almacenar la coordenada x del centroide de cada entidad. CENTROID_Y: se agregará un atributo para almacenar la coordenada y del centroide de cada entidad. CENTROID_Z: se agregará un atributo para almacenar la coordenada z del centroide de cada entidad. CENTROID_M: se agregará un atributo para almacenar el valor m del centroide de cada entidad. INSIDE_X: se agregará un atributo para almacenar la coordenada x de un punto central dentro o en 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: se agregará un atributo para almacenar la coordenada y de un punto central dentro o en 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: se agregará un atributo para almacenar la coordenada z de un punto central dentro o en 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: se agregará un atributo para almacenar el valor m de un punto central dentro o en 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: se agregará un atributo para almacenar el número de curvas de cada entidad. Las curvas incluyen arcos elípticos, arcos circulares y curvas de Bézier. HOLE_COUNT: se agregará un atributo para almacenar el número de agujeros interiores dentro de cada entidad poligonal. EXTENT_MIN_X: se agregará un atributo para almacenar la coordenada x mínima de la extensión de cada entidad. EXTENT_MIN_Y: se agregará un atributo para almacenar la coordenada y mínima de la extensión de cada entidad. EXTENT_MIN_Z: se agregará un atributo para almacenar la coordenada z mínima de la extensión de cada entidad. EXTENT_MAX_X: se agregará un atributo para almacenar la coordenada x máxima de la extensión de cada entidad. EXTENT_MAX_Y: se agregará un atributo para almacenar la coordenada y máxima de la extensión de cada entidad. EXTENT_MAX_Z: se agregará un atributo para almacenar la coordenada z máxima de la extensión de cada entidad. LENGTH: se agregará un atributo para almacenar la longitud de cada entidad de línea. LENGTH_GEODESIC: se agregará un atributo para almacenar la longitud geodésica que conserva la forma de cada entidad de línea. LENGTH_3D: se agregará un atributo para almacenar la longitud 3D de cada entidad de línea. LINE_BEARING: se agregará un atributo para almacenar 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: se agregará un atributo para almacenar la coordenada x del punto de inicio de cada entidad de línea. LINE_START_Y: se agregará un atributo para almacenar la coordenada y del punto de inicio de cada entidad de línea. LINE_START_Z: se agregará un atributo para almacenar la coordenada z del punto de inicio de cada entidad de línea. LINE_START_M: se agregará un atributo para almacenar el valor m del punto de inicio de cada entidad de línea. LINE_END_X: se agregará un atributo para almacenar la coordenada x del punto final de cada entidad de línea. LINE_END_Y: se agregará un atributo para almacenar la coordenada y del punto final de cada entidad de línea. LINE_END_Z: se agregará un atributo para almacenar la coordenada z del punto final de cada entidad de línea. LINE_END_M: se agregará un atributo para almacenar el valor m del punto final de cada entidad de línea. PART_COUNT: se agregará un atributo para almacenar el número de partes que conforman cada entidad. POINT_COUNT: se agregará un atributo para almacenar el número de puntos o vértices que conforman cada entidad. PERIMETER_LENGTH: se agregará un atributo para almacenar la longitud del perímetro o borde de cada entidad poligonal. PERIMETER_LENGTH_GEODESIC: se agregará un atributo para almacenar la longitud geodésica que conserva su forma del perímetro o borde de cada entidad poligonal. POINT_X: se agregará un atributo para almacenar la coordenada x de cada entidad de punto. POINT_Y: se agregará un atributo para almacenar la coordenada y de cada entidad de punto. POINT_Z: se agregará un atributo para almacenar la coordenada z de cada entidad de punto. POINT_M: se agregará un atributo para almacenar el valor m de cada entidad de punto. POINT_COORD_NOTATION: se agregará un atributo para almacenar las 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. KILOMETERS—La unidad de longitud será kilómetros. METERS—La unidad de longitud será metros. MILES_INT—La unidad de longitud será millas terrestres. NAUTICAL_MILES_INT—La unidad de longitud será millas náuticas internacionales. YARDS_INT—La unidad de longitud será yardas internacionales. FEET_INT—La unidad de longitud será pies internacionales. MILES_US—La unidad de longitud será millas topográficas de EE. UU. NAUTICAL_MILES—La unidad de longitud será millas náuticas topográficas de EE. UU. YARDS—La unidad de longitud será yardas topográficas de EE. UU. FEET_US—La unidad de longitud será pies topográficos de EE. UU.	String
area_unit (Opcional)	Especifica la unidad que se usará para calcular el área. SQUARE_KILOMETERS—La unidad de área será kilómetros cuadrados. HECTARES—La unidad de área será hectáreas. SQUARE_METERS—La unidad de área será metros cuadrados. SQUARE_MILES_INT—La unidad de área será millas terrestres cuadradas. SQUARE_NAUTICAL_MILES—La unidad de área será millas náuticas cuadradas internacionales. ACRES—La unidad de área será acres internacionales. SQUARE_YARDS—La unidad de área será yardas cuadradas internacionales. SQUARE_FEET_INT—La unidad de área será pies cuadrados internacionales. SQUARE_MILES_US—La unidad de área será millas cuadradas topográficas de EE. UU. SQUARE_NAUTICAL_MILES_US—La unidad de área será millas náuticas cuadradas topográficas de EE. UU. ACRES_US—La unidad de área será acres topográficos de EE. UU. SQUARE_YARDS_US—La unidad de área será yardas cuadradas topográficas de EE. UU. SQUARE_FEET_US—La unidad de área será pies cuadrados topográficos de EE. UU.	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
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_INPUT—Las unidades de referencia espacial de las entidades de entrada se utilizarán para formatear las coordenadas. Esta es la opción predeterminada. DD—El formato de las coordenadas será grados decimales. DMS_DIR_LAST—El formato de las coordenadas será Grados Minutos Segundos con componente de dirección cardinal al final (DDD° MM' SSS.ss" <N|S|E|W>). DMS_DIR_FIRST—El formato de las coordenadas será Grados Minutos Segundos con componente de dirección cardinal al principio (<N|S|E|W> DDD° MM' SSS.ss"). DMS_POS_NEG—El formato de las coordenadas será Grados Minutos Segundos con componente de dirección positiva o negativa al principio (<+|-> DDD° MM' SSS.ss"). DMS_PACKED—El formato de las coordenadas será Grados Minutos Segundos agrupados en un solo valor con componente de dirección positiva o negativa al principio (<+|-> DDD.MMSSSss). DDM_DIR_LAST—El formato de las coordenadas será Grados Minutos decimales con componente de dirección cardinal al final (DDD° MM.mmm' <N|S|E|W>). DDM_DIR_FIRST—El formato de las coordenadas será Grados Minutos decimales con componente de dirección cardinal al principio (<N|S|E|W> DDD° MM.mmm'). DDM_POS_NEG—El formato de las coordenadas será Grados Minutos decimales con componente de dirección positiva o negativa al principio (<+|-> DDD° MM.mmm'). GARS—El formato de las coordenadas será el 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—El formato de las coordenadas será el 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—El formato de las coordenadas será el Sistema de Referencia de Cuadrícula Militar. USNG—El formato de las coordenadas será la Cuadrícula Nacional de Estados Unidos. UTM—El formato de las coordenadas será la Proyección Universal Transversa de Mercator. UTMNS—El formato de las coordenadas será la Proyección Universal Transversa de Mercator sin espacios.	String

Salida derivada

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

Muestra de código

Ejemplo de CalculateGeometryAttributes (ventana de Python)

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

import arcpy
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.management.CalculateGeometryAttributes("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.management.CalculateGeometryAttributes(in_features, [["Left", "EXTENT_MIN_X"],
                                                           ["Bottom", "EXTENT_MIN_Y"],
                                                           ["Right", "EXTENT_MAX_X"],
                                                           ["Top", "EXTENT_MAX_Y"]])

Entornos

Sistema de coordenadas de salida, Transformaciones geográficas, Espacio de trabajo actual