Analyze Changes Using CCDC

URL:
https://<root>/System/RasterAnalysisTools/GPServer/AnalyzeChangesUsingCCDC
Methods:
GET
Version Introduced:
10.8.1
Analyze Changes Using CCDC diagram

Description

The AnalyzeChangesUsingCCDC task evaluates changes in pixel values over time using the CCDC algorithm, and generates a multidimensional raster containing the model results.

Request parameters

ParameterDetails

inputMultidimensionalRaster

(Required)

The Portal Item ID, Image Service URL, cloud multidimensional raster dataset or shared multidimensional raster dataset.

Syntax: JSON object describes the input multidimensional raster. At least one type of input needs to be provided in the JSON object. If multiple inputs are given, the itemid takes the priority.

Example:

Use dark colors for code blocksCopy
1
2
3
{"itemId": <portal item id>}
{“url”: <image service url>}
{“uri”: <cloud raster uri or shared data path>}

outputName

(Required)

Output hosted image service properties. If the hosted image service is already created, the portal item ID or service URL can be given to the service tool. The output path of the multidimensional raster dataset generated in the raster store will be used to update the existing service definition. The service tool can also generate new hosted image service with the given service properties.

The output hosted image service is stored in raster store and shared on either the Raster Analysis Image Server or Image Hosting Image Server depending on the Enterprise configuration.

Syntax: JSON object describes the output multidimensional raster. At least one type of input needs to be provided in the JSON object. If multiple inputs are given, the itemId takes priority.

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
outputName={"itemId": <portal item id>}
outputName={“url”: <image service url>}
outputName={“uri”: <cloud raster uri or shared data path>}
or
{
  "serviceProperties": {
    “name”: ”aggregated_watertemp_salinity”,
    ”capabilities”: ”image, metadata”
  }
}

bandsForDetectingChange

(Optional)

The band IDs to use for change detection. If no band IDs are provided, all the bands from the input raster dataset will be used.

Syntax: List of band IDs

Example:

Use dark colors for code blocksCopy
1
bandsForDetectingChange=[1,2,3,4,6]

bandsForTemporalMasking

(Optional)

The band IDs of the green band and the SWIR band, to be used to mask for cloud, cloud shadow and snow. If band IDs are not provided, no masking will occur.

Syntax: List of band IDs

Example:

Use dark colors for code blocksCopy
1
bandsForTemporalMasking=[1,4]

chiSquaredThreshold

(Optional)

The chi-square change probability threshold. If an observation has a calculated change probability that is above this threshold, it is flagged as an anomaly, which is a potential change event. The default value is 0.99.

Syntax: Double representing the chi-square threshold.

Example

Use dark colors for code blocksCopy
1
chiSquaredThreshold=0.99

minAnomalyObservations

(Optional)

The minimum number of consecutive anomaly observations that must occur before an event is considered a change. A pixel must be flagged as an anomaly for the specified number of consecutive time slices before it is considered a true change. The default value is 6.

Syntax: Integer representing the minimum consecutive anomaly observations

Example:

Use dark colors for code blocksCopy
1
minAnomalyObservations=6

updateFrequency

The frequency, in years, at which to update the time series model with new observations. The default value is 1.

Syntax: Double representing the frequency.

Example

Use dark colors for code blocksCopy
1
updateFrequency=1

context

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

  • Extent (extent)—A bounding box that defines the analysis area.
  • Output Spatial Reference (outSR)—The output raster will be projected into the output spatial reference.
  • Snap Raster (snapRaster)—The output raster will have its cells aligned with the specified snap raster.
  • Cell Size (cellSize)—The output raster will have the resolution specified by cell size.
  • Parallel Processing Factor (parallelProcessingFactor)—The specified number or percentage of processes will be used for the analysis.

Example:

Use dark colors for code blocksCopy
1
context={"cellSize": "20", "parallelProcessingFactor": "4"}

f

The response format. The default response format is html.

Values: html | json

Response

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

Syntax:

Use dark colors for code blocksCopy
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 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:

Use dark colors for code blocksCopy
1
https://<analysis-url>/AnalyzeChangesUsingCCDC/jobs/<jobId>

Accessing results

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

Use dark colors for code blocksCopy
1
https://<raster analysis url>/AnalyzeChangesUsingCCDC/jobs/<jobId>/results/outputCCDCAnalysisRaster?token=<your token>&f=json
ParameterDetails

outputMultidimensionalRaster

The output multidimensional raster itemId and URL

Example:

Use dark colors for code blocksCopy
1
{"url": "http://<raster analysis url>/AnalyzeChangesUsingCCDC/jobs/<jobId>/results/outputCCDCAnalysisRaster"}

The result has properties for parameter name, data type, and value. The content of the value is always the output raster dataset's itemId and image service URL.

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
{
  "paramName": "outputCCDCAnalysisRaster",
  "dataType": "GPString",
  "value": {
    "itemId": "c267610d0feb4370bf38cc6e2c4ac261",
    "url": "https://<server name>/arcgis/rest/services/Hosted/<service name>/ImageServer"
  }
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.