|
# 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_vrd_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_relationship_labelmap=/path/to/input/relationship_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_vrd_challenge_evaluation_utils as utils
|
|
from object_detection.protos import string_int_label_map_pb2
|
|
from object_detection.utils import vrd_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.
|
|
"""
|
|
|
|
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 = {}
|
|
for item in label_map.item:
|
|
labelmap_dict[item.name] = item.id
|
|
return labelmap_dict
|
|
|
|
|
|
def _swap_labelmap_dict(labelmap_dict):
|
|
"""Swaps keys and labels in labelmap.
|
|
|
|
Args:
|
|
labelmap_dict: Input dictionary.
|
|
|
|
Returns:
|
|
A dictionary mapping class name to class numerical id.
|
|
"""
|
|
return dict((v, k) for k, v in labelmap_dict.iteritems())
|
|
|
|
|
|
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_annotations = pd.concat([all_box_annotations, all_label_annotations])
|
|
|
|
class_label_map = _load_labelmap(parsed_args.input_class_labelmap)
|
|
relationship_label_map = _load_labelmap(
|
|
parsed_args.input_relationship_labelmap)
|
|
|
|
relation_evaluator = vrd_evaluation.VRDRelationDetectionEvaluator()
|
|
phrase_evaluator = vrd_evaluation.VRDPhraseDetectionEvaluator()
|
|
|
|
for _, groundtruth in enumerate(all_annotations.groupby('ImageID')):
|
|
image_id, image_groundtruth = groundtruth
|
|
groundtruth_dictionary = utils.build_groundtruth_vrd_dictionary(
|
|
image_groundtruth, class_label_map, relationship_label_map)
|
|
|
|
relation_evaluator.add_single_ground_truth_image_info(
|
|
image_id, groundtruth_dictionary)
|
|
phrase_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_vrd_dictionary(
|
|
image_predictions, class_label_map, relationship_label_map)
|
|
|
|
relation_evaluator.add_single_detected_image_info(image_id,
|
|
prediction_dictionary)
|
|
phrase_evaluator.add_single_detected_image_info(image_id,
|
|
prediction_dictionary)
|
|
|
|
relation_metrics = relation_evaluator.evaluate(
|
|
relationships=_swap_labelmap_dict(relationship_label_map))
|
|
phrase_metrics = phrase_evaluator.evaluate(
|
|
relationships=_swap_labelmap_dict(relationship_label_map))
|
|
|
|
with open(parsed_args.output_metrics, 'w') as fid:
|
|
io_utils.write_csv(fid, relation_metrics)
|
|
io_utils.write_csv(fid, phrase_metrics)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
|
|
parser = argparse.ArgumentParser(
|
|
description=
|
|
'Evaluate Open Images Visual Relationship Detection predictions.')
|
|
parser.add_argument(
|
|
'--input_annotations_boxes',
|
|
required=True,
|
|
help='File with groundtruth vrd 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="""OpenImages Challenge labelmap; note: it is expected to include
|
|
attributes.""")
|
|
parser.add_argument(
|
|
'--input_relationship_labelmap',
|
|
required=True,
|
|
help="""OpenImages Challenge relationship labelmap.""")
|
|
parser.add_argument(
|
|
'--output_metrics', required=True, help='Output file with csv metrics')
|
|
|
|
args = parser.parse_args()
|
|
main(args)
|