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...

Build Overviews

  • Summary
  • Usage
  • Syntax
  • Code sample
  • Environments
  • Licensing information

Summary

Defines and generates overviews on a mosaic dataset.

Usage

  • This tool will honor the default mosaic dataset settings, not the properties set on a mosaic dataset layer. For instance, the tool will not accept layer property changes such as band count, mosaic method, extent, or query—these properties will be determined by the mosaic dataset and default properties of the mosaic dataset.

  • You must check on Define missing overview tiles, Generate overviews, or both.

  • The first overview level is created on the full resolution of the mosaic dataset. Each subsequent level is built on the last overview level that was generated.

  • If you need more control over the definition of the overviews, use the Define Overviews tool first.

  • By default, the overviews generated for mosaic datasets in a file geodatabase and personal geodatabase are stored in a folder <gdbname>.Overviews in the same location where the geodatabase containing the mosaic dataset exists. The overviews generated for mosaic datasets on the enterprise geodatabase are stored within the geodatabase containing the mosaic dataset. These locations can be changed by first using the Define Overviews tool and specifying a location.

  • You cannot build overviews for a referenced mosaic dataset.

Syntax

BuildOverviews_management (in_mosaic_dataset, {where_clause}, {define_missing_tiles}, {generate_overviews}, {generate_missing_images}, {regenerate_stale_images})
ParameterExplanationData Type
in_mosaic_dataset

The mosaic dataset where you want to build overviews.

Mosaic Layer
where_clause
(Optional)

An SQL statement to select specific rasters within the mosaic dataset. The selected rasters will have their overview built.

SQL Expression
define_missing_tiles
(Optional)

Identify where overviews are needed and define them.

  • DEFINE_MISSING_TILES —Automatically identify where overviews are needed and define them. This is the default.
  • NO_DEFINE_MISSING_TILES — Do not define new overviews.
Boolean
generate_overviews
(Optional)

Generate all overviews that need to be created or re-created. This includes missing overviews and stale overviews.

  • GENERATE_OVERVIEWS —Generate all overviews, including those that already exist. This is the default.
  • NO_GENERATE_OVERVIEWS —Generate only the overviews that have been defined but not yet generated.
Boolean
generate_missing_images
(Optional)

Use if overviews have been defined but not generated.

  • GENERATE_MISSING_IMAGES —Generate overviews that have been defined but not generated. This is the default.
  • IGNORE_MISSING_IMAGES — Do not generate overviews that have been defined but not generated.
Boolean
regenerate_stale_images
(Optional)

Overviews become stale when you change the underlying raster datasets or modify their properties.

  • REGENERATE_STALE_IMAGES —Identify and regenerate stale overviews. This is the default.
  • IGNORE_STALE_IMAGES — Do not regenerate stale overviews.
Boolean

Code sample

BuildOverviews example 1 (Python window)

This is a Python sample for BuildOverviews.

import arcpy
arcpy.BuildOverviews_management(
     "C:/Workspace/Overviews.gdb/md", "OBJECTID<5", "DEFINE_MISSING_TILES", 
     "NO_GENERATE_OVERVIEWS", "IGNORE_MISSING_IMAGES", "IGNORE_STALE_IMAGES")
BuildOverviews example 2 (stand-alone script)

This is a Python script sample for BuildOverviews.

# Define Overviews for selected items only

import arcpy
arcpy.env.workspace = "C:/Workspace"

    
arcpy.BuildOverviews_management("Overviews.gdb/md", "OBJECTID<5", 
                                "DEFINE_MISSING_TILES",
                                "NO_GENERATE_OVERVIEWS", "#", "#")

Environments

  • Extent
  • Parallel Processing Factor

Licensing information

  • ArcGIS for Desktop Basic: No
  • ArcGIS for Desktop Standard: Yes
  • ArcGIS for Desktop Advanced: Yes

Related topics

  • An overview of the Raster toolset
  • Environment settings for raster data
  • Mosaic dataset overviews

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
Tell us what you think.
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal