CUHK Face Sketch Database (CUFS)

class bob.db.cuhk_cufs.Database(original_directory=None, original_extension=None, arface_directory='', xm2vts_directory='')

Bases: bob.db.base.SQLiteDatabase

Wrapper class for the CUHK-CUFS database for Heterogeneous face recognition recognition (http://mmlab.ie.cuhk_cufs.edu.hk/archive/facesketch.html).

annotations(file, annotation_type='eyes_center')[source]

This function returns the annotations for the given file id as a dictionary.

Parameters

file: bob.db.base.File

The File object you want to retrieve the annotations for,

Return

A dictionary of annotations, for face images usually something like {‘leye’:(le_y,le_x), ‘reye’:(re_y,re_x), …}, or None if there are no annotations for the given file ID (which is the case in this base class implementation).

clients(protocol=None, groups=None)[source]
groups(protocol=None, **kwargs)[source]

This function returns the list of groups for this database.

property modalities
property modality_separator
model_ids(protocol=None, groups=None)[source]
objects(groups=None, protocol=None, purposes=None, model_ids=None, modality=None, **kwargs)[source]

This function returns lists of File objects, which fulfill the given restrictions.

original_file_name(file, check_existence=True)[source]

This function returns the original file name for the given File object.

Parameters

file: File

The File objects for which the file name should be retrieved

check_existence: bool

Check if the original file exists? IGNORED: ALWAYS CHECK

Return

The original file name for the given File object

protocols()[source]
purposes()[source]
tclients(protocol=None)[source]

Returns a set of T-Norm clients for the specific query by the user.

tmodel_ids(groups=None, protocol=None, **kwargs)[source]

This function returns the ids of the T-Norm models of the given groups for the given protocol.

tobjects(protocol=None, model_ids=None, groups=None)[source]

Returns a set of T-Norm objects for the specific query by the user.

zclients(protocol=None)[source]

Returns a set of Z-Norm clients for the specific query by the user.

zobjects(protocol=None, groups=None)[source]

Returns a set of Z-Norm objects for the specific query by the user.

class bob.db.cuhk_cufs.File(id, image_name, client_id, modality)[source]

Bases: sqlalchemy.ext.declarative.api.Base, bob.db.base.File

Information about the files of the CUHK-CUFS database.

Each file includes * the client id

modality_choices = ('photo', 'sketch')
id
path
client
all_annotations
client_id
modality
annotations(annotation_type='eyes_center')[source]
class bob.db.cuhk_cufs.Client(id, gender, original_id, original_database)[source]

Bases: sqlalchemy.ext.declarative.api.Base

Information about the clients (identities) of the CUHK-CUFS.

gender_choices = ('man', 'woman', 'none')
database_choices = ('cuhk', 'arface', 'xm2vts')
id
gender
original_id
original_database
class bob.db.cuhk_cufs.Annotation(file_id, x, y, index=0)[source]

Bases: sqlalchemy.ext.declarative.api.Base

The CUHK-CUFS provides 35 coordinates. To model this coordinates this table was built. The columns are the following:

  • Annotation.id

  • x

  • y

file_id
x
y
index
class bob.db.cuhk_cufs.Protocol_File_Association(protocol, group, purpose, file_id)[source]

Bases: sqlalchemy.ext.declarative.api.Base

Describe the protocols

protocol
group
purpose
file_id
bob.db.cuhk_cufs.get_config()[source]

Returns a string containing the configuration information.