Recortar por pares (Análisis)

Resumen

Extrae entidades de entrada que se superponen a las entidades del clip.

Utilice esta herramienta para recortar una parte de una clase de entidad utilizando una o más de las entidades de otra clase de entidad como molde. Es particularmente útil para crear una nueva clase de entidad, también conocida como área de estudio o área de interés (AOI), que contenga un subconjunto geográfico de las entidades de otra clase de entidad mayor.

Existe una herramienta alternativa para las operaciones de recorte de datos vectoriales. Consulte la herramienta Recortar para obtener más detalles.

Ilustración

Ilustración de la herramienta Recortar por pares

Uso

  • Los valores del parámetro Entidades de recorte pueden ser puntos, líneas o polígonos, dependiendo del tipo de geometría del valor del parámetro Entidades de entrada.

    • Cuando el valor del parámetro Entidades de entrada es polígono, el valor del parámetro Entidades de recorte también debe ser polígono.
    • Cuando el valor del parámetro Entidades de entrada es línea, el valor del parámetro Entidades de recorte puede ser línea o polígono. Cuando recortas entidades de línea con entidades de línea, solo las líneas coincidentes o los segmentos de línea se escribirán en la salida, como se muestra en la imagen que aparece a continuación.
    • Cuando el valor del parámetro Entidades de entrada es punto, el valor del parámetro Entidades de recorte puede ser punto, línea o polígono. Cuando recortas entidades de punto con entidades de punto, solo los puntos coincidentes se escribirán en la salida, como se muestra en la imagen que aparece a continuación. Cuando recortas entidades de punto con entidades de línea, solo los puntos que son coincidentes con las entidades de línea se escribirán en la salida.

  • El parámetro Clase de entidad de salida contendrá todos los atributos del parámetro Entidades de entrada.

  • Entidades de línea recortadas por entidades de polígono:

    Entidades de línea recortadas por entidades de polígono

  • Entidades de punto recortadas por entidades de polígono:

    Entidades de punto recortadas por entidades de polígono

  • Entidades de línea recortadas por entidades de línea:

    Entidades de línea recortadas por entidades de línea

  • Entidades de punto recortadas por entidades de punto:

    Entidades de punto recortadas por entidades de punto

  • Esta herramienta respeta el entorno Factor de procesamiento en paralelo. Si el entorno no está configurado (predeterminado) o está configurado con el valor 100, se permitirá el procesamiento en paralelo completo y la herramienta intentará distribuir el trabajo entre todos los núcleos lógicos del equipo. Configurar el entorno a 0 desactiva el procesamiento en paralelo. Especificar un factor entre 1 y 99 hará que la herramienta identifique el porcentaje de núcleos lógicos que debe usar aplicando la fórmula (Factor de procesamiento en paralelo / 100 * Núcleos lógicos) redondeada al entero más próximo. Si el resultado de la fórmula es 0 o 1, no se habilitará el procesamiento en paralelo.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades que se van a recortar.

Feature Layer
Entidades de recorte

Las entidades a utilizar para recortar las entidades de entrada.

Feature Layer
Clase de entidad de salida

La clase de entidad que se creará.

Feature Class
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

arcpy.analysis.PairwiseClip(in_features, clip_features, out_feature_class, {cluster_tolerance})
NombreExplicaciónTipo de datos
in_features

Las entidades que se van a recortar.

Feature Layer
clip_features

Las entidades a utilizar para recortar las entidades de entrada.

Feature Layer
out_feature_class

La clase de entidad que se creará.

Feature Class
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

Muestra de código

Ejemplo 1 de PairwiseClip (ventana de Python)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.PairwiseClip_analysis("majorrds.shp", "study_quads.shp", 
                            "C:/output/studyarea.shp")
Ejemplo 2 de PairwiseClip (script independiente)

El siguiente script de Python demuestra cómo utilizar la función PairwiseClip en un script independiente.

# Name: PairwiseClip_Example2.py
# Description: Clip major roads that fall within the study area. 

# Import system modules
import arcpy

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

# Set local variables
in_features = "majorrds.shp"
clip_features = "study_quads.shp"
out_feature_class = "C:/output/studyarea.shp"

# Execute Pairwise Clip
arcpy.PairwiseClip_analysis(in_features, clip_features, out_feature_class)

Información de licenciamiento

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

Temas relacionados