Recortar (Análisis)

Resumen

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

Utilice esta herramienta para recortar una parte de un dataset utilizando una o más de las entidades de otro dataset como molde. Resulta particularmente útil para crear un nuevo dataset, también conocido como área de estudio o área de interés (AOI), que contenga un subconjunto geográfico de las entidades de otro dataset mayor.

Las operaciones de recorte también se pueden realizar con la herramienta Recortar por pares.

Ilustración

Imagen de la herramienta Recortar

Uso

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

    • Si los valores de las entidades o del dataset de entrada son polígonos, los valores de las entidades de recorte también deben ser polígonos.
    • Si los valores de las entidades o del dataset de entrada son líneas, los valores de las entidades de recorte pueden ser líneas o polígonos. 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.
    • Si los valores de las entidades o del dataset de entrada son puntos, los valores de las entidades de recorte pueden ser puntos, líneas o polígonos. 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.
    • Si los valores de las entidades o del dataset de entrada son una malla integrada, un punto, un edificio, un objeto 3D o una capa de escena de nube de puntos o un paquete de capas de escena, los valores de las entidades de recorte también deben ser polígonos.

  • El parámetro Entidades o del dataset de salida contendrá todos los atributos del parámetro Entidades de entrada o dataset si la salida es una clase de entidad.

  • Los paquetes de capas de escena y servicios de escena de malla integrada, punto, edificio y objetos 3D deben usar I3S versión 1.6 y posteriores para poder usarse como entrada. Use la herramienta Actualizar capa de escena para actualizar los paquetes de capas de escena de la versión 1.5 y versiones anteriores. El paquete de capas de escena de salida estará en la última versión de I3S.

  • Los servicios de escena deben tener la capacidad de extracción para poder recortarlos. Los servicios sin esta capacidad se bloquearán como entrada.

  • Si la entrada es una capa de escena de edificios, se recortarán todas las capas de categoría y disciplina. Si la entrada es una capa de categoría, el paquete de capas de escena de salida será un paquete de capas de escena de objetos 3D con solo la capa de entrada seleccionada.

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

  • 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

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

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades o dataset de entrada

Las entidades que se van a recortar.

Feature Layer; Scene Layer; File; Building Scene Layer
Entidades de recorte

Las entidades que se van a utilizar para recortar las entidades de entrada.

Feature Layer
Entidades o dataset de salida

El dataset que se creará.

Feature Class; File
Tolerancia XY
(Opcional)

La distancia mínima que separa todas las coordenadas de entidades, como también la distancia que se puede mover una coordenada en x o en y (o en los dos). Establezca un valor mayor para los datos que tengan coordenadas menos exactas y un valor menor para los datos con una precisión extremadamente elevada.

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.Clip(in_features, clip_features, out_feature_class, {cluster_tolerance})
NombreExplicaciónTipo de datos
in_features

Las entidades que se van a recortar.

Feature Layer; Scene Layer; File; Building Scene Layer
clip_features

Las entidades que se van a utilizar para recortar las entidades de entrada.

Feature Layer
out_feature_class

El dataset que se creará.

Feature Class; File
cluster_tolerance
(Opcional)

La distancia mínima que separa todas las coordenadas de entidades, como también la distancia que se puede mover una coordenada en x o en y (o en los dos). Establezca un valor mayor para los datos que tengan coordenadas menos exactas y un valor menor para los datos con una precisión extremadamente elevada.

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 Recortar (ventana de Python)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.Clip("majorrds.shp", "study_quads.shp", 
                    "C:/output/studyarea.shp")
Ejemplo 2 de Recortar (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo se utiliza la función Clip con una capa de escena.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.Clip("campus.slpk", "building_footprint.shp", 
                    "C:/output/AreaOfInterest.slpk")
Ejemplo 3 de Recortar (script independiente)

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


# 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"

# Run Clip
arcpy.analysis.Clip(in_features, clip_features, out_feature_class)
Ejemplo 4 de Recortar (script independiente)

En el siguiente script de Python se muestra cómo utilizar la función Clip en un script independiente con un servicio de escenas.


# Description: Clip a scene service. 

# Import system modules
import arcpy

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

# Set local variables
scene_service = "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/2021_02_04_Frankfurt/SceneServer"
mesh_layer_name = "mesh_layer"
clip_features = "AOI.shp"
out_feature_class = "C:/output/studyarea.shp"

# Create a layer of a scene service
mesh_layer = arcpy.management.MakeSceneLayer(scene_service,
                                             mesh_layer_name)

# Run Clip
arcpy.analysis.Clip(mesh_layer, clip_features, out_feature_class)

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

Temas relacionados