Build Multidimensional Transpose

Description

The BuildMultidimensionalTranspose task transposes a multidimensional raster dataset, which divides the multidimensional data along each dimension to optimize performance when accessing pixel values across all slices.

The input multidimensional raster must be in Cloud Raster Format (CRF ). Currently, no other formats are supported. To convert a mosaic dataset or NetCDF file to a multidimensional CRF , use the Create Imagery Layer tool, export to CRF , and select Process as Multidimensional.

Request parameters

1
2
3
4
inputMultidimensionalRaster={"folderId": <portal folder id>}
inputMultidimensionalRaster={"itemId": <portal item id>}
inputMultidimensionalRaster={"url": <image service url>}
inputMultidimensionalRaster={"uri": <cloud raster uri or shared data path>data path>}

Example usage

The following is a sample request URL for the BuildMultidimensionalTranspose operation:

1
https://machine.domain.com/webadaptor/rest/services/System/RasterAnalysisTools/GPServer/BuildMultidimensionalTranspose?inputMultidimensionalRaster={"itemId": "1780d648db3545bba8661ad98df824a4"}&deleteTranspose=false&context=&f=json

Response

When you submit a request, the task assigns a unique job ID for the transaction.

Syntax:

1
{ "jobId": "<unique job identifier>", "jobStatus": "<job status>" }

After the initial request is submitted, you can use the jobId to periodically check the status of the job and messages, as described in Check job status. Once the job has successfully completed, use the jobId to retrieve the results. To track the status, you can make a request of the following form:

1
https://<rasterAnalysisTools-url>/BuildMultidimensionalTranspose/jobs/<jobId>

Accessing results

When the status of the job request is esriJobSucceeded , you can access the results of the analysis by making a request of the following form:

1
https://<rasterAnalysisTools-url>/BuildMultidimensionalTranspose/jobs/<jobId>/results/result

1
{"url": "https://<raster analysis url>/BuildMultidimensionalTranspose /jobs/<jobId>/results/outputMultidimensionalRaster"}

1
2
3
4
5
6
7
{
  "paramName": "outputRaster",
  "dataType": "GPString",
  "value": {
    "url": " https://<server name>/arcgis/rest/services/Hosted/<service name>/ImageServer "
  }
}

JSON Response example

The response returns the results output parameter, which has properties for parameter name, data type, and value. The content of value is always the image service URL.

1
2
3
4
5
6
7
{
  "paramName": "result",
  "dataType": "GPString",
  "value": {
		  "url": "https://machine.domain.com/webadaptor/rest/services/Hosted/<service name>/ImageServer"
  }
}