Replace Terrain Points (3D Analyst)

Summary

Replaces points referenced by a terrain dataset with points from a specified feature class.

Usage

• The terrain data source can be points, multipoints, or embedded points.

• The replacement points can come from single-point or multipoint features.

• Replacing points in a terrain dataset will invalidate it. Run Build Terrain after adding points or multipoints.

Parameters

Dialog

Label	Explanation	Data Type
Input Terrain	The terrain dataset to process.	Terrain Layer
Input Terrain Data Source	The name of the terrain point feature class that will have some or all of its points replaced.	String
Input Points	The point or multipoint features that will replace the terrain point features.	Feature Layer
Area of Interest (Optional)	An optional area of interest can be used to define the extent of the area in which the terrain points would be replaced.	Feature Layer; Extent

Derived Output

Label	Explanation	Data Type
Updated Input Terrain	The updated input terrain.	Terrain Layer

Python

arcpy.ddd.ReplaceTerrainPoints(in_terrain, terrain_feature_class, in_point_features, {polygon_features_or_extent})

Name	Explanation	Data Type
in_terrain	The terrain dataset to process.	Terrain Layer
terrain_feature_class	The name of the terrain point feature class that will have some or all of its points replaced.	String
in_point_features	The point or multipoint features that will replace the terrain point features.	Feature Layer
polygon_features_or_extent (Optional)	An optional area of interest can be used to define the extent of the area in which the terrain points would be replaced.	Feature Layer; Extent

Derived Output

Name	Explanation	Data Type
derived_out_terrain	The updated input terrain.	Terrain Layer

Code sample

ReplaceTerrainPoints example 1 (Python window)

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

arcpy.env.workspace = "C:/data"
arcpy.ReplaceTerrainPoints_3d("sample.gdb/featuredataset/terrain", "points_old", 
                            "sample.gdb/featuredataset/terrain/pts_new")

ReplaceTerrainPoints example 2 (stand-alone script)

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

'''****************************************************************************
Name: ReplaceTerrainPoints Example
Description: This script demonstrates how to use the 
             ReplaceTerrainPoints tool.
****************************************************************************'''

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set Local Variables
InTerrain = "sample.gdb/featuredataset/terrain"
TerrainFCl = "points_old"
InPoints = "sample.gdb/featuredataset/terrain/pts_new"

#Execute ReplaceTerrainPoints
arcpy.ReplaceTerrainPoints_3d(InTerrain, TerrainFCl, InPoints)

Environments

Current Workspace, Auto Commit

Licensing information

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