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')))


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,)


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)


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.client_id = client_id
    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'))
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,)