Calcular la regla de atributos de campos de geometría (Administración de datos)

Resumen

Genera una regla de atributo que calcula la información geométrica de una entidad y la escribe en un campo determinado. Los atributos geométricos representan las entidades espaciales o geométricas y la ubicación de cada elemento, como la longitud o el área y las coordenadas x, y, z y los valores m.

Uso

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

• El parámetro opcional de formato de coordenadas requiere que la referencia espacial de las tablas de entrada sea un sistema de coordenadas geográficas.

• La herramienta no se ejecutará si se está editando la clase de entrada.

• Las reglas creadas con esta herramienta están configuradas para activarse solo cuando se edita el campo SHAPE y los campos establecidos como objetivo para los cálculos geométricos.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Tabla de entrada	La tabla o clase de entidad a la que se aplicará la nueva regla.	Feature Layer; Annotation Layer; Dimension Layer; Oriented Imagery Layer; Catalog Layer
Carpeta de salida	La carpeta en la que se guarda la salida.	Folder
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 enteros largos; los atributos de área, longitud y coordenadas x, y, z y valor 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. Ángulo de línea: se agregará un atributo para almacenar el ángulo aritmético de principio a fin de cada entidad de línea. Los valores oscilan entre 0 y 360, donde 0 significa este, 90 norte, 180 oeste, 270 sur, y así sucesivamente. 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 comprende cada entidad. Número de vértices: se agregará un atributo para almacenar el número de puntos o vértices que comprende 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
Expresión (Opcional)	Una expresión SQL que se utilizará para limitar las entidades de la entrada que participarán en la regla de atributo.	SQL Expression
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
Formato 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.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
CSV de regla de salida	El archivo .csv que tendrá la regla de atributo.	File

Python

arcpy.management.CalculateGeometryFieldsAttributeRule(in_table, out_folder, geometry_attributes, {where_clause}, {length_unit}, {area_unit}, {coordinate_format})

Nombre	Explicación	Tipo de datos
in_table	La tabla o clase de entidad a la que se aplicará la nueva regla.	Feature Layer; Annotation Layer; Dimension Layer; Oriented Imagery Layer; Catalog Layer
out_folder	La carpeta en la que se guarda la salida.	Folder
geometry_attributes [geometry_attributes,...]	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 enteros largos; los atributos de área, longitud y coordenadas x, y, z y valor 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_ANGLE: se agregará un atributo para almacenar el ángulo aritmético 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 comprende cada entidad. POINT_COUNT: se agregará un atributo para almacenar el número de puntos o vértices que comprende 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
where_clause (Opcional)	Una expresión SQL que se utilizará para limitar las entidades de la entrada que participarán en la regla de atributo.	SQL Expression
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_format (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.	String

Salida derivada

Nombre	Explicación	Tipo de datos
out_rule_csv	El archivo .csv que tendrá la regla de atributo.	File

Muestra de código

CalculateGeometryFieldsAttributeRule example (ventana de Python)

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

import arcpy
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.management.CalculateGeometryFieldsAttributeRule(
    in_table="test_class",
    out_folder=r"C:\temp", 
    geometry_attributes="area_field AREA_GEODESIC",
    where_clause="OBJECTID = 1",
    length_unit="",
    area_unit="SQUARE_MILES_US",
    coordinate_format=""
)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.