ArcGIS for Desktop

  • Documentation
  • Pricing
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS for Desktop

A complete professional GIS

ArcGIS for Server

GIS in your enterprise

ArcGIS for 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
  • Pricing
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

Help

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • More...

Remove Terrain Pyramid Level

Available with 3D Analyst license.

  • Summary
  • Usage
  • Syntax
  • Code Sample
  • Environments
  • Licensing Information

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, workgroup, or desktop geodatabase database, the input terrain cannot be registered as versioned.

Syntax

RemoveTerrainPyramidLevel_3d (in_terrain, pyramid_level_resolution)
ParameterExplanationData 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

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

Related Topics

  • An overview of the Data Management toolset
  • Fundamentals of Surfaces
  • Surface formats
  • What is a terrain dataset?
  • Benefits of using terrain datasets
Feedback on this topic?

ArcGIS for Desktop

  • Home
  • Documentation
  • Pricing
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal