Source code for bob.db.utfvp.models

#!/usr/bin/env python
# vim: set fileencoding=utf-8 :

"""Table models and functionality for the UTFVP database.
"""

import os, numpy

import bob.io.base
import bob.io.image
import bob.db.base

from sqlalchemy import Table, Column, Integer, String, ForeignKey, or_, and_, not_
from bob.db.base.sqlalchemy_migration import Enum, relationship
from sqlalchemy.orm import backref
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

protocol_model_association = Table('protocol_model_association', Base.metadata,
  Column('protocol_id', Integer, ForeignKey('protocol.id')),
  Column('model_id', Integer, ForeignKey('model.id')))

protocol_trainfiles_association = Table('protocol_trainfiles_association', Base.metadata,
  Column('protocol_id', Integer, ForeignKey('protocol.id')),
  Column('file_id', Integer, ForeignKey('file.id')))

model_probefile_association = Table('model_probefile_association', Base.metadata,
  Column('model_id', Integer, ForeignKey('model.id')),
  Column('file_id', Integer, ForeignKey('file.id')))

model_enrollmentfile_association = Table('model_enrollmentfile_association', Base.metadata,
  Column('model_id', Integer, ForeignKey('model.id')),
  Column('file_id', Integer, ForeignKey('file.id')))


[docs]class Client(Base): """Database clients, marked by an integer identifier and the group they belong to""" __tablename__ = 'client' # Key identifier for the client id = Column(String(20), primary_key=True) subclient_id = Column(Integer) def __init__(self, id, subclient_id): self.id = id self.subclient_id = subclient_id def __repr__(self): return "Client(%s)" % (self.id,)
[docs]class Model(Base): """Database models, marked by an integer identifier and the group they belong to""" __tablename__ = 'model' # Key identifier for the client id = Column(Integer, primary_key=True) # Name of the protocol associated with this object name = Column(String(20)) # Group associated with this protocol purpose object group_choices = ('dev', 'eval') sgroup = Column(Enum(*group_choices)) # Key identifier of the client associated with this model client_id = Column(String(20), ForeignKey('client.id')) # for SQL # For Python: A direct link to the enrollment File objects associated with this Model enrollment_files = relationship("File", secondary=model_enrollmentfile_association, backref=backref("models_enroll", order_by=id)) # For Python: A direct link to the probe File objects associated with this Model probe_files = relationship("File", secondary=model_probefile_association, backref=backref("models_probe", order_by=id)) # For Python: A direct link to the client object that this model belongs to client = relationship("Client", backref=backref("models", order_by=id)) def __init__(self, name, client_id, sgroup): self.name = name self.client_id = client_id self.sgroup = sgroup def __repr__(self): return "Model(%s, %s)" % (self.name, self.sgroup)
[docs]class File(Base, bob.db.base.File): """Generic file container""" __tablename__ = 'file' # Key identifier for the file id = Column(Integer, primary_key=True) # Key identifier of the client associated with this file client_id = Column(String(20), ForeignKey('client.id')) # for SQL # Unique path to this file inside the database path = Column(String(100), unique=True) # Identifier of the claimed client associated with this file finger_id = Column(Integer) # Identifier of the session session_id = Column(Integer) # For Python: A direct link to the client object that this file belongs to client = relationship("Client", backref=backref("files", order_by=id)) def __init__(self, client_id, path, finger_id, session_id): # call base class constructor bob.db.base.File.__init__(self, path = path) #self.sgroup = sgroup self.finger_id = finger_id self.session_id = session_id
[docs] def load(self, directory=None, extension='.png'): """Loads the image for this file entry Parameters: directory (str): The path to the root of the database installation. This is the path leading to files named ``DDD-G`` where ``D``'s correspond to digits and ``G`` to the client gender. For example ``032-M``. Returns: numpy.ndarray: A 2D array of unsigned integers corresponding to the input image for this file in (y,x) notation (Bob-style). """ return bob.io.base.load(self.make_path(directory, '.png'))
[docs]class Protocol(Base): """UTFVP protocols""" __tablename__ = 'protocol' # Unique identifier for this protocol object id = Column(Integer, primary_key=True) # Name of the protocol associated with this object name = Column(String(20), unique=True) # For Python: A direct link to the DevModel objects associated with this Protcol train_files = relationship("File", secondary=protocol_trainfiles_association, backref=backref("protocols_train", order_by=id)) models = relationship("Model", secondary=protocol_model_association, backref=backref("protocol", uselist=False, order_by=id)) def __init__(self, name): self.name = name def __repr__(self): return "Protocol('%s')" % (self.name,)