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. Esto 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.
Ilustración
Uso
Las entidades de recorte pueden ser puntos, líneas y polígonos, dependiendo del tipo de las entidades de entrada .
- Cuando las entidades de entrada son polígonos, las entidades de recorte también deben ser polígonos.
- Cuando las entidades de entrada son líneas, 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 escriben en la salida, como se muestra en el gráfico que aparece a continuación.
- Cuando las entidades de entrada son puntos, las entidades de recorte pueden ser puntos, líneas o polígonos. Cuando se recortan entidades de punto con las entidades de punto, solo los puntos coincidentes se escriben en la salida, como se muestra en el gráfico que aparece a continuación. Cuando se recortan entidades de punto con entidades de línea, solo los puntos que son coincidentes con las entidades de línea se escriben en la salida.
La Clase de Entidad de Salida contendrá todos los atributos de las Entidades de Entrada.
Esta herramienta utilizará un proceso de ordenamiento en tesela para controlar datasets muy grandes para mejorar el rendimiento y la escalabilidad. Para obtener más detalles, consulte Geoprocesamiento con datasets grandes.
Entidades de línea recortadas por entidades poligonales:
Entidades de puntos recortadas por entidades poligonales:
Entidades de línea recortadas por entidades de línea:
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ó por igual, el valor del atributo de cada nueva entidad recibirá la mitad del valor del atributo de la entidad de entrada. Utilizar política de relación solo se aplica a los tipos de campos numéricos.
Sintaxis
Clip_analysis (in_features, clip_features, out_feature_class, {cluster_tolerance})
Parámetro | Explicación | Tipo de datos |
in_features | Las entidades que se van a recortar. | Feature Layer |
clip_features | Las entidades utilizadas 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, como también la distancia que se puede mover una coordenada en X o en Y (o en los dos). Establezca un valor superior para los datos con coordenadas menos precisas e inferior para datos de precisión extremadamente alta. | Linear unit |
Muestra de código
Ejemplo de Recortar (ventana de Python)
La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función Recortar en el modo inmediato.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.Clip_analysis("majorrds.shp", "study_quads.shp", "C:/output/studyarea.shp")
Ejemplo 2 de Recortar (secuencia de comandos independiente)
La siguiente secuencia de comandos Python demuestra cómo utilizar la función Recortar en una secuencia de comandos independiente.
# Name: Clip_Example2.py
# Description: Clip major roads that fall within the study area.
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/data"
# Set local variables
in_features = "majorrds.shp"
clip_features = "study_quads.shp"
out_feature_class = "C:/output/studyarea.shp"
xy_tolerance = ""
# Execute Clip
arcpy.Clip_analysis(in_features, clip_features, out_feature_class, xy_tolerance)
Entornos
- 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
- Extensión
- La salida tiene valores M
- La salida tiene valores Z
- Cuadrícula espacial de salida 1
- Cuadrícula espacial de salida 2
- Cuadrícula espacial de salida 3
- Resolución XY
- Tolerancia XY
- Resolución Z
- Tolerancia Z
Información sobre licencias
- ArcGIS Desktop Basic: Sí
- ArcGIS Desktop Standard: Sí
- ArcGIS Desktop Advanced: Sí