ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • Help
  • Sign Out
ArcGIS Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS Desktop

A complete professional GIS

ArcGIS Enterprise

GIS in your enterprise

ArcGIS Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

ArcMap

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • Extensions

Add Terrain Points

  • Summary
  • Usage
  • Syntax
  • Environments
  • Licensing information

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 that has been superseded by 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 Extent 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 enterprise 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 the Build Terrain tool after adding points.

Syntax

arcpy.ddd.AddTerrainPoints(in_terrain, terrain_feature_class, in_feature_class, {method})
ParameterExplanationData 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

Derived Output

NameExplanationData Type
derived_out_terrain

Terrain Layer

Environments

  • Current Workspace
  • Scratch Workspace
  • Extent

Licensing information

  • Basic: Requires 3D Analyst
  • Standard: Requires 3D Analyst
  • Advanced: Requires 3D Analyst

Related topics

  • An overview of the Data Management toolset
  • What is a terrain dataset?
  • Benefits of using terrain datasets

ArcGIS Desktop

  • Home
  • Documentation
  • Support

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Esri Blog
  • User Conference
  • Developer Summit
Esri
Tell us what you think.
Copyright © 2021 Esri. | Privacy | Legal