display_face_annotations.py 5.56 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
#!../bin/python

"""This script displays the iamges with annotations provided by any face database.
Basically, anything that can be used as a --database for .bin/verify.py can be specified here as well, including configuration files and ``database`` resources: ``./bin/resources.py -d database``.

By default, all images and their corresponding annotations are displayed, and you have to press ``Enter`` after each image.
If the database does not include annotations, or you want to display a different set of annotations, you can specify the ``--annotation-directory`` (and if required modify the ``--annotation-file-extension`` and ``--annotation-file-type``.
The list of images can be narrowed down by the ``--file-ids`` parameter, where the file ids are specific to the database.

Note that this script can only be used with face image databases, not with video or other biometric databases.
"""

from __future__ import print_function

import os
import argparse

import bob.bio.base

import bob.core
logger = bob.core.log.setup("bob.bio.face")

def command_line_arguments(command_line_parameters):
  """Defines the command line parameters that are accepted."""

  # create parser
  parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.ArgumentDefaultsHelpFormatter)

  # add parameters
  parser.add_argument('-d', '--database', nargs = '+', help = 'Select the database for which the images plus annotations should be shown.')
  parser.add_argument('-f', '--file-ids', nargs = '+', help = 'If given, only the images of the --database with the given file id are shown (non-existing IDs will be silently skipped).')
  parser.add_argument('-a', '--annotation-directory', help = 'If given, use the annotations stored in the given annotation directory (this might be required for some databases).')
  parser.add_argument('-x', '--annotation-file-extension', default = '.pos', help = 'Annotation files have the given filename extension.')
  parser.add_argument('-t', '--annotation-file-type', default = 'named', help = 'Select the annotation file style, see bob.db.verification.utils documentation for valid types.')
  parser.add_argument('-n', '--annotate-names', action = 'store_true', help = 'Plot the names of the annotations, too.')
  parser.add_argument('-m', '--marker-style', default='rx', help = 'Select the marker style')
  parser.add_argument('-M', '--marker-size', type=float, default=10., help = 'Select the marker size')
  parser.add_argument('-F', '--font-size', type=int, default=16, help = 'Select the font size for the annotation names')
  parser.add_argument('-C', '--font-color', default = 'b', help = 'Select the color for the annotation names')
  parser.add_argument('--database-directories-file', metavar = 'FILE', default = "%s/.bob_bio_databases.txt" % os.environ["HOME"], help = 'An optional file, where database directories are stored (to avoid changing the database configurations)')

  parser.add_argument('--self-test', action='store_true', help=argparse.SUPPRESS)

  bob.core.log.add_command_line_option(parser)
  args = parser.parse_args(command_line_parameters)
  bob.core.log.set_verbosity_level(logger, args.verbose)

  return args


def main(command_line_parameters=None):

  args = command_line_arguments(command_line_parameters)

  # load database
  database = bob.bio.base.load_resource("".join(args.database), "database")
  # replace directories
58
  if isinstance(database, bob.bio.db.BioDatabase):
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
    database.replace_directories(args.database_directories_file)

  # get all files
  files = database.all_files()
  # filter file ids; convert them to str first
  if args.file_ids is not None:
    files = [f for f in files if str(f.id) in args.file_ids]

  # open figure
  if not args.self_test:
    from matplotlib import pyplot
    figure = pyplot.figure()

  for f in files:
    # load image
    logger.info("loading image for file %s", f.id)
    image = bob.io.base.load(database.original_file_names([f])[0])
    # convert to color if it is not
    if image.ndim == 2:
      image = bob.ip.color.gray_to_rgb(image)

    # get annotations
    annotations = {}
    if args.annotation_directory is not None:
      # load annotation file
      annotation_file = f.make_path(args.annotation_directory, args.annotation_file_extension)
      if os.path.exists(annotation_file):
        logger.info("Loading annotations from file %s", annotation_file)
        annotations = bob.db.verification.utils.read_annotation_file(annotation_file, args.annotation_file_type)
      else:
        logger.warn("Could not find annotation file %s", annotation_file)
    else:
      # get annotations from database
      annotations = database.annotations(f)

    if not annotations:
      logger.warn("Could not find annotations for file %s", f.id)

    if not args.self_test:
      pyplot.clf()
      pyplot.imshow(image.transpose(1,2,0))

      global_annotation = []
      for n,a in annotations.items():
        if isinstance(a, (list,tuple)) and len(a) == 2:
          pyplot.plot(a[1], a[0], args.marker_style, ms = args.marker_size, mew = args.marker_size / 5.)
          if args.annotate_names:
            pyplot.annotate(n, (a[1], a[0]), color=args.font_color, fontsize=args.font_size)
        else:
          global_annotation.append("%s=%s"%(n,a))

      # plot all global annotations, at the top center of the image
      pyplot.annotate(";".join(global_annotation), (image.shape[-1]/2, 0), color=args.font_color, fontsize=args.font_size, ha='center', va='baseline')

      pyplot.gca().set_aspect("equal")
      pyplot.gca().autoscale(tight=True)

      raw_input("Press Enter to continue to the next image (or Ctrl-C + Enter to exit)")