Replace Terrain Points (3D Analyst Tools)

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.

Label	Explanation	Data type
Input Terrain	The terrain dataset that will be processed.	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

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

Name	Explanation	Data type
in_terrain	The terrain dataset that will be processed.	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.ddd.ReplaceTerrainPoints("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

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

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

# Run ReplaceTerrainPoints
arcpy.ddd.ReplaceTerrainPoints(InTerrain, TerrainFCl, InPoints)

Environments

Current Workspace, Auto Commit

Licensing information

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

Replace Terrain Points (3D Analyst Tools)

Summary

Usage

Parameters

Derived output

Environments

Licensing information

Related topics