# Copyright 2018 The TensorFlow Authors. All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # ============================================================================== r"""Runs evaluation using OpenImages groundtruth and predictions. Example usage: python models/research/object_detection/metrics/oid_od_challenge_evaluation.py \ --input_annotations_boxes=/path/to/input/annotations-human-bbox.csv \ --input_annotations_labels=/path/to/input/annotations-label.csv \ --input_class_labelmap=/path/to/input/class_labelmap.pbtxt \ --input_predictions=/path/to/input/predictions.csv \ --output_metrics=/path/to/output/metric.csv \ CSVs with bounding box annotations and image label (including the image URLs) can be downloaded from the Open Images Challenge website: https://storage.googleapis.com/openimages/web/challenge.html The format of the input csv and the metrics itself are described on the challenge website. """ from __future__ import absolute_import from __future__ import division from __future__ import print_function import argparse import pandas as pd from google.protobuf import text_format from object_detection.metrics import io_utils from object_detection.metrics import oid_od_challenge_evaluation_utils as utils from object_detection.protos import string_int_label_map_pb2 from object_detection.utils import object_detection_evaluation def _load_labelmap(labelmap_path): """Loads labelmap from the labelmap path. Args: labelmap_path: Path to the labelmap. Returns: A dictionary mapping class name to class numerical id A list with dictionaries, one dictionary per category. """ label_map = string_int_label_map_pb2.StringIntLabelMap() with open(labelmap_path, 'r') as fid: label_map_string = fid.read() text_format.Merge(label_map_string, label_map) labelmap_dict = {} categories = [] for item in label_map.item: labelmap_dict[item.name] = item.id categories.append({'id': item.id, 'name': item.name}) return labelmap_dict, categories def main(parsed_args): all_box_annotations = pd.read_csv(parsed_args.input_annotations_boxes) all_label_annotations = pd.read_csv(parsed_args.input_annotations_labels) all_label_annotations.rename( columns={'Confidence': 'ConfidenceImageLabel'}, inplace=True) all_annotations = pd.concat([all_box_annotations, all_label_annotations]) class_label_map, categories = _load_labelmap(parsed_args.input_class_labelmap) challenge_evaluator = ( object_detection_evaluation.OpenImagesDetectionChallengeEvaluator( categories)) for _, groundtruth in enumerate(all_annotations.groupby('ImageID')): image_id, image_groundtruth = groundtruth groundtruth_dictionary = utils.build_groundtruth_boxes_dictionary( image_groundtruth, class_label_map) challenge_evaluator.add_single_ground_truth_image_info( image_id, groundtruth_dictionary) all_predictions = pd.read_csv(parsed_args.input_predictions) for _, prediction_data in enumerate(all_predictions.groupby('ImageID')): image_id, image_predictions = prediction_data prediction_dictionary = utils.build_predictions_dictionary( image_predictions, class_label_map) challenge_evaluator.add_single_detected_image_info(image_id, prediction_dictionary) metrics = challenge_evaluator.evaluate() with open(parsed_args.output_metrics, 'w') as fid: io_utils.write_csv(fid, metrics) if __name__ == '__main__': parser = argparse.ArgumentParser( description='Evaluate Open Images Object Detection Challenge predictions.' ) parser.add_argument( '--input_annotations_boxes', required=True, help='File with groundtruth boxes annotations.') parser.add_argument( '--input_annotations_labels', required=True, help='File with groundtruth labels annotations') parser.add_argument( '--input_predictions', required=True, help="""File with detection predictions; NOTE: no postprocessing is applied in the evaluation script.""") parser.add_argument( '--input_class_labelmap', required=True, help='Open Images Challenge labelmap.') parser.add_argument( '--output_metrics', required=True, help='Output file with csv metrics') args = parser.parse_args() main(args)