- URL:
- https://<root>/System/RasterAnalysisTools/GPServer/ComputeAccuracyForObjectDetection
- Methods:
GET
- Version Introduced:
- 10.9
Description
The Compute
task is used to calculate the accuracy of a deep learning model by comparing the detected objects from the Detect Object Using Deep Learning tool to ground truth data.
Request parameters
Parameter | Details |
---|---|
(Required) | The input polygon feature service layer containing the objects detected from the Detect Objects Using Deep Learning tool. Syntax: A JSON object describing the Example
|
(Required) | The polygon feature service layer containing ground truth data. Syntax: A JSON object describing the Example:
|
(Required) | The name of the output accuracy table. Syntax: A JSON object describing the output accuracy table. Example:
|
| The name of the accuracy report that will be added as a portal item in PDF format. Syntax: A JSON object describing the output accuracy report. Example:
|
| The name of the class value field in the detected objects feature service. If not specified, the tool will try to use the standard class value fields Syntax: String. Example
|
| The name of the class value field in the ground truth feature service. If not specified, the tool will try to use the standard class value fields Syntax: String. Example
|
| The Intersection over Union (IoU) ratio to use as a threshold to evaluate the accuracy of the object detection model. The numerator is the area of overlap between the predicted bounding box and the ground truth bounding box. The denominator is the area of union or the area encompassed by both bounding boxes. Syntax: Double. Example
|
| A polygon feature service layer that delineates the area where accuracy will be computed. Only the detected objects and ground truth data that falls completely within the polygons will be assessed for accuracy. If no feature service layer is provided, the full extent of the input feature services will be used. Syntax Example:
|
| Contains additional settings that affect task execution. This task has the following setting:
|
| The response format. The default response format is Values: |
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 job
to periodically check the status of the job and messages as described in Checking job status. Once the job has successfully completed, you use the job
to retrieve the results. To track the status, you can make a request of the following form:
https://<raster analysis url>/ComputeAccuracyForObjectDetection/jobs/<jobId>
When the status of the job request is esri
, you can access the results of the analysis by making a request of the following form:
//Output Accuracy Table
http://<raster analysis url>/ComputeAccuracyforObjectDetection/jobs/<jobId>/results/outAccuracyTable?token=<your token>&f=json
//Output Accuracy Report
http://<raster analysis url>/ComputeAccuracyforObjectDetection/jobs/<jobId>/results/outAccuracyReport?token=<your token>&f=json
Example usage
Below is a sample request URL for Compute
:
https://services.myserver.com/arcgis/rest/services/System/RasterAnalysisTools/GPServer/ComputeAccuracyForObjectDetection
JSON Response examples
The response returns the out
output parameter, which has properties for parameter name, data type, and value. The content of the value is always the output table item ID and service URL.
{
"paramName": "outAccuracyTable",
"dataType": "GPString",
"value": {
"itemId": "c267610d0feb4370bf38cc6e2c4ac261",
"url": "https://services.myserver.com/arcgis/rest/services/Hosted/<service name>/FeatureServer"
}
}
If requested, the response returns the out
output parameter, which has properties for parameter name, data type, and value. The content of the value is always the output accuracy report item ID.
{
"paramName": "outAccuracyReport",
"dataType": "GPString",
"value": {
"itemId": "c267610d0feb4370bf38cc6e2c4ac261",
}
}