Delete Terrain Points (3D Analyst)

Available with 3D Analyst license.

Summary

Deletes points within a specified area of interest from one or more features that participate in a terrain dataset.

Usage

  • Deleting points from an embedded feature class will invalidate the terrain. Run the Build Terrain tool after deleting points.

  • If the terrain is in an enterprise geodatabase, it must be registered as versioned.

Syntax

DeleteTerrainPoints(in_terrain, data_source, polygon_features_or_extent)
ParameterExplanationData Type
in_terrain

The terrain dataset to process.

Terrain Layer
data_source
[data_source,...]

One or more feature classes from which points will be removed.

String
polygon_features_or_extent

Specifies the area from which points will be removed. A polygon feature class or an extent can be used.

If extent values are desired, use an arcpy.Extent object.

Feature Layer; Extent

Derived Output

NameExplanationData Type
derived_out_terrain

The updated terrain.

Terrain Layer

Code sample

DeleteTerrainPoints example 1 (Python window)

The following sample demonstrates the use of this tool in the Python window.

arcpy.env.workspace = "C:/data"
arcpy.DeleteTerrainPoints_3d("sample.gdb/featuredataset/terrain", 
                           "mass_pts_embed", "1379938 235633 1382756 237681")
DeleteTerrainPoints example 2 (stand-alone script)

The following sample demonstrates the use of this tool in a stand-alone Python script.

'''**********************************************************************
Name: Delete Terrain Outliers
Description: Uses Locate Outliers to identify outlier points in 
             a terrain dataset, and eliminates the outliers from the 
             terrain with Delete Terrain Points.
**********************************************************************'''
# Import system modules
import arcpy

# Set Local Variables
arcpy.env.workspace = 'C:/data'
terrain = 'test.gdb/featuredataset/sample_terrain'
terrainPt = 'elevation_pts'  # name of terrain point data source
outliers = 'in_memory/outliers'

# Execute LocateOutliers
arcpy.ddd.LocateOutliers(terrain, outliers, 'APPLY_HARD_LIMIT', -10, 
                         350, 'APPLY_COMPARISON_FILTER', 1.2, 120, 
                         0.8, 8000)
# Execute Delete Terrain Points
arcpy.ddd.DeleteTerrainPoints(terrain, terrainPt, outliers)

Licensing information

  • Basic: Requires 3D Analyst
  • Standard: Requires 3D Analyst
  • Advanced: Requires 3D Analyst

Related topics