Replace Terrain Points (3D Analyst)
Summary
Replaces point features used in 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.
If the terrain is in SDE, it must be registered as versioned.
Syntax
Parameter | Explanation | Data Type |
in_terrain |
The input terrain dataset. | 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
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")
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)