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
ReplaceTerrainPoints_3d (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 terrain point features that will have its source data replaced. | Feature Layer |
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 |
Code Sample
ReplaceTerrainPoints example 1 (Python window)
The following sample demonstrates the use of this tool in the Python window.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
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
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# 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
Licensing Information
- ArcGIS for Desktop Basic: Requires 3D Analyst
- ArcGIS for Desktop Standard: Requires 3D Analyst
- ArcGIS for Desktop Advanced: Requires 3D Analyst