Skip to main content

Download Rasters (Data Management Tools)

Summary

Downloads the source files from an image service or mosaic dataset.

Usage

  • The raster datasets you download are the source files, unless you convert them to another format. Format conversion can be forced, or will only occur when required. Downloaded files are converted if clipping occurs or the source file cannot be downloaded as a raster.

  • You can download selected rasters or LAS files from an image service or a mosaic dataset to a specified folder in the original file format.

  • If a clipping extent is specified, the rasters that intersect the clip extent will be clipped and then converted to a specified format.

  • You can choose to download the data in the same folder structure as the source.

Parameters

Label Explanation Data type

Input

The image service or mosaic dataset to download.

Image Service; Mosaic Layer; Raster Layer; String

Output Folder

The destination for the image service or mosaic dataset.

Folder

Query Definition

(Optional)

An SQL expression to limit the download to raster datasets that satisfy the expression.

SQL Expression

Selection Feature

(Optional)

Limits the download to an extent of a feature class or bounding box. All raster datasets that intersect the extent will be downloaded.

  • Current Display Extent Map View—The extent will be based on the active map or scene.

  • Draw Extent Square and Finish—The extent will be based on a rectangle drawn on the map or scene.

  • Extent of a Layer Layer—The extent will be based on an active map layer. Choose an available layer or use the Extent of data in all layers option. Each map layer has the following options:

    • All Features Select All—The extent of all features.

    • Selected Features Area from Selected Features—The extent of the selected features.

    • Visible Features Extent Indicator—The extent of visible features.

  • Browse Browse—The extent will be based on a dataset.

  • Clipboard Paste—The extent can be copied to and from the clipboard.

    • Copy Extent Copy—Copies the extent and coordinate system to the clipboard.

    • Paste Extent Paste—Pastes the extent and coordinate system from the clipboard. If the clipboard does not include a coordinate system, the extent will use the map's coordinate system.

  • Reset Extent Reset—The extent will be reset to the default value.

When coordinates are manually provided, the coordinates must be numeric values and in the active map's coordinate system. The map may use different display units than the provided coordinates. Use a negative value sign for south and west coordinates.

Extent

Clipping Using Selection Feature

(Optional)

Specify if you want to clip the downloaded images based on the geometry of a feature. Any raster that intersects the clipping geometry will be clipped and then downloaded. This is useful when your area of interest is not a rectangle. When downloaded images are clipped, you need to specify an output format for the clipped images.

  • Checked—The files will be clipped based on the geometry of the selection_feature.

  • Unchecked—The files will be clipped based on the minimum bounding rectangle that has been specified. This is the default.

Boolean

Convert Rasters

(Optional)

Choose whether to always convert your rasters to the specified format, or to only convert when it is necessary.

  • Checked—Convert the downloaded raster datasets into another format. If you used the Selection Feature parameter to limit the extent, then you need to specify a format in the Output Format parameter.

  • Unchecked—Do not convert the raster datasets to a new format.

Boolean

Output Format

(Optional)

Choose a output format for the downloaded raster datasets.

  • Tiff—Tagged Image File Format. This is the default.

  • Bil—Esri band interleaved by line.

  • Bsq—Esri band sequential.

  • Bip—Esri band interleaved by pixel.

  • Bmp—Bitmap.

  • ENVI Dat—ENVI DAT file.

  • Imagine image—ERDAS IMAGINE.

  • Jpeg—Joint Photographics Experts Group. If chosen, you can also specify the compression quality. The valid compression quality value ranges are from 0 to 100.

  • Gif—Graphic interchange format.

  • Jp2—JPEG 2000. If chosen, you can also specify the compression quality. The valid compression quality value ranges are from 0 to 100.

  • Png—Portable Network Graphics.

String

Compression Method

(Optional)

Choose the compression method to use with the specified Output Format parameter value.

  • None—No compression will occur. This is the default.

  • Jpeg—Lossy compression that uses the public JPEG compression algorithm. If you choose JPEG, you can also specify the compression quality. The valid compression quality value ranges are from 0 to 100. This compression can be used for JPEG files and TIFF files.

  • Lzw—Lossless compression that preserves all raster cell values.

  • Packbits—PackBits compression for TIFF files.

  • Rle—Run-length encoding for IMG files.

  • Ccitt Group 3—Lossless compression for 1-bit data.

  • Ccitt Group 4—Lossless compression for 1-bit data.

  • Ccitt 1D—Lossless compression for 1-bit data.

String

Compression Quality

(Optional)

Set a value from 1 - 100. Higher values will have better image quality, but less compression.

Long

Maintain Folder Structure

(Optional)

Determines the folder structure of the downloaded rasters.

  • Checked—Replicate the hierarchical folder structure used to store the source raster datasets.

  • Unchecked—Raster datasets will be downloaded into the Output Folder parameter value as a flat folder structure.

Boolean

Derived output

Label Explanation Data type

Updated Folder

The updated output folder.

Folder

Environments

Extent

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes