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

LabelExplanationData 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

LabelExplanationData Type
Updated Input Terrain

The updated input terrain.

Terrain Layer

arcpy.ddd.ReplaceTerrainPoints(in_terrain, terrain_feature_class, in_point_features, {polygon_features_or_extent})
NameExplanationData 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

NameExplanationData 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
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.ddd.ReplaceTerrainPoints(InTerrain, TerrainFCl, InPoints)

Related topics