Delete Terrain Points (3D Analyst Tools)

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.

Label	Explanation	Data type
Input Terrain	The terrain dataset that will be processed.	Terrain Layer
Input Terrain Data Source	One or more feature classes from which points will be removed.	String
Area of Interest	Specifies the area from which points will be removed. A polygon feature class or an extent can be used.	Feature Layer; Extent

Derived output

Label	Explanation	Data type
Updated Input Terrain	The updated terrain.	Terrain Layer

arcpy.3d.DeleteTerrainPoints(in_terrain, data_source, polygon_features_or_extent)

Name Explanation Data type

Name	Explanation	Data type
in_terrain	The terrain dataset that will be processed.	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

in_terrain

The terrain dataset that will be processed.

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

Name	Explanation	Data 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.ddd.DeleteTerrainPoints("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'

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

Environments

Current Workspace, Scratch Workspace, Auto Commit

Licensing information

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

Delete Terrain Points (3D Analyst Tools)

Summary

Usage

Parameters

Derived output

Environments

Licensing information

Related topics