Remove Terrain Points (3D Analyst)

Available with 3D Analyst license.

Summary

This tool removes points within an area of interest from one or more embedded feature classes.

Legacy:

This is a deprecated tool. This functionality has been added to the Delete Terrain Points tool.

Usage

  • This tool functions only on feature classes embedded in a terrain. The terrain and at least one embedded feature class must already exist.

  • A rectangular area of interest (AOI) is required. This defines the area in the embedded feature class where multipoint vertices will be deleted. If a multipoint crosses the AOI boundary, only those vertices within the boundary will be deleted.

  • Remove Terrain Points looks for an existing edit session to piggyback on. This supports undo if the edit session was initialized to support undo (for example, using Editor inside ArcMap). If there's no edit session, it starts and stops one itself, in which case there is no chance for an undo.

  • To use this tool on a terrain inside an ArcSDE database, the terrain needs to be registered as versioned. You do this by registering the feature dataset the terrain resides in as versioned.

  • Removing points from an embedded feature class will invalidate the terrain. Run Build Terrain after adding points.

Syntax

arcpy.3d.RemoveTerrainPoints(in_terrain, data_source, aoi_extents)
ParameterExplanationData Type
in_terrain

The terrain dataset to be modified

Terrain Layer
data_source
[data_source,...]

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

String
aoi_extents

The XY extent defining the area from which points will be removed

Extent

Derived Output

NameExplanationData Type
derived_out_terrain

Terrain Layer

Code sample

Remove Terrain Points example (Python window)

The following Python Window script demonstrates how to use the RemoveTerrainPoints function in immediate mode.

import arcgisscripting
gp = arcgisscripting.create()

gp.workspace = "C:/data"
extent = "6442927 2053828 6452927 2065858"
gp.RemoveTerrainPoints_3d("sample.gdb/featuredataset/terrain", "napa_points", extent)

Licensing information

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