Replace Terrain Points (3D Analyst)


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


  • 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.


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

The terrain dataset to process.

Terrain Layer

The name of the terrain point feature class that will have some or all of its points replaced.


The point or multipoint features that will replace the terrain point features.

Feature Layer

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

NameExplanationData Type

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", 
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)

Licensing information

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

Related topics