Replace Terrain Points (3D Analyst)

License Level:BasicStandardAdvanced

Summary

Replaces point features used in a terrain dataset with points from a specified feature class.

Usage

Syntax

ReplaceTerrainPoints_3d (in_terrain, terrain_feature_class, in_point_features, {polygon_features_or_extent})
ParameterExplanationData 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

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

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Requires 3D Analyst
ArcGIS for Desktop Standard: Requires 3D Analyst
ArcGIS for Desktop Advanced: Requires 3D Analyst
11/8/2012