ArcGIS Help 10.2 - Remove Terrain Pyramid Level (3D Analyst)

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 ArcSDE database, the input terrain cannot be registered as versioned.

Syntax

RemoveTerrainPyramidLevel_3d (in_terrain, pyramid_level_resolution)

Parameter	Explanation	Data Type
in_terrain	The input terrain dataset.	Terrain Layer
pyramid_level_resolution	The pyramid level to be removed as specified by its resolution.	Double

Code Sample

RemoveTerrainPyramidLevel 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.RemoveTerrainPyramidLevel_3d("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
from arcpy import env
import traceback, sys

try:
    # 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"
    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)

except arcpy.ExecuteError:
    print arcpy.GetMessages()
except:
    # Get the traceback object
    tb = sys.exc_info()[2]
    tbinfo = traceback.format_tb(tb)[0]
    # Concatenate error information into message string
    pymsg = "PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}"\
          .format(tbinfo, str(sys.exc_info()[1]))
    msgs = "ArcPy ERRORS:\n {0}\n".format(arcpy.GetMessages(2))
    # Return python error messages for script tool or Python Window
    arcpy.AddError(pymsg)
    arcpy.AddError(msgs)

Environments

Current Workspace, Auto Commit

Licensing Information

ArcGIS for Desktop Basic: Requires 3D Analyst

ArcGIS for Desktop Standard: Requires 3D Analyst

ArcGIS for Desktop Advanced: Requires 3D Analyst

3/7/2014

Remove Terrain Pyramid Level (3D Analyst)