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 esta herramienta 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

  • La entrada deben ser entidades simples, por ejemplo, entidades de punto, multipunto, línea o polígono. No puede utilizar 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, el tipo de geometría de salida será por defecto la dimensión más baja de las entradas.

    • Si la entrada son entidades de puntos, la salida predeterminada serán entidades de puntos.
    • Si una entrada son entidades de línea y no hay entradas con entidades de puntos, la salida predeterminada serán entidades de línea.
    • Si todas las entradas son entidades de polígono, la salida predeterminada serán entidades 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.

  • Para mejorar el rendimiento y la escalabilidad, esta herramienta utiliza un proceso de ordenamiento en teselas para manejar datasets muy grandes. Para más información, consulte Procesamiento en teselas de 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 atributo 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 atributo 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 van a devolver.

  • 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 atributo 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 atributo 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 van a devolver.

  • 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. 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: Limitado
  • Standard: Limitado
  • Advanced: Sí

Temas relacionados