Resumen
Extrae entidades de entrada de polígonos especificados.
Ilustración
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
ClipLayer(input_layer, clip_layer, {output_name}, {data_store})
Parámetro | Explicación | Tipo 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 el SPATIOTEMPORAL_DATA_STORE se almacenarán en WGS84. Los resultados almacenados en un RELATIONAL_DATA_STORE mantendrán su sistema de coordenadas.
| String |
Salida derivada
Nombre | Explicación | Tipo de datos |
output | La salida recortada. | Conjunto de entidades |
Muestra de código
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