Create Referenced Mosaic Dataset (Data Management)
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
| Parameter | Explanation | Data Type |
in_dataset |
The input raster catalog or mosaic dataset. | Mosaic Layer; Mosaic Dataset; Raster Catalog Layer |
out_mosaic_dataset |
The folder location or geodatabase where the mosaic dataset will be created. | Mosaic Dataset |
coordinate_system (Optional) |
The coordinate system defined for the mosaic dataset, which will be used for all the associated files created. | Spatial Reference |
number_of_bands (Optional) |
The number of raster dataset bands supported by the mosaic dataset. | Long |
pixel_type (Optional) |
The bit depth of a cell, used to determine the range of values that the mosaic dataset outputs. For example, an 8-bit mosaic dataset can have 256 unique pixel values, which range from 0 to 255. If it is not defined, it will be taken from the first raster dataset.
| String |
where_clause (Optional) |
Use SQL to define a query, or use the Query Builder to build a query that identifies the raster datasets to be added to the mosaic dataset from the raster catalog or mosaic definition. | SQL Expression |
in_template_dataset (Optional) |
Uses the extent of the specified raster dataset or feature class to define the extent of the raster datasets used in the mosaic dataset from the raster catalog or mosaic dataset. Rasters that lay along the defined extent will be included in the mosaic dataset. The input is not limited to a polygon feature class. | Feature Layer;Raster Layer |
extent (Optional) |
The minimum and maximum x- and y-coordinates used to define the rectangular extent of the raster datasets used in the mosaic dataset from the raster catalog or mosaic dataset. | Envelope |
select_using_features (Optional) |
If a feature class is specified, you can choose to limit the extent to its envelope or clipped to the feature. To use this, the input must be a polygon 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) |
A field in the raster catalog table defining the minimum cell size of the raster at which the mosaic should be displayed; otherwise, a wire frame will be displayed. | Field |
maxPS_field (Optional) |
A field in the raster catalog table defining the maximum cell size of the raster at which the mosaic should be displayed; otherwise, a wire frame will be displayed. | Field |
pixelSize (Optional) |
The maximum cell size in which the mosaic will be displayed. If the mosaic is displayed above this resolution, a wire frame will be displayed. | Double |
build_boundary (Optional) |
Generates the boundary polygon for the mosaic dataset. By default, the boundary merges all the footprint polygons to create a single boundary representing the extent of the valid pixels. This is only available if the mosaic dataset is created within a geodatabase.
| Boolean |
Code Sample
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")
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")