Intersección (Herramientas de 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 las licencias de ArcGIS Desktop Basic y Desktop Standard, el número de clases de entidades o capas de entrada está limitado a dos.

Etiqueta	Explicación	Tipo 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. Columnas de la tabla de valores: Entidades—Una lista de las capas o clases de entidad de entrada. Clasificaciones—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 atributos—Todos 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 entidad—Todos los atributos, excepto el atributo FID de las entidades de entrada, se transferirán a la clase de entidad de salida. Solo Id. de entidad—Solo 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: Si se modifica el valor de este parámetro, pueden producirse fallos 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. De forma predeterminada, se utiliza la propiedad de tolerancia x,y de la 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 entrada—Las 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ínea—Las intersecciones que se devuelven serán de líneas. Esto solo es válido si ninguna de las entradas son puntos. Punto—Las 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})

Nombre	Explicación	Tipo 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. Columnas de la tabla de valores: `Features`—Una lista de las capas o clases de entidad de entrada. `Ranks`—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
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. `ALL`—Todos los atributos de las entidades de entrada se transferirán a la clase de entidad de salida. Esta es la opción predeterminada. `NO_FID`—Todos los atributos, excepto el atributo FID de las entidades de entrada, se transferirán a la clase de entidad de salida. `ONLY_FID`—Solo 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: Si se modifica el valor de este parámetro, pueden producirse fallos 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. De forma predeterminada, se utiliza la propiedad de tolerancia x,y de la referencia espacial de la clase de entidad de entrada.	Linear Unit
output_type (Opcional)	Especifica el tipo de intersecciones que se van a devolver. `INPUT`—Las 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. `LINE`—Las intersecciones que se devuelven serán de líneas. Esto solo es válido si ninguna de las entradas son puntos. `POINT`—Las 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)

La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función Intersect en 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

Auto ejecución, Mantener totalmente cualificados los nombres de los campos, 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, Transformaciones geográficas, Extensión, La salida tiene valores M, La salida tiene valores Z, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z, Factor de procesamiento en paralelo, Transferir propiedades de campos de geodatabase

Casos especiales

Factor de procesamiento en paralelo

This tool honors the Parallel Processing Factor environment. If the environment is not set (the default) or is set to 0, parallel processing will be disabled; parallel processing will not be used and processing will be done sequentially. Setting the environment to 100 will enable parallel processing; parallel processing will be used and processing will be done in parallel. Up to 10 cores will be used when parallel processing is enabled.

Parallel processing is currently supported for polygon-on-polygon, line-on-polygon, and point-on-polygon overlay operations.

Información de licenciamiento

Basic: Limitado
Algunos parámetros están limitados por el nivel de licencia.
Standard: Limitado
Algunos parámetros están limitados por el nivel de licencia.
Avanzado: Sí