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.
Syntax
arcpy.management.DownloadRasters(in_image_service, out_folder, {where_clause}, {selection_feature}, {clipping}, {convert_rasters}, {format}, {compression_method}, {compression_quality}, {MAINTAIN_FOLDER})
Parameter | Explanation | Data Type |
in_image_service | The image service or mosaic dataset to download. | Image Service; Mosaic Layer; Raster Layer; String |
out_folder | The destination for the image service or mosaic dataset. | Folder |
where_clause (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.
| Extent |
clipping (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.
| Boolean |
convert_rasters (Optional) | Choose whether to always convert your rasters to the specified format, or to only convert when it is necessary.
| Boolean |
format (Optional) | Choose a output format for the downloaded raster datasets.
| String |
compression_method (Optional) | Choose the compression method to use with the specified Output Format.
| String |
compression_quality (Optional) | Set a value from 1 - 100. Higher values will have better image quality, but less compression. | Long |
MAINTAIN_FOLDER (Optional) | Determines the folder structure of the downloaded rasters.
| Boolean |
Derived Output
Name | Explanation | Data Type |
derived_out_folder | The updated output folder. | Folder |
Code sample
This is a Python sample for the DownloadRasters tool.
import arcpy
DownloadRasters_management(
"http://srv/arcgis/services/Ext/MDpan/ImageServer?", "c:/dload/",
"AcquisitionDate = date '1999-08-18'", "",
"c:/workspace/clippingfeat.shp", "TIFF", "JPEG", "75",
"MAINTAIN_FOLDER", "CONVERT_AS_REQUIRED")
This is a Python script sample for the DownloadRasters tool.
##Download Rasters from image services URL
##Maintain the original sensor data folder structure
import arcpy
arcpy.env.workspace = r"\\myworkstation\Workspace\downloadras"
arcpy.DownloadRasters_management(
"http://serv1/arcgis/services/Ext/MD_LS_pan/ImageServer?",
"downloadFolder", "AcquisitionDate = date '1999-08-18 00:00:00'",
"", "", "", "", "", "MAINTAIN_FOLDER")
Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes