generate_direct_access_url¶
-
arcgis.raster.utils.generate_direct_access_url(expiration=None, *, gis=None)¶ Function to get the direct access url for user’s rasterStore on ArcGIS Online.
Parameter
Description
expiration
Optional integer. Direct access URL expiration time in minutes. (The default is 1440 ie. 24 hours)
gis
Keyword only parameter. Optional
GIS. The GIS on which this function runs. If not specified, the active GIS is used.- Returns
String. Direct Access URL
upload_imagery_to_agol_userstore¶
-
arcgis.raster.utils.upload_imagery_to_agol_userstore(files, direct_access_url=None, auto_renew=True, upload_properties=None, *, gis=None)¶ Uploads file/files to the user’s rasterstore on ArcGIS Online and returns the list of urls.
The list of urls can then be used with
copy_raster()orcreate_image_collection()method to create imagery layers on ArcGIS Online.For this functionality to work, Azure library packages for Python (Azure SDK for Python - azure-storage-blob: 12.1<= version <=12.17) needs to be pre-installed. Refer https://docs.microsoft.com/en-us/azure/storage/blobs/storage-quickstart-blobs-python#install-the-package
Parameter
Description
files
Required. It can be a folder, list of files or single file that needs to be uploaded.
direct_access_url
Optional string. The direct access url generated using
generate_direct_access_url(). If not specified, the function would generate the direct access url internally which is valid for 1440 minutes.auto_renew
Optional boolean. If set to True, function would continue uploading until the entire data is uploaded by auto renewing the direct access url. (The default is True)
upload_properties
Optional dictionary.upload_propertiescan be used to control specific upload parameters.Available options:
maxUploadConcurrency: Optional integer. Maximum number of parallel connections to use for large uploads (when individual file/blob size exceeds 64MB). This is the max_concurrency parameter of the BlobClient.upload_blob() method. (The default is 6)maxWorkerThreads: Optional integer. Maximum number of threads to execute asynchronously when uploading multiple files. This is the max_workers parameter of the ThreadPoolExecutor() class. (The default is None)displayProgress: Optional boolean. If set to True, a progress bar will be displayed for tracking the progress of the uploads to user’s rasterstore. (The default is False)Example:
{“maxUploadConcurrency”:8,“maxWorkerThreads”:20,“displayProgress”:True}
gis
Keyword only parameter. Optional
GIS. The GIS on which this function runs. If not specified, the active GIS is used.- Returns
List of file paths.
# Usage Example: Generates an expirable direct access url and uploads files to the user's raster store. sas_url = generate_direct_access_url(expiration=180, gis=gis) uploaded_imagery = upload_imagery_to_agol_userstore(files=r"/path/to/data", direct_access_url=sas_url, upload_properties={"displayProgress":True}, gis=gis ) # Following snippet executes the copy_raster() function on the uploaded imagery to create imagery layer item on ArcGIS Online. copy_raster_op = copy_raster(input_raster=uploaded_imagery, raster_type_name="Raster Dataset", output_name="output_layer", gis=gis)
publish_hosted_imagery_layer¶
-
arcgis.raster.utils.publish_hosted_imagery_layer(input_data, layer_configuration, tiles_only=False, raster_type_name=None, raster_type_params=None, source_mosaic=None, output_name=None, context=None, *, gis=None, future=False, **kwargs)¶ The function can create hosted imagery layers in ArcGIS Enterprise and ArcGIS Online from local raster datasets by uploading the data to the server. Multiple images are mosaicked into a single dataset to create one layer. A collection can also be created from multiple input rasters.
Parameter
Description
input_data
Required list. The list of input raster paths(s) to be added to the imagery layer being created.
Note
You can also upload an existing mosaic dataset and create an imagery layer by specifying the mosaic dataset path as input to source_mosaic parameter. The input_data param can then be used to specify local raster dataset path(s) in the mosaic dataset.
layer_configuration
Required String.
ONE_IMAGE: Uses a single, processed image or mosaics multiple images into a single dataset to create one layer. This option supports all common image formats and satellite products at various levels.
IMAGE_COLLECTION: Manages a collection of images using a single layer and mosaics images dynamically. Each image can be accessed independently. This option supports all common image formats and satellite products at various levels.
tiles_only
Optional boolean. If set to True, function will generate a tiles only layer otherwise will generate a dynamic imagery layer.
True - Provides imagery access as static tiles and associated metadata. Supports client-side processing and rendering. Can be used as an input to raster analysis.
False - Provides versatile dynamic imagery access capabilities. Supports on-demand server-side processing and dynamic mosaicking. Supports managing a collection of images. Can be used as an input to raster analysis.
raster_type_name
Required string. The name of the raster type to use for adding data.
Choice list:
[“Aerial”, “ASTER”, “DMCII”, “DubaiSat-2”, “GeoEye-1”, “GF-1 PMS”, “GF-1 WFV”,“GF-2 PMS”, “GRIB”, “HDF”, “IKONOS”, “Jilin-1”, “KOMPSAT-2”, “KOMPSAT-3”,“Landsat 1-5 MSS”, “Landsat 4-5 TM”, “Landsat 7 ETM+”, “Landsat 8”, “Landsat 9”,“NetCDF”, “PlanetScope”, “Pleiades-1”, “Pleiades NEO”, “QuickBird”, “RapidEye”,“Raster Dataset”, “ScannedAerial”, “Sentinel-2”, “SkySat”, “SPOT 5”, “SPOT 6”,“SPOT 7”, “Superview-1”, “Tiled Imagery Layer”, “UAV/UAS”, “WordView-1”,“WordView-2”, “WordView-3”, “WordView-4”, “ZY3-SASMAC”, “ZY3-CRESDA”]If an existing mosaic dataset is being published as a dynamic imagery layer using the
source_mosaic_datasetparameter, theraster_type_nameparameter can be set to None as it is not required.Example:
“QuickBird”
raster_type_params
Optional dict. Additional
raster_typespecific parameters.The process of add rasters can be controlled by specifying additional raster type arguments.
The raster type parameters argument is a dictionary.
The dictionary can contain productType, processingTemplate, pansharpenType, Filter, pansharpenWeights, ConstantZ, dem, zoffset, CorrectGeoid, ZFactor, StretchType, ScaleFactor, ValidRange
Please check the table below (Supported Raster Types), for more details about the product types, processing templates, pansharpen weights for each raster type.
Possible values for pansharpenType - [“Mean”, “IHS”, “Brovey”, “Esri”, “Mean”, “Gram-Schmidt”]
Possible values for filter - [None, “Sharpen”, “SharpenMore”]
Value for StretchType dictionary can be as follows:
“None”
“MinMax; <min>; <max>”
“PercentMinMax; <MinPercent>; <MaxPercent>”
“StdDev; <NumberOfStandardDeviation>”
Example: {“StretchType”: “MinMax; <min>; <max>”}
Value for ValidRange dictionary can be as follows:
“<MaskMinValue>, <MaskMaxValue>”
Example: {“ValidRange”: “10, 200”}
Example:
{“productType”:”All”,”processingTemplate”:”Pansharpen”, “pansharpenType”:”Gram-Schmidt”,”filter”:”SharpenMore”, “pansharpenWeights”:”0.85 0.7 0.35 1”,”constantZ”:-9999}
source_mosaic_dataset
Optional string. Path to the existing mosaic dataset to be published as a hosted dynamic imagery layer.
To publish an existing mosaic dataset, specify the path to the input data of the mosaic in the
input_rastersparameter. The data will be uploaded to ArcGIS Online.raster_type_nameparameter can be set to None as it is not required to publish an imagery layer from a mosaic dataset.Note
Option available only on ArcGIS online
Example:
“./data/temp_uploaded.gdb/test”
output_name
Optional String. If not provided, an Image Service is created by the method and used as the output raster.
You can pass in an existing Image Service Item from your GIS to use that instead.
Alternatively, you can pass in the name of the output Image Service that should be created by this method to be used as the output for the tool. A RuntimeError is raised if a service by that name already exists
context
context contains additional settings that affect task execution.
context parameter overwrites values set through arcgis.env parameter
This function has the following settings:
Output Spatial Reference (outSR): The output raster will be projected into the output spatial reference.
Example:
{“outSR”: {spatial reference}}
Upload Properties (upload_properties):
upload_propertieskey can be used to control specific upload parameters when trying to create hosted imagery layers in ArcGIS Online from local raster datasets.Available options:
maxUploadConcurrency: Optional integer. Maximum number of parallel connections to use for large uploads (when individual file/blob size exceeds 64MB). This is the max_concurrency parameter of the BlobClient.upload_blob() method. (The default is 6)maxWorkerThreads: Optional integer. Maximum number of threads to execute asynchronously when uploading multiple files. This is the max_workers parameter of the ThreadPoolExecutor() class. (The default is None)displayProgress: Optional boolean. If set to True, a progress bar will be displayed for tracking the progress of the uploads to user’s rasterstore. (The default is False)
Example:
{“upload_properties”: {“maxUploadConcurrency”:8,“maxWorkerThreads”:20,“displayProgress”:True}}
The context parameter can also be used to specify whether to build footprints, pixel value that represents the NoData, resamplingMethod etc.
Example:
{“buildFootprints”:True,“footprintsArguments”:{“method”:”RADIOMETRY”,”minValue”:1,”maxValue”:5,“shrinkDistance”:50,”skipOverviews”:True,”updateBoundary”:True,“maintainEdge”:False,”simplification”:None,”numVertices”:20,“minThinnessRatio”:0.05,”maxSliverSize”:20,”requestSize”:2000,“minRegionSize”:100},“defineNodata”:True,“noDataArguments”:{“noDataValues”:[500],”numberOfBand”:99,”compositeValue”:True},“buildOverview”:TrueNote
To define NoData values for
ONE_IMAGEcase when the input is a single raster, use the following: {“noData”: “1 255;2 0;3 255”}gis
Keyword only parameter. Optional
GIS. The GIS on which this function runs. If not specified, the active GIS is used.- Returns
Imagery layer item