Resumen
Elimina todas o el subconjunto seleccionado de filas desde la entrada.
Si las entidades de entrada son de una clase de entidad, se eliminarán todas las filas. Si las entidades de entrada son de una capa sin selección, se eliminarán todas las entidades.
Uso
Esta herramienta acepta capas con selecciones como entrada y eliminará únicamente las entidades que estén seleccionadas. Para eliminar entidades específicas de una clase de entidad, convierta la clase de entidad en una capa utilizando Crear capa de entidades o agregándola a la visualización. Se puede aplicar una selección utilizando las herramientas Seleccionar capa por atributo o Seleccionar capa por ubicación, consultando una capa de mapa o seleccionando entidades de forma interactiva utilizando las herramientas de selección del grupo Selección en la pestaña Mapa.
Si la entrada es una capa y esa capa no tiene una selección, se eliminarán todas las entidades. Si se introduce una clase de entidad, todas las entidades se eliminarán.
Nota:
Eliminar todas las filas de una clase de entidad con un gran número de filas puede ser lento. Si su intención es eliminar todas las filas en la clase de entidad, plantéese la posibilidad de utilizar la herramienta Truncar tabla en su lugar. Consulte la documentación de Truncar tabla para conocer declaraciones importantes de prevención sobre su uso.
Esta herramienta elimina la geometría y los atributos de las Entidades de entrada.
El entorno Extensión se distingue por esta herramienta. Solo las entidades que se encuentran dentro de o intersecan el entorno de la extensión de salida se eliminarán. Si la capa de entrada tiene una selección, solo las entidades seleccionadas que están dentro o intersecan la extensión de salida se eliminarán.
Sintaxis
DeleteFeatures(in_features)
Parámetro | Explicación | Tipo de datos |
in_features | Clase de entidad, shapefile o capa que contiene las entidades que se eliminarán. | Feature Layer |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_feature_class | La clase de entidad actualizada. | Capa de entidades |
Muestra de código
El script de la ventana de Python muestra cómo utilizar la herramienta DeleteFeatures en el modo inmediato.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CopyFeatures_management("majorrds.shp", "C:/output/output.gdb/majorrds2")
arcpy.DeleteFeatures_management("C:/output/output.gdb/majorrds2")
El siguiente script independiente demuestra cómo utilizar la herramienta DeleteFeatures para eliminar las entidades basadas en una expresión.
# Name: DeleteFeatures_Example2.py
# Description: Delete features from a feature class based on an expression
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
# Set local variables
inFeatures = "parcels"
outFeatures = "C:/output/output.gdb/new_parcels"
tempLayer = "parcelsLayer"
expression = arcpy.AddFieldDelimiters(tempLayer, "PARCEL_ID") + " = 'Cemetery'"
# Execute CopyFeatures to make a new copy of the feature class
arcpy.CopyFeatures_management(inFeatures, outFeatures)
# Execute MakeFeatureLayer
arcpy.MakeFeatureLayer_management(outFeatures, tempLayer)
# Execute SelectLayerByAttribute to determine which features to delete
arcpy.SelectLayerByAttribute_management(tempLayer, "NEW_SELECTION",
expression)
# Execute GetCount and if some features have been selected, then
# execute DeleteFeatures to remove the selected features.
if int(arcpy.GetCount_management(tempLayer)[0]) > 0:
arcpy.DeleteFeatures_management(tempLayer)
Entornos
- Extensión
Sólo se eliminarán las entidades que estén en la extensión o la intersequen.
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí