Remove Terrain Pyramid Level (3D Analyst)

Available with 3D Analyst license.

Summary

Removes a pyramid level from a terrain dataset.

Usage

  • Any pyramid level can be removed except for level 0, which represents the full resolution pyramid.

  • When used in an enterprise geodatabase, the input terrain cannot be registered as versioned.

Parameters

LabelExplanationData Type
Input Terrain

The terrain dataset to process.

Terrain Layer
Pyramid Level Resolution

The pyramid level to be removed as specified by its resolution.

Double

Derived Output

LabelExplanationData Type
Updated Input Terrain

The updated terrain.

Terrain Layer

arcpy.ddd.RemoveTerrainPyramidLevel(in_terrain, pyramid_level_resolution)
NameExplanationData Type
in_terrain

The terrain dataset to process.

Terrain Layer
pyramid_level_resolution

The pyramid level to be removed as specified by its resolution.

Double

Derived Output

NameExplanationData Type
derived_out_terrain

The updated terrain.

Terrain Layer

Code sample

RemoveTerrainPyramidLevel example 1 (Python window)

The following sample demonstrates the use of this tool in the Python window.

arcpy.RemoveTerrainPyramidLevel_3d("c:/data/sample.gdb/featuredataset/terrain", 10)
RemoveTerrainPyramidLevel example 2 (stand-alone script)

The following sample demonstrates the use of this tool in a stand-alone Python script.

'''****************************************************************************
Name: RemoveTerrainPyramidLevel Example
Description: This script demonstrates how to add new 
             points to a terrain with the DeleteTerrainPoints tool, then use 
             the ChangeTerrainReferenceScale and RemoveTerrainPyramidLevel to
             to adjust the pyramids for reducing the amount of data stored for 
             providing an optimized display performance.
****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set Local Variables
inTerrain = "sample.gdb/featuredataset/terrain"
targetPts = "mass_pts_embed"
AOI = "1379938.43267328 235633.08128634 1382756.00752135 237681.848838107"

# Execute DeleteTerrainPoints
arcpy.DeleteTerrainPoints_3d(inTerrain, targetPts, AOI)
arcpy.AddMessage("Changing the terrain reference scale...")

# Execute ChangeTerrainReferenceScale
arcpy.ChangeTerrainReferenceScale_3d(inTerrain, 500, 1000)

# Execute RemoveTerrainPyramidLevel
arcpy.RemoveTerrainPyramidLevel_3d(inTerrain, 4)

Licensing information

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

Related topics