Intersecar (Análisis)

Resumen

Calcula una intersección geométrica de las entidades de entrada. Las entidades o partes de entidades que se superponen con todas las capas o clases de entidad se escriben en la clase de entidad de salida.

Existe una herramienta alternativa para las operaciones de intersección. Consulte la documentación de la herramienta Intersecar por pares para obtener más detalles.

La herramienta Intersecar por pares es similar a la herramienta Intersecar en cuanto a que se calculan las intersecciones geométricas, pero es distinta en cuanto a que las intersecciones se calculan por pares de entidades en vez de por todas las combinaciones de entidades.

Más información sobre cómo funciona Intersecar

Ilustración

Ilustración de la herramienta Intersecar

Uso

  • El valor del parámetro Entidades de Entrada debe contener entidades simples: punto, multipunto, línea o polígono. No pueden ser entidades complejas tales como entidades de anotación, entidades de dimensión o entidades de red.

  • Si las entradas tienen diferentes tipos de geometría (es decir, línea sobre polígono, punto sobre línea, etc.), el tipo de geometría de la Clase de Entidad de Salida se establecerá de manera predeterminada igual que el tipo de geometría Entidades de Entrada, con la geometría de dimensión inferior. Por ejemplo, si una o más de las entradas es de tipo punto, la salida predeterminada será de punto; si una o más de las entradas es de línea, la salida predeterminada será de línea; y si todas las entradas son de polígono, la salida predeterminada será de polígono.

  • El valor del parámetro Tipo de Salida puede ser el del parámetro Entidades de entrada con la geometría de dimensión inferior o menor. Por ejemplo, si todas las entradas son polígonos, la salida puede ser de polígono, línea o punto. Si una de las entradas es del tipo línea y ninguna es de punto, la salida puede ser de línea o de punto. Si cualquiera de las entradas es de punto, el valor Tipo de salida solo puede ser de punto.

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

  • Licencia:

    Con licencias de ArcGIS Desktop Basic y Desktop Standard, el número de capas o clases de entidad de entrada se limita a dos.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Una lista de las capas o clases de entidad de entrada. Cuando la distancia entre las entidades es menor que la tolerancia clúster, las entidades con la clasificación más baja se alinearán con la entidad con la clasificación más alta. La clasificación más alta es 1.

Value Table
Clase de entidad de salida

La clase de entidad de salida.

Feature Class
Atributos para unir
(Opcional)

Especifica qué atributos de las entidades de entrada se transferirán a la clase de entidad de salida.

  • Todos los atributosTodos los atributos de las entidades de entrada se transferirán a la clase de entidad de salida. Esta es la opción predeterminada.
  • Todos los atributos excepto los Id. de entidadTodos los atributos excepto el FID de las entidades de entrada se transferirán a la clase de entidad de salida.
  • Solo Id. de entidadSolo se transferirá a la clase de entidad de salida el campo FID de las entidades de entrada.
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
Tipo de Salida
(Opcional)

Especifica el tipo de intersecciones que se devolverán.

  • Igual que la entradaLas intersecciones devueltas serán del mismo tipo de geometría que las entidades de entrada con la geometría de dimensión más baja. Si todas las entradas son polígonos, la clase de entidad de salida contendrá polígonos. Si una o más de las entradas son líneas y ninguna de las entradas son puntos, la salida será de línea. Si una o más de las entradas son puntos, la clase de entidad de salida contendrá puntos. Esta es la opción predeterminada.
  • LíneaLas intersecciones que se devuelven serán de líneas. Esto solo es válido si ninguna de las entradas son puntos.
  • PuntoLas intersecciones que se devuelven serán de puntos. Si las entradas son de línea o polígono, el resultado será una clase de entidad multipunto.
String

arcpy.analysis.Intersect(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {output_type})
NombreExplicaciónTipo de datos
in_features
[[in_features, {Rank}],...]

Una lista de las capas o clases de entidad de entrada. Cuando la distancia entre las entidades es menor que la tolerancia clúster, las entidades con la clasificación más baja se alinearán con la entidad con la clasificación más alta. La clasificación más alta es 1. Para obtener más información, consulte Clasificaciones de prioridad y herramientas de Geoprocesamiento.

Value Table
out_feature_class

La clase de entidad de salida.

Feature Class
join_attributes
(Opcional)

Especifica qué atributos de las entidades de entrada se transferirán a la clase de entidad de salida.

  • ALLTodos los atributos de las entidades de entrada se transferirán a la clase de entidad de salida. Esta es la opción predeterminada.
  • NO_FIDTodos los atributos excepto el FID de las entidades de entrada se transferirán a la clase de entidad de salida.
  • ONLY_FIDSolo se transferirá a la clase de entidad de salida el campo FID de las entidades de entrada.
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
output_type
(Opcional)

Especifica el tipo de intersecciones que se devolverán.

  • INPUTLas intersecciones devueltas serán del mismo tipo de geometría que las entidades de entrada con la geometría de dimensión más baja. Si todas las entradas son polígonos, la clase de entidad de salida contendrá polígonos. Si una o más de las entradas son líneas y ninguna de las entradas son puntos, la salida será de línea. Si una o más de las entradas son puntos, la clase de entidad de salida contendrá puntos. Esta es la opción predeterminada.
  • LINELas intersecciones que se devuelven serán de líneas. Esto solo es válido si ninguna de las entradas son puntos.
  • POINTLas intersecciones que se devuelven serán de puntos. Si las entradas son de línea o polígono, el resultado será una clase de entidad multipunto.
String

Muestra de código

Ejemplo de Intersecar (ventana de Python)

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

import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
arcpy.analysis.Intersect(["vegetation_stands", "road_buffer200m", "water_buffer100"], "mysites", "ALL")
arcpy.analysis.Intersect([["vegetation_stands", 2], ["road_buffer200m", 1], ["water_buffer100", 2]], 
                         "mysites_ranked", "ALL")
Ejemplo 2 de Intersecar (script independiente)

El siguiente script independiente utiliza la función Intersect como parte de un flujo de trabajo con otras herramientas de análisis para determinar el tipo de vegetación a menos de 100 metros de todos los cruces de la corriente.

#Name: VegRoadIntersect.py
# Purpose: Determine the type of vegetation within 100 meters of all stream 
#          crossings

# Import system modules
import arcpy

# Set the workspace (to avoid having to type in the full path to the data every 
# time)
arcpy.env.workspace = "c:/data/data.gdb"    
    
# Process: Find all stream crossings (points)
inFeatures = ["roads", "streams"]
intersectOutput = "stream_crossings"
arcpy.analysis.Intersect(inFeatures, intersectOutput, "", "", "point")
 
# Process: Buffer all stream crossings by 100 meters
bufferOutput = "stream_crossings_100m"
bufferDist = "100 meters"
arcpy.analysis.Buffer(intersectOutput, bufferOutput, bufferDist)

# Process: Clip the vegetation feature class to stream_crossing_100m
clipInput = "vegetation"
clipOutput = "veg_within_100m_of_crossings"
arcpy.analysis.Clip(clipInput, bufferOutput, clipOutput)

# Process: Summarize how much (area) of each type of vegetation is found
# within 100 meters of the stream crossings
statsOutput = "veg_within_100m_of_crossings_stats"
statsFields = [["shape_area", "sum"]]
caseField = "veg_type"
arcpy.analysis.Statistics(clipOutput, statsOutput, statsFields, caseField)

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. Si se establece el entorno en 100, se habilitará el procesamiento 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: Limitado
  • Standard: Limitado
  • Advanced: Sí

Temas relacionados