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
Related Topics
Licensing Information
ArcView: Requires 3D Analyst
ArcEditor: Requires 3D Analyst
ArcInfo: Requires 3D Analyst
6/10/2013