Package pyvision :: Package analysis :: Module bee
[hide private]
[frames] | no frames]

Module bee

source code

This module contains functions for reading and writing files for the Biometrics Evaluation Environment (BEE) including distance matricies and sigsets.


Author: David S. Bolme (CSU) and C.J. Carey (NIST)

see: <a href="http://www.bee-biometrics.org">http://www.bee-biometrics.org</a>

Classes [hide private]
  BEEDistanceMatrix
Functions [hide private]
 
parseSigSet(filename)
the format of a sigset is:
source code
 
saveSigset(ss, filename)
save a sigset to a file.
source code
 
sigset2xml(ss) source code
 
sigset2array(ss) source code
 
formatSigset(ss, n=None) source code
 
fastROC(sorted_positives, sorted_negatives) source code
 
computeMaskMatrix(target_sigset, query_sigset, target_filename, query_filename, symmetric=True)
Computes a mask matrix from two sigsets.
source code
Variables [hide private]
  BIOMETRIC_SIGNATURE = '{http://www.bee-biometrics.org/schemas/...
  PRESENTATION = '{http://www.bee-biometrics.org/schemas/sigset/...
  COMPLEX_BIOMETRIC_SIGNATURE = '{http://www.bee-biometrics.org/...
  COMPLEX_PRESENTATION = '{http://www.bee-biometrics.org/schemas...
  COMPLEX_COMPONENT = '{http://www.bee-biometrics.org/schemas/si...
  COMPLEX_DATA = '{http://www.bee-biometrics.org/schemas/sigset/...
  BEE_NONMATCH = 127
  BEE_MATCH = -1
  BEE_DONTCARE = 0
  BEE_CODE_MAP = {-1: 'MATCH', 0: 'DONTCARE', 127: 'NONMATCH', 2...
  __package__ = 'pyvision.analysis'
Function Details [hide private]

parseSigSet(filename)

source code 

the format of a sigset is:

   sigset = [ 
               ("subject_id", #biometric-signature
                   [ # multiple presentations
                       {'name':"recording_id", 'modality':"...", 'file-name':"...", 'file-format':"..."},
                       {'name':"recording_id", 'modality':"...", 'file-name':"...", 'file-format':"..."},
                       {'name':"recording_id", 'modality':"...", 'file-name':"...", 'file-format':"..."}
                   ]
               ),
               ("subject_id",#biometric-signature
                   [ # multiple presentations
                       {'name':"recording_id", 'modality':"...", 'file-name':"...", 'file-format':"..."},
                       {'name':"recording_id", 'modality':"...", 'file-name':"...", 'file-format':"..."},
                       {'name':"recording_id", 'modality':"...", 'file-name':"...", 'file-format':"..."}
                   ]
               )
           ]   

saveSigset(ss, filename)

source code 

save a sigset to a file.

Parameters:
  • ss - a sigset structured list
  • filename - a file object or filename

computeMaskMatrix(target_sigset, query_sigset, target_filename, query_filename, symmetric=True)

source code 

Computes a mask matrix from two sigsets.

Parameters:
  • target_sigset - the target sigset to use.
  • query_sigset - the query sigset to use.
  • symmetric - if true and the sigsets are equal it assumes that the matrix is symmetric and will treat the low left triangle as DONT_CARE's.
Returns:
a bee mask matrix.

Variables Details [hide private]

BIOMETRIC_SIGNATURE

Value:
'{http://www.bee-biometrics.org/schemas/sigset/0.1}biometric-signature\
'

PRESENTATION

Value:
'{http://www.bee-biometrics.org/schemas/sigset/0.1}presentation'

COMPLEX_BIOMETRIC_SIGNATURE

Value:
'{http://www.bee-biometrics.org/schemas/sigset/0.1}complex-biometric-s\
ignature'

COMPLEX_PRESENTATION

Value:
'{http://www.bee-biometrics.org/schemas/sigset/0.1}complex-presentatio\
n'

COMPLEX_COMPONENT

Value:
'{http://www.bee-biometrics.org/schemas/sigset/0.1}presentation-compon\
ent'

COMPLEX_DATA

Value:
'{http://www.bee-biometrics.org/schemas/sigset/0.1}data'

BEE_CODE_MAP

Value:
{-1: 'MATCH', 0: 'DONTCARE', 127: 'NONMATCH', 255: 'MATCH'}