Eliminar entidades

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 con la flecha de selección.

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

• Cuando se utiliza una capa con selecciones como entrada, usar esta herramienta en una sesión de edición le permitirá deshacer la operación Eliminar entidades mediante la opción de deshacer o rehacer.

Sintaxis

arcpy.management.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

Ejemplo 1 de DeleteFeatures (ventana de Python)

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

Ejemplo 2 de DeleteFeatures (script independiente)

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

• Espacio de trabajo actual
• Extensión

  Nota:

  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í