The Evaluator takes two datasets, one considered the ground truth, and compares them based on different metrics.
The calculated metrics are accurate. The same Ground Truth and detections combination were evaluated using COCO API and the results were identical.
The computed metrics take into account all the detections and area ranges on an image. Moreover, AP (average precision) is computed using 101 recall thresholds from 0.0 to 1.0 with a step of 0.01. The mAP is computed using 10 IoU thresholds from 0.5 to 0.95 with a step go 0.05. These configurations are identical to the ones used for computation in the COCO API, and so are the results generated by Detection Metrics.
For more details please visit COCO Detection Evaluation or COCO API.
Command line use example
An example of config file would be:
outputPath: /opt/datasets/output/results/ inputPathGT: /opt/datasets/weights/annotations/instances_train2017.json inputPathDetection: /opt/output/test/annotations/instances_train.json readerImplementationGT: COCO readerImplementationDetection: COCO readerNames: /opt/datasets/names/coco.names iouType: bbox
Available options for iouType: bbox
. With the config file, change the directory to
Tools/Evaluator` inside build and run
./evaluator -c appConfig.yml
This will output the results as a .csv file in the output folder.
GUI use video example
In order to use the Evaluator functionality, the configuration file needs an
inferencesPath value, so the config file could be as follows:
datasetPath: /opt/datasets/ evaluationsPath: /opt/datasets/eval weightsPath: /opt/datasets/weights netCfgPath: /opt/datasets/cfg namesPath: /opt/datasets/names inferencesPath: /opt/datasets/
The video below demonstrates the Evaluator tool of Detection Metrics evaluating detector generated results for COCO val2017 dataset.
After evaluation, a summary of results is printed which contains both COCO mAP (mean average precision) metric and Pascal VOC metric.
More detailed results are written in a .csv file with the name
Evaluation Results.csv which contains class wise and overall results for the given dataset.