Help

Create Referenced Mosaic Dataset

Summary

Creates a new mosaic dataset from an existing raster catalog, a selection set from a raster catalog, or a mosaic dataset.

Usage

  • This mosaic dataset can be created within or outside a geodatabase. When not created within a geodatabase,

    • A boundary will not be created.
    • The file will have a .amd extension.

  • If the input is an RPF raster catalog created using Military Analyst, the Scale Field should be specified.

  • Overviews cannot be created for a referenced mosaic dataset.

  • A referenced mosaic dataset is one option for serving a raster catalog as an image service; however, you can also create a fully capable mosaic dataset from a raster catalog using the Create Mosaic Dataset tool followed by the Add Rasters To Mosaic Dataset tool.

  • You may use this tool to create a mosaic dataset from another mosaic dataset to create a mosaic dataset with a different output. For example, you may create one mosaic dataset with elevation data, then create another that will be used to produce a derived product, such as slope or hillshade.

Syntax

CreateReferencedMosaicDataset_management (in_dataset, out_mosaic_dataset, {coordinate_system}, {number_of_bands}, {pixel_type}, {where_clause}, {in_template_dataset}, {extent}, {select_using_features}, {lod_field}, {minPS_field}, {maxPS_field}, {pixelSize}, {build_boundary})
ParameterExplanationData Type
in_dataset

The input raster catalog or mosaic dataset.

Mosaic Layer; Mosaic Dataset; Raster Catalog Layer
out_mosaic_dataset

The referenced mosaic dataset that you want to create.

Mosaic Dataset
coordinate_system
(Optional)

The projection for the output mosaic dataset.

Spatial Reference
number_of_bands
(Optional)

The number of bands that the referenced mosaic dataset will have.

Long
pixel_type
(Optional)

The bit depth, or radiometric resolution, of the mosaic dataset. If not defined, it will be taken from the first raster dataset.

  • 1_BIT —A 1-bit unsigned integer. The values can be 0 or 1.
  • 2_BIT —A 2-bit unsigned integer. The values supported can be from 0 to 3.
  • 4_BIT —A 4-bit unsigned integer. The values supported can be from 0 to 15.
  • 8_BIT_UNSIGNED —An unsigned 8-bit data type. The values supported can be from 0 to 255.
  • 8_BIT_SIGNED —A signed 8-bit data type. The values supported can be from -128 to 127.
  • 16_BIT_UNSIGNED —A 16-bit unsigned data type. The values can range from 0 to 65,535.
  • 16_BIT_SIGNED —A 16-bit signed data type. The values can range from -32,768 to 32,767.
  • 32_BIT_UNSIGNED —A 32-bit unsigned data type. The values can range from 0 to 4,294,967,295.
  • 32_BIT_SIGNED —A 32-bit signed data type. The values can range from -2,147,483,648 to 2,147,483,647.
  • 32_BIT_FLOAT —A 32-bit data type supporting decimals.
  • 64_BIT —A 64-bit data type supporting decimals.
String
where_clause
(Optional)

An SQL expression to select raster datasets that will be included in the output mosaic dataset.

SQL Expression
in_template_dataset
(Optional)

Selects raster datasets based on the extent of another image or feature class. Raster datasets that lay along the defined extent will be included in the mosaic dataset. To manually input the minimum and maximum coordinates for the extent, use the Extent parameter.

Feature Layer; Raster Layer
extent
(Optional)

The minimum and maximum coordinates for the extent.

Envelope
select_using_features
(Optional)

Limit the extent to the shape or envelope when a feature class is specified in the in_template_dataset parameter.

  • SELECT_USING_FEATURES —Select using the shape of the feature. This is the default.
  • NO_SELECT_USING_FEATURES —Select using the extent of the data within the feature class.
Boolean
lod_field
(Optional)

A field in the raster catalog table defining the map scales at which the mosaic should be displayed; otherwise, a wire frame will be displayed.

Field
minPS_field
(Optional)

Specify a field from the footprint attribute table that defines the minimum cell size for displaying the mosaic dataset; otherwise, only a footprint will be displayed.

Field
maxPS_field
(Optional)

Specify a field from the footprint attribute table that defines the maximum cell size for displaying the mosaic dataset; otherwise, only a footprint will be displayed.

Field
pixelSize
(Optional)

Set a maximum cell size to display the mosaic, instead of specifying a field. If you zoom out beyond this cell size, only the footprint will be displayed.

Double
build_boundary
(Optional)

Rebuild the boundary. If the selection covers a smaller area than the source mosaic dataset, this is recommended.

This is only available if the mosaic dataset is created within a geodatabase.

  • BUILD_BOUNDARY —The boundary will be generated or updated. This is the default.
  • NO_BOUNDARY — The boundary will not be generated.
Boolean

Code sample

CreateReferencedMosaicDataset example 1 (Python window)

This is a Python sample for CreateReferencedMosaicDataset.

import arcpy
arcpy.CreateReferencedMosaicDataset_management(
     "C:/workspace/RefMD.gdb/md", "ref_md.amd", "GCS_WGS_1984.prj",
     "1", "#", "#", "ref_md.shp", "#", "SELECT_USING_FEATURES", "#", 
     "#", "#", "#", "NO_BOUNDARY")
CreateReferencedMosaicDataset example 2 (stand-alone script)

This is a Python script sample for CreateReferencedMosaicDataset.

# Create Referenced Mosaic Dataset from existing Mosaic Dataset
# Use shape file to clip the source mosaic dataset


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

arcpy.CreateReferencedMosaicDataset_management(
     "RefMD.gdb/md", "ref_md.amd", "GCS_WGS_1984.prj", "1", "#", "#", 
     "ref_md.shp", "#", "SELECT_USING_FEATURES", "#", "#", "#", "#", 
     "NO_BOUNDARY")

Environments

Licensing information

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

Related topics