Skip To Content ArcGIS for Developers Sign In Dashboard

Build Multidimensional Transpose

Description

Build Multidimensional Transpose diagram

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.

License:
As of 10.5, you must license your ArcGIS Server as an ArcGIS Image Server to use this resource.

Request parameters

ParameterDetails
inputMultidimensionalRaster

(Required)

The portal folder ID, portal item ID, image service URL, cloud multidimensional raster dataset, or shared multidimensional raster dataset. At least one type of input needs to be provided in the JSON object. If multiple inputs are given, the itemId takes priority.

Syntax: A JSON object describes the input multidimensional raster.

inputMultidimensionalRaster={"folderId": <portal folder id>}
inputMultidimensionalRaster={"itemIds": <portal item id>}
inputMultidimensionalRaster={"urls": <image service url>}
inputMultidimensionalRaster={"uris": <cloud raster uri or shared data path>data path>}

context

Contains additional settings that affect task execution. This task has the following settings:

  • Parallel Processing Factor (parallelProcessingFactor)—The specified number or percentage of processes will be used for the analysis.

f

The response format. The default response format is html.

Values: html | json

Example Usage

Below is a sample request URL for BuildMultidimensionalTranspose:

https://machine.domain.com/webadaptor/rest/services/System/RasterAnalysisTools/GPServer/BuildMultidimensionalTranspose?inputMultidimensionalRaster={"itemId": ["1780d648db3545bba8661ad98df824a4"}}

Response

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

Syntax:

{ "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 Checking 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:

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

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:

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

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.

{
  "paramName": "result",
  "dataType": "GPString",
  "value": {
		  "url": "https://machine.domain.com/webadaptor/rest/services/Hosted/<service name>/ImageServer"
  }
}