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

Ilustración de la herramienta Identidad

Uso

  • El valor del parámetro Entidades de entrada puede ser punto, multipunto, línea o polígono. Las entradas no pueden ser entidades de anotación, entidades de dimensión o entidades de red.

  • El valor del parámetro Entidades de identidad debe ser un polígono o tener el mismo tipo de geometría que el valor del parámetro Entidades de entrada.

  • Cuando se utiliza esta herramienta con entradas de punto y valores de 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 forma parte del límite. Al ejecutar la herramienta Intersecar en la salida de este escenario, se identificarán los puntos duplicados para poder decidir cuáles se conservan.

  • Cuando la geometría del valor del parámetro Entidades de entrada es línea, la geometría del valor del parámetro Entidades de identidad es polígono, y el parámetro Mantener las relaciones está activado, 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 del valor del parámetro 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ó equitativamente, al valor de atributo de cada entidad nueva se le asigna la mitad del valor de 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 más detalles, consulte Geoprocesamiento con datasets grandes.

  • Esta herramienta puede generar entidades multiparte en la salida, aunque todas las entradas tengan una única parte. Si no desea tener entidades multiparte, utilice la herramienta De multiparte a parte simple en la clase de entidad de salida.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

La capa o clase de entidad de entrada.

Feature Layer
Entidades de identidad

La capa o clase de entidad de identidad. Debe ser un polígono o el mismo tipo de geometría que las entidades de entrada.

Feature Layer
Clase de entidad de salida

La clase de entidad que se creará y en la que se escribirán los resultados.

Feature Class
Atributos para unir
(Opcional)

Especifica cómo se transferirán los atributos a la clase de entidad de salida.

  • Todos los atributosTodos 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.
  • Todos los atributos excepto los Id. de entidadTodos 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).
  • Solo Id. de entidadTodos 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. Si no se encuentra ninguna intersección, el valor del atributo FID de las entidades de identidad en la salida será -1.
String
Tolerancia XY
(Opcional)

La distancia mínima que separa todas las coordenadas de entidades (nodos y vértices), así como también la distancia que se puede mover una coordenada en X o en Y (o en los dos).

Precaución:

El cambio del valor de este parámetro puede generar un fallo o resultados inesperados. Se recomienda no modificar este parámetro. Se ha eliminado de la vista en el cuadro de diálogo de la herramienta. Se utiliza de forma predeterminada la propiedad tolerancia x,y de referencia espacial de la clase de entidad de entrada.

Linear Unit
Mantener las relaciones
(Opcional)

Especifica si se escribirán en la salida relaciones espaciales adicionales entre los valores de los parámetros Entidades de entrada y Entidades de identidad. Solo se aplica cuando el tipo de geometría del valor del parámetro Entidades de entrada es línea y el tipo de geometría del valor del parámetro Entidades de identidad es polígono.

  • Desactivado: no se escribirá en la salida ninguna relación espacial adicional.
  • Activado: las entidades de línea de salida contendrán dos campos adicionales (LEFT_poly y RIGHT_poly). Estos campos contienen el Id. de entidad del valor del parámetro Entidades de identidad en los lados izquierdo y derecho de la entidad de línea.
Boolean

arcpy.analysis.Identity(in_features, identity_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {relationship})
NombreExplicaciónTipo 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 un polígono 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)

Especifica cómo se transferirán los atributos a la clase de entidad de salida.

  • ALLTodos 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_FIDTodos 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_FIDTodos 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. Si no se encuentra ninguna intersección, el valor del atributo FID de las entidades de identidad en la salida será -1.
String
cluster_tolerance
(Opcional)

La distancia mínima que separa todas las coordenadas de entidades (nodos y vértices), así como también la distancia que se puede mover una coordenada en X o en Y (o en los dos).

Precaución:

El cambio del valor de este parámetro puede generar un fallo o resultados inesperados. Se recomienda no modificar este parámetro. Se ha eliminado de la vista en el cuadro de diálogo de la herramienta. Se utiliza de forma predeterminada la propiedad tolerancia x,y de referencia espacial de la clase de entidad de entrada.

Linear Unit
relationship
(Opcional)

Especifica si las relaciones espaciales adicionales entre los valores de los parámetros in_features y identity_features se escribirán en la salida. Solo se aplica cuando el tipo de geometría del valor del parámetro in_features es línea y el tipo de geometría del valor del parámetro identity_features es polígono.

  • NO_RELATIONSHIPSNo se escribirá en la salida ninguna relación espacial adicional.
  • KEEP_RELATIONSHIPSLas entidades de línea de salida contendrán dos campos adicionales (LEFT_poly y RIGHT_poly). Estos campos contienen el Id. de entidad del valor del parámetro identity_features en los lados izquierdo y derecho de la entidad de línea.
Boolean

Muestra de código

Ejemplo 1 de Identidad (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función Identity de modo inmediato.

import arcpy
arcpy.env.workspace = "c:/data/data.gdb"
arcpy.analysis.Identity("wells", "counties", "wells_w_county_info")
Ejemplo 2 de Identidad (script independiente de Python)

El siguiente script independiente de Python es un simple ejemplo de cómo aplicar la función Identity en scripts.

# IdentityWells.py
# Description: Simple example showing use of Identity tool
 
# Import system modules
import arcpy

# Set the workspace
arcpy.env.workspace = "C:/data/data.gdb"

# Set local parameters
inFeatures = "wells"
idFeatures = "counties"
outFeatures = "wells_w_county_info"

# Process: Use the Identity function
arcpy.analysis.Identity(inFeatures, idFeatures, outFeatures)

Entornos

Casos especiales

Factor de procesamiento en paralelo

Esta herramienta respeta el entorno de Factor de procesamiento en paralelo. Si no se establece el entorno (valor predeterminado) o si se establece en 0, se desactivará el procesamiento en paralelo. El procesamiento paralelo no se utilizará y el procesamiento se hará de forma secuencial. Si se establece el entorno en 100, se habilitará el procesamiento en paralelo. Se utilizará el procesamiento paralelo y el procesamiento se hará en paralelo. Se utilizarán hasta 10 núcleos cuando se active el procesamiento en paralelo.

En estos momentos, procesamiento en paralelo es compatible con las operaciones de polígono sobre polígono, línea sobre polígono y punto sobre superposición poligonal.

Información de licenciamiento

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

Temas relacionados