Identidad (Análisis)
Resumen
Calcula una intersección geométrica de las entidades de entrada y las entidades de identidad. Las entidades de entrada o partes de ellas que se superpongan a entidades de identidad obtendrán los atributos de esas entidades de identidad.
Ilustración
Uso
-
Las Entidades de Entrada pueden ser de punto, multipunto, línea o polígono. Las entradas no pueden ser entidades de anotación, entidades de dimensión o entidades de red.
-
las Entidades de identidad deben ser polígonos o tener el mismo tipo de geometría que las Entidades de Entrada.
-
Cuando se utiliza esta herramienta con entradas y punto y Entidades de identidad de polígono, los puntos que caen directamente sobre el límite de un polígono se agregan dos veces al resultado; una vez para cada polígono que forme parte del límite. Al ejecutar la herramienta Intersecar en la salida de este escenario se identifican los puntos duplicados, para poder decidir cuáles se conservan.
-
Si se activa o se establece el parámetro Mantener las relaciones en KEEP_RELATIONSHIPS, se escribirán relaciones espaciales adicionales entre las Entidades de Entrada y las Entidades de identidad en la clase de entidad de salida. Si las entradas son líneas y las Entidades de identidad son polígonos, habrá dos campos adicionales: LEFT_poly y RIGHT_poly. Estos nuevos campos contendrán el FID de las entidades de identidad de polígonos a la derecha y a la izquierda de cada entidad de línea de entrada.
-
Los valores de los atributos de las clases de entidad de entrada se copiarán en la clase de entidad de salida. Sin embargo, si la entrada son capas creadas por la herramienta Crear capa de entidades y el campo "Utilizar política de relación" está activado, se calculará una proporción del valor del atributo de entrada para el valor del atributo de salida. Cuando "Utilizar política de relación" está activado, cada vez que se divida una entidad en una operación de superposición, los atributos de las entidades resultantes serán una proporción del valor del atributo de la entidad de entrada. El valor de salida se basa en la proporción en la que se dividió la geometría de la entidad de entrada. Por ejemplo, si la geometría de entrada se dividió por igual, el valor del atributo de cada nueva entidad recibirá la mitad del valor del atributo de la entidad de entrada. "Utilizar política de relación" solo se aplica a tipos de campo numéricos.
Precaución:Las herramientas de geoprocesamiento no respetan las directivas de división de campos de tablas o clases de entidad de geodatabase.
-
Esta herramienta utilizará un proceso de ordenamiento en tesela para controlar datasets muy grandes para mejorar el rendimiento y la escalabilidad. Para obtener información más detallada, vea Geoprocesamiento con datasets grandes.
-
Esta herramienta puede generar entidades multiparte en la salida aunque todas las entradas tengan una única parte. Si no se desea tener entidades multiparte, utilice la herramienta De multiparte a parte simple sobre la clase de entidad de salida.
Sintaxis
Parámetro | Explicación | Tipo de datos |
in_features |
La capa o clase de entidad de entrada. | Feature Layer |
identity_features |
La capa o clase de entidad de identidad. Debe ser polígonos o el mismo tipo de geometría que las Entidades de Entrada. | Feature Layer |
out_feature_class |
La clase de entidad que se creará y en la que se escribirán los resultados. | Feature Class |
join_attributes (Opcional) |
Determina qué atributos se transferirán a la clase de entidad de salida.
| String |
cluster_tolerance (Opcional) |
La distancia mínima que separa todas las coordenadas de la entidad (nodos y vértices), así como la distancia que una coordenada se puede mover en X o Y (o ambas). | Linear unit |
relationship (Opcional) |
Elija si desea que las relaciones espaciales adicionales entre las entidades de entrada y las entidades de identidad se escriban en el resultado. Esto solo se aplica cuando las entidades de entrada y las entidades de identidad son polígonos.
| Boolean |
Ejemplo de código
La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función Identidad en modo inmediato.
import arcpy from arcpy import env env.workspace = "c:/data/data.gdb" arcpy.Identity_analysis("wells", "counties", "wells_w_county_info")
La siguiente secuencia de comandos independiente es un ejemplo simple de cómo aplicar la función Identidad en secuencias de comandos.
# IdentityWells.py # Description: Simple example showing use of Identity tool # Author: ESRI # Import system modules import arcpy from arcpy import env # Set the workspace env.workspace = "C:/data/data.gdb" # Set local parameters inFeatures = "wells" idFeatures = "counties" outFeatures = "wells_w_county_info" # Process: Use the Identity function arcpy.Identity_analysis (inFeatures, idFeatures, outFeatures)