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

• Cuando las entidades de entrada son líneas y las entidades de identidad son polígonos, y se marca el parámetro Mantener las relaciones (relación establecida en KEEP_RELATIONSHIPS), la clase de entidad de línea de salida tendrá dos campos adicionales, LEFT_poly y RIGHT_poly. Estos campos contienen el ID de entidad de las entidades de identidad en los lados izquierdo y derecho de la entidad de línea.

• Los valores de atributo de las clases de entidad de entrada se copiarán a la clase de entidad de salida. Sin embargo, si la entrada hay 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 se habilita Utilizar política de relación, siempre que se divida una entidad en una operación de superposición, los atributos de las entidades resultantes son una relación del valor de atributo de la entidad de entrada. El valor de salida está basado en la relació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 los tipos de campos numéricos.

  Precaución:

  Las herramientas de geoprocesamiento no cumplen las políticas de división de campos de tabla 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

Identity_analysis (in_features, identity_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {relationship})

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. Deben ser polígonos o tener 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. ALL —Todos los atributos (incluidos los FID) de las entidades de entrada y de las entidades de identidad se transferirán a la clase de entidad de salida. Si no se encuentra ninguna intersección, los valores de la entidad de identidad no se transferirán a la salida (sus valores se establecerán en 0 o en cadenas vacías) y el FID de la entidad de identidad será -1. Esta es la opción predeterminada. NO_FID —Todos los atributos excepto el FID de las entidades de entrada y de las entidades de identidad se transferirán a las entidades de salida. Si no se encuentra ninguna intersección, los valores de la entidad de identidad no se transferirán a la salida (sus valores se establecerán en 0 o en cadenas vacías). ONLY_FID —Todos los atributos de las entidades de entrada, pero solo el FID de las entidades de identidad, se transferirán a la clase de entidad de salida. El atributo FID de las entidades de identidad en la salida serán -1 si no se encuentra ninguna intersección.	String
cluster_tolerance (Opcional)	La distancia mínima que separa todas las coordenadas de entidades (nodos y vértices), como también la distancia que se puede mover una coordenada en X o en Y (o en los dos).	Linear unit
relationship (Opcional)	Determina si las relaciones espaciales adicionales entre la in_features y la identity_features se escriben en la salida. Esto solo se aplica cuando las in_features son líneas y las identity_features son polígonos. NO_RELATIONSHIPS —No se determinará ninguna relación espacial adicional. KEEP_RELATIONSHIPS —Las entidades de línea de salida contendrán dos campos adicionales, LEFT_poly y RIGHT_poly. Estos campos contienen el ID de entidad de las entidades de identidad en los lados izquierdo y derecho de la entidad de línea.	Boolean

Ejemplo de código

Ejemplo 1 de Identidad (ventana de Python)

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

Ejemplo 2 de Identidad (secuencia de comandos independiente de Python)

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

Entornos

Auto ejecución, Nombres de campos calificados, Valor Z de salida predeterminado, Resolución M, Tolerancia M, Palabra clave CONFIG de salida, Dominio M de salida, Dominio XY de salida, Dominio Z de salida, Sistema de coordenadas de salida, Extensión, La salida tiene valores M, La salida tiene valores Z, Cuadrícula espacial de salida 1, Cuadrícula espacial de salida 2, Cuadrícula espacial de salida 3, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z

Información sobre licencias

ArcGIS for Desktop Basic: No

ArcGIS for Desktop Standard: No

ArcGIS for Desktop Advanced: Sí