Recortar capa (Geoanálisis)

Resumen

Extrae entidades de entrada de polígonos especificados.

Ilustración

Diagrama del flujo de trabajo de Recortar capa

Uso

  • Utilice Recortar capa para recortar entidades poligonales, de punto o de línea.

  • 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. Resulta particularmente útil para crear una 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.

  • El análisis recortará entidades o porciones de entidades que se superpongan con las áreas de interés.

  • El resultado de salida contendrá entidades de capa de entrada que se superpongan a los polígonos de capa de recorte.

  • El tipo de geometría de salida será el mismo que las entidades de entrada que se recortan. Por ejemplo, si recorta las entidades de línea de un polígono, la salida resultante serán líneas.

  • Todos los campos del parámetro Capa de entrada se incluirán en el resultado de salida. Los campos del parámetro Recortar capa no se incluirán en la salida.

  • Es posible mejorar el rendimiento de la herramienta Recortar capa realizando una de las siguientes acciones o ambas:

    • Defina el entorno de extensión para analizar únicamente datos de interés.
    • Utilice datos locales en los que se ejecute el análisis.

  • Esta herramienta de geoprocesamiento se basa en ArcGIS GeoAnalytics Server. El análisis se completa en su GeoAnalytics Server y los resultados se almacenan en su contenido en ArcGIS Enterprise.

  • Al ejecutar herramientas de GeoAnalytics Server, el análisis se completa en GeoAnalytics Server. Para obtener un rendimiento óptimo, haga que los datos estén disponibles para GeoAnalytics Server mediante capas de entidades alojadas en su portal de ArcGIS Enterprise o mediante recursos compartidos de archivos de big data. Los datos que no son locales para su GeoAnalytics Server se moverán a GeoAnalytics Server antes de que comience el análisis. Significa que ejecutar una herramienta tardará más tiempo y, en algunos casos, mover los datos de ArcGIS Pro a GeoAnalytics Server podría fallar. El umbral de error depende de la velocidad de su red, así como del tamaño y complejidad de los datos. Por lo tanto, se recomienda que siempre comparta sus datos o que cree un recurso compartido de archivos de big data.

    Más información acerca del uso compartido de datos en el portal

    Más información sobre cómo crear un archivo compartido de Big Data mediante Server Manager

Sintaxis

arcpy.geoanalytics.ClipLayer(input_layer, clip_layer, {output_name}, {data_store})
ParámetroExplicaciónTipo de datos
input_layer

El dataset que contiene las entidades de punto, línea o poligonales que se recortarán.

Feature Set
clip_layer

El dataset que contiene las entidades poligonales que se usarán para recortar las entidades de entrada.

Feature Set
output_name
(Opcional)

El nombre del servicio de entidades de salida.

String
data_store
(Opcional)

Especifica el ArcGIS Data Store en el que se guardará la salida. La predeterminada es SPATIOTEMPORAL_DATA_STORE. Todos los resultados almacenados en un big data store espaciotemporal se almacenarán en WGS84. Los resultados almacenados en un data store relacional mantendrán su sistema de coordenadas.

  • SPATIOTEMPORAL_DATA_STORELa salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada.
  • RELATIONAL_DATA_STORELa salida se almacenará en un data store relacional.
String

Salida derivada

NombreExplicaciónTipo de datos
output

La salida recortada.

Conjunto de entidades

Muestra de código

Ejemplo de ClipLayer (script independiente)

En el siguiente script de Python se muestra cómo utilizar la herramienta ClipLayer.

#-------------------------------------------------------------------------------
# Name: ClipLayer.py
# Description: Clip USA Rivers to the extent of state boundaries.
# Results can be found in your Portal
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
clipFeatures = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/USA_Rivers/FeatureServer/0"
studyArea = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Nebraska_Boundary/FeatureServer/0"
outFS = "NebraskaRivers"
dataStore = "RELATIONAL_DATA_STORE"
# Execute Clip Layer
arcpy.geoanalytics.ClipLayer(clipFeatures, studyArea, outFS, dataStore)

Entornos

Sistema de coordenadas de salida

El sistema de coordenadas que se usará para el análisis. El análisis se completará en el sistema de coordenadas de entrada salvo que este parámetro especifique otra opción. Para las GeoAnalytics Tools, los resultados finales se almacenarán en el data store espaciotemporal en WGS84.

Información de licenciamiento

  • Basic: Requiere ArcGIS GeoAnalytics Server
  • Standard: Requiere ArcGIS GeoAnalytics Server
  • Advanced: Requiere ArcGIS GeoAnalytics Server

Temas relacionados