Replace Terrain Points (3D Analyst)—ArcGIS Pro

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.

Syntax

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

Parameter	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