Add Terrain Points (3D Analyst)
Summary
Adds multipoints to an embedded terrain feature class by appending them or by using them to replace existing multipoints that fall within the same extent.
Legacy:This is a deprecated tool. To learn more about how this tool works click here to view archived documentation. This functionality has been added to the Append Terrain Points tool.
Usage
-
This tool adds multipoints to a feature class embedded in a terrain. The terrain and the embedded feature class must already exist.
-
Only multipoints can be embedded in a terrain. Therefore, the input feature class must be of type multipoint.
-
This tool performs two types of operations: APPEND and REPLACE. Use the method argument to indicate which mode of operation you want to use.
-
Either operation uses a rectangular Area Of Interest (AOI). By default, the AOI is equal to the extent of the input feature class. The Geoprocessing Environment can be used to define a specific extent if a subset of the input feature class is desired. In the case of APPEND, the vertices of the input feature class that fall within the AOI will be added. REPLACE works in two phases. First, vertices of the embedded feature class that fall within the AOI are deleted. Then, those within the AOI of the source feature class are added. If a multipoint crosses the AOI boundary only those vertices within the boundary are operated on.
-
If you want to add points to a regular feature class, potentially referenced by a terrain but not embedded in it, use the Append tool.
-
Add Terrain Points looks for an existing edit session to piggy-back on. This supports undo if the edit session was initialized to support undo (e.g., using the Editor inside ArcMap™). If there's no edit session, it starts and stops one itself, in which case there is no chance for an undo.
-
In order to use this tool on a terrain inside an SDE™ database, the terrain needs to be registered as versioned. You do this by registering the feature dataset the terrain lives in as versioned.
-
Adding points to an embedded feature class will invalidate the terrain. Run Build Terrain after adding points.
Syntax
| Parameter | Explanation | Data Type |
in_terrain |
The terrain dataset to be modified. | Terrain Layer |
terrain_feature_class |
The embedded feature class to which points will be added. | String |
in_feature_class |
The feature class containing the points to be added. | Feature Layer |
method (Optional) |
Indicates whether points are appended to the target or used to replace those in the target. | String |
Code Sample
The following sample demonstrates how to use this tool in the Python window:
import arcgisscripting
gp = arcgisscripting.create()
gp.CheckOutExtension("3D")
gp.workspace = "C:/data"
gp.AddTerrainPoints_3d("sample.gdb/featuredataset/terrain", "mass_points", "new_points.shp", "APPEND")