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

Cuadro de diálogo

Etiqueta	Explicación	Tipo 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. 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. POINT_COORD_NOTATION—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. Pies (Estados Unidos)—La unidad de longitud será pies (Estados Unidos). Metros—La unidad de longitud será metros. Kilómetros—La 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. Acres—La unidad de área será acres. Hectáreas—La unidad de área será hectáreas. Millas cuadradas (Estados Unidos)—La unidad de área será millas cuadradas (Estados Unidos). Kilómetros cuadrados—La unidad de área será kilómetros cuadrados. Metros cuadrados—La 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 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—Grados 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 espacios—Proyección universal transversal 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	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. 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. POINT_COORD_NOTATION—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. FEET_US—La unidad de longitud será pies (Estados Unidos). METERS—La unidad de longitud será metros. KILOMETERS—La unidad de longitud será kilómetros. MILES_US—La unidad de longitud será millas (Estados Unidos). NAUTICAL_MILES—La unidad de longitud será millas náuticas (Estados Unidos). YARDS—La unidad de longitud será yardas (Estados Unidos).	String
area_unit (Opcional)	Especifica la unidad que se usará para calcular el área. ACRES—La unidad de área será acres. HECTARES—La unidad de área será hectáreas. SQUARE_MILES_US—La unidad de área será millas cuadradas (Estados Unidos). SQUARE_KILOMETERS—La unidad de área será kilómetros cuadrados. SQUARE_METERS—La unidad de área será metros cuadrados. SQUARE_FEET_US—La unidad de área será pies cuadrados (Estados Unidos). SQUARE_YARDS—La unidad de área será yardas cuadradas (Estados Unidos). SQUARE_NAUTICAL_MILES—La 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_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—Grados decimales. DMS_DIR_LAST—Grados minutos segundos con componente de dirección cardinal al final (DDD° MM' SSS.ss" <N|S|E|W>). DMS_DIR_FIRST—Grados minutos segundos con componente de dirección cardinal al principio (<N|S|E|W> DDD° MM' SSS.ss"). DMS_POS_NEG—Grados minutos segundos con componente de dirección positiva o negativa al principio (<+|-> DDD° MM' SSS.ss"). DMS_PACKED—Grados minutos segundos agrupados en un solo valor con componente de dirección positiva o negativa al principio (<+|-> DDD.MMSSSss). DDM_DIR_LAST—Grados minutos decimales con componente de dirección cardinal al final (DDD° MM.mmm' <N|S|E|W>). DDM_DIR_FIRST—Grados minutos decimales con componente de dirección cardinal al principio (<N|S|E|W> DDD° MM.mmm'). DDM_POS_NEG—Grados minutos decimales con componente de dirección positiva o negativa al principio (<+|-> DDD° MM.mmm'). GARS—El Sistema de Referencia de Área Global se basa en latitud y longitud y divide y subdivide el mundo en celdas. GEOREF—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. USNG—Cuadrícula nacional de Estados Unidos. UTM—Proyección universal transversal de Mercator. UTMNS—Proyección universal transversal 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)

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"]])

Entornos

Sistema de coordenadas de salida, Espacio de trabajo actual

Casos especiales

Información de licenciamiento

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