"""This script displays the iamges with annotations provided by any face database.
Basically, anything that can be used as a --database for verify.py can be specified here as well, including configuration files and ``database`` resources: ``resources.py -d database``.
"""This script displays the images with annotations provided by any face 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``.
...
...
@@ -13,130 +12,228 @@ Note that this script can only be used with face image databases, not with video
parser.add_argument('-d','--database',nargs='+',help='Select the database for which the images plus annotations should be shown.')
parser.add_argument('-V','--video',action='store_true',help='Provide this flag if your database is a video database. For video databases, the annotations for the first frame is 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.base 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('-o','--output',help="If given, it will save the plots in this output file instead of showing them. This option is useful when you don't have a display server (ssh).")
$ bob bio display-face-annotations -vvv -d <database> -a <annot_dir>
""",
)
@click.option(
"-d",
"--database",
required=True,
cls=ResourceOption,
entry_point_group="bob.bio.database",
help="Select the database for which the images plus annotations should be shown.",
)
@click.option(
"-V",
"--video",
"is_video",
is_flag=True,
help="Provide this flag if your database is a video database. "
"For video databases, the annotations for the first frame is shown.",
)
@click.option(
"-a",
"--annotations-dir",
help="Use the annotations stored in this directory "
"(when annotated with `$ bob bio annnotate` for example). "
"If not given, will try to load the annotations from the database.",
)
@click.option(
"-x",
"--annotations-extension",
default=".json",
show_default=True,
help="Annotations files have the given filename extension.",
)
@click.option(
"-t",
"--annotations-type",
default="json",
show_default=True,
help="Annotations type given to bob.bio.base.read_annotations.",
)
@click.option(
"-n",
"--display-names",
is_flag=True,
help="Plot the names of the annotations, too.",
)
@click.option(
"-m",
"--marker-style",
default="rx",
show_default=True,
help="Select the marker style",
)
@click.option(
"-M",
"--marker-size",
type=float,
default=10.,
show_default=True,
help="Select the marker size",
)
@click.option(
"-C",
"--font-color",
default="b",
show_default=True,
help="Select the color for the annotations names",
)
@click.option(
"-F",
"--font-size",
type=int,
default=16,
show_default=True,
help="Select the font size for the annotations names",
)
@click.option(
"-o",
"--output-dir",
help="If given, it will save the plots in this output file instead of showing them. This option is useful when you don't have a display server (ssh).",
)
@click.option(
"-k",
"--keep-all",
is_flag=True,
help="When -o is given: keeps every annotated samples instead of just one.",
)
@click.option(
"--self-test",
is_flag=True,
help="Prevents outputing to the screen and waiting for user input.",
)
@click.option(
"--groups",
"-g",
multiple=True,
default=["dev","eval"],
show_default=True,
help="Biometric Database group that will be displayed.",
)
@verbosity_option(cls=ResourceOption)
defdisplay_face_annotations(
database,
is_video,
annotations_dir,
annotations_extension,
annotations_type,
marker_style,
marker_size,
display_names,
font_color,
font_size,
output_dir,
keep_all,
self_test,
groups,
**kwargs
):
"""
Plots annotations on the corresponding face picture.
"""
logger.debug("Retrieving samples from database.")
samples=database.all_samples(groups)
logger.debug(f"{len(samples)} samples loaded from database.")
