Available with 3D Analyst license.
Summary
This tool removes points within an area of interest from one or more embedded feature classes.
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
RemoveTerrainPoints_3d (in_terrain, data_source, aoi_extents)
| Parameter | Explanation | Data Type |
in_terrain | The terrain dataset to be modified | Terrain layer |
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 |
Code Sample
Remove Terrain Points example (Python window)
The following Python Window script demonstrates how to use the Remove Terrain Pointsfunction in immediate mode.
import arcgisscripting
gp = arcgisscripting.create()
gp.CheckOutExtension("3D")
gp.workspace = "C:/data"
extent = "6442927 2053828 6452927 2065858"
gp.RemoveTerrainPoints_3d("sample.gdb/featuredataset/terrain", "napa_points", extent)
Environments
Licensing Information
- ArcGIS for Desktop Basic: Requires 3D Analyst
- ArcGIS for Desktop Standard: Requires 3D Analyst
- ArcGIS for Desktop Advanced: Requires 3D Analyst