Mosaic Dataset To Mobile Mosaic Dataset (Data Management)

Summary

Converts a mosaic dataset into a mobile mosaic dataset compatible with ArcGIS Runtime SDK. A mobile mosaic dataset resides in a mobile geodatabase.

Usage

  • When converting to a mobile mosaic dataset, you have the option to apply raster functions that are associated with the mosaic dataset by checking Convert Rasters (convert_rasters='ALWAYS' in Python). Leaving Convert Rasters unchecked will only convert the source data.

Parameters

LabelExplanationData Type
Mosaic Dataset

The mosaic dataset to be converted to a mobile mosaic dataset.

Mosaic Dataset; Mosaic Layer
Mobile Geodatabase

The geodatabase where the converted mosaic dataset will be created.

File
Mosaic Dataset Name

The name of the mobile mosaic dataset to be created.

String
Query Definition
(Optional)

An SQL expression to select specific items to add to the mobile mosaic dataset.

SQL Expression
Selection Feature
(Optional)

The mosaic dataset items to be included in the output based on the extent of another image or feature class. Items that lay along the defined extent will be included in the mosaic dataset. They will not be clipped.

  • Current Display Extent Map View—The extent will be based on the active map or scene. This option is only available when there is an active map.
  • Draw Extent Square and Finish—The extent will be based on a rectangle drawn on the map or scene. This option will create a feature class in the project geodatabase and add a layer to the map. The feature class will have the same coordinate system as the map.
    Note:

    This option is not available in the Environments dialog box. It is only available from a tool parameter with an extent data type or from the Environments tab on a tool dialog box.

    Note:

    When the Enable and disable editing from the Edit tab editing option is checked, you must enable editing on the Edit ribbon tab to draw the extent.

  • Extent of a Layer Layer—The extent will be based on an active map layer. Use the drop-down list to choose an available layer or use the Extent of data in all layers option to get the combined extent of all active map layers, excluding the basemap. This option is only available when there is an active map with layers.

    Each map layer has the following options:

    • All Features Select All—The extent of all features in the layer.
    • Selected Features Area from Selected Features—The extent of the selected features in the layer.
    • Visible Features Extent Indicator—The extent of the visible features in the layer.
      Note:

      The extents from the Selected Features Area from Selected Features and Visible Features Extent Indicator options are only available for feature layers.

  • Browse Browse—The extent will be based on an existing dataset.
  • Clipboard Paste—The extent can be copied to and pasted from the clipboard.
    • Copy Extent Copy—Copies the extent coordinates and coordinate system to the clipboard.
    • Use Paste Extent Paste—Pastes the extent coordinates and, optionally, the coordinate system from the clipboard. If the clipboard values do not include a coordinate system, the extent will use the map’s coordinate system.
    Note:

    The extent coordinates are copied to and pasted from the clipboard using the same formatting and order as the ArcPy Extent object: x-min, y-min, x-max, y-max, and the spatial reference.

  • Reset Extent Reset—The extent will be reset to the default value.
  • Manually entered coordinates—The coordinates must be numeric values and in the active map's coordinate system.
    Caution:

    The map may use different display units than the entered coordinates. The use of a cardinal direction (N, S, E, W) is not supported. Use a negative value sign for south and west coordinates.

Extent
Output Data Folder
(Optional)

If specified, the tool will create a copy of the source data in this folder. If Convert Rasters is checked, any raster functions associated with the mosaic dataset are processed before creating the copy.

Folder
Convert Rasters
(Optional)

Applies the raster functions associated with the input mosaic dataset before creating the mobile mosaic dataset. If checked and you have raster functions that are not supported by ArcGIS Runtime SDK, the tool will apply the raster function chain and save the output as converted raster items. If left unchecked, the tool will not convert raster items. If you have raster functions that are not supported by ArcGIS Runtime SDK, the tool will return the appropriate error message.

  • Unchecked—Do not convert raster items with functions that are not supported by ArcGIS Runtime SDK. This is the default.
  • Checked—Apply the raster function chain and save the output as converted raster items.
Boolean
Output Base Name
(Optional)

Appends a prefix to each item, which is copied or converted into the output data folder.

String
Output Format
(Optional)

The format for the rasters written to the output data folder.

  • TIFFTIFF format
  • PNGPNG format
  • JPEGJPEG format
  • JPEG2000JPEG2000 format
String
Compression Method
(Optional)

The method of compression for transmitting the mosaicked image from the computer to the display (or from the server to the client).

  • NoneNo compression will be used.
  • JPEGCompresses up to 8:1 and is suitable for backdrops.
  • LZ77Compresses approximately 2:1. Suitable for analysis.
  • RLELossless compression. Suitable for categorical datasets.
String
Compression Quality
(Optional)

A value from 0 to 100. A higher number means better image quality but less compression. Only enabled when JPEG or JP2000 is specified as the compression method.

Long

Derived Output

LabelExplanationData Type
Output Mosaic Dataset

The updated mosaic dataset.

Mosaic Dataset

arcpy.management.MosaicDatasetToMobileMosaicDataset(in_mosaic_dataset, out_mobile_gdb, mosaic_dataset_name, {where_clause}, {selection_feature}, {out_data_folder}, {convert_rasters}, {out_name_prefix}, {format}, {compression_method}, {compression_quality})
NameExplanationData Type
in_mosaic_dataset

The mosaic dataset to be converted to a mobile mosaic dataset.

Mosaic Dataset; Mosaic Layer
out_mobile_gdb

The geodatabase where the converted mosaic dataset will be created.

File
mosaic_dataset_name

The name of the mobile mosaic dataset to be created.

String
where_clause
(Optional)

An SQL expression to select specific items to add to the mobile mosaic dataset.

SQL Expression
selection_feature
(Optional)

The mosaic dataset items to be included in the output based on the extent of another image or feature class. Items that lay along the defined extent will be included in the mosaic dataset. They will not be clipped.

  • MAXOF—The maximum extent of all inputs will be used.
  • MINOF—The minimum area common to all inputs will be used.
  • DISPLAY—The extent is equal to the visible display.
  • Layer name—The extent of the specified layer will be used.
  • Extent object—The extent of the specified object will be used.
  • Space delimited string of coordinates—The extent of the specified string will be used. Coordinates are expressed in the order of x-min, y-min, x-max, y-max.
Extent
out_data_folder
(Optional)

If specified, the tool will create a copy of the source data in this folder. If convert_rasters='ALWAYS', any raster functions associated with the mosaic dataset are processed before creating the copy.

Folder
convert_rasters
(Optional)

Applies the raster functions associated with the input mosaic dataset before creating the mobile mosaic dataset. If you have raster functions that are not supported by ArcGIS Runtime SDK, the tool will return the appropriate error message.

  • AS_REQUIREDDo not convert raster items with functions that are not supported by ArcGIS Runtime SDK. This is the default.
  • ALWAYSApply the raster function chain and save the output as converted raster items.
Boolean
out_name_prefix
(Optional)

Appends a prefix to each item, which is copied or converted into the output data folder.

String
format
(Optional)

The format for the rasters written to the output data folder.

  • TIFFTIFF format
  • PNGPNG format
  • JPEGJPEG format
  • JP2JPEG2000 format
String
compression_method
(Optional)

The method of compression for transmitting the mosaicked image from the computer to the display (or from the server to the client).

  • NONENo compression will be used.
  • JPEGCompresses up to 8:1 and is suitable for backdrops.
  • LZWCompresses approximately 2:1. Suitable for analysis.
  • RLELossless compression. Suitable for categorical datasets.
String
compression_quality
(Optional)

A value from 0 to 100. A higher number means better image quality but less compression. This value only applies when JPEG or JP2 is specified as the compression method.

Long

Derived Output

NameExplanationData Type
out_mosaic_dataset

The updated mosaic dataset.

Mosaic Dataset

Code sample

MosaicDatasetToMobileMosaicDataset example (Python window)

This is a Python sample for the MosaicDatasetToMobileMosaicDataset tool.

import arcpy

arcpy.MosaicDatasetToMobileMosaicDataset_management( 
	“c:/someproject/md/fgdb.gdb/somemd”,
	“c:/someproject/runtime/somesql.geodatabase”, 
	“somemd”, “ProductName == ‘Landsat8’”, 
	“c:/someproject/aoi/somefc.shp”,
	“c:/someproject/runtime/data”, 
	“ALWAYS”, “TIFF”, “JPEG”, “75”)

Environments