bob.machine.ISVMachine

class bob.machine.ISVMachine((object)self, (ISVBase)isv_base) → None :

Bases: bob.machine._machine.MachineGMMStatsScalarBase

An ISVMachine. An attached ISVBase should be provided for Inter-session Variability Modelling. The ISVMachine carries information about the speaker factors z, whereas a ISVBase carries information about the matrices U and D.

References: [1] ‘Explicit Modelling of Session Variability for Speaker Verification’, R. Vogt, S. Sridharan, Computer Speech & Language, 2008, vol. 22, no. 1, pp. 17-38 [2] ‘Session Variability Modelling for Face Authentication’, C. McCool, R. Wallace, M. McLaren, L. El Shafey, S. Marcel, IET Biometrics, 2013

Builds a new ISVMachine.

__init__( (object)self) -> None :
Constructs a 1 ISVMachine instance. You have to set a ISVBase afterwards.
__init__( (object)self, (HDF5File)config) -> None :
Constructs a new ISVMachine from a configuration file.
__init__( (object)self, (ISVMachine)machine) -> None :
Copy constructs an ISVMachine
__init__((object)self, (ISVBase)isv_base) → None :

Builds a new ISVMachine.

__init__( (object)self) -> None :
Constructs a 1 ISVMachine instance. You have to set a ISVBase afterwards.
__init__( (object)self, (HDF5File)config) -> None :
Constructs a new ISVMachine from a configuration file.
__init__( (object)self, (ISVMachine)machine) -> None :
Copy constructs an ISVMachine

Methods

__init__((object)self, (ISVBase)isv_base) Builds a new ISVMachine.
estimate_ux((ISVMachine)self, …) Estimates Ux (LPT assumption) given GMM statistics.
estimate_x((ISVMachine)self, …) Estimates the session offset x (LPT assumption) given GMM statistics.
forward((MachineGMMStatsScalarBase)self, …) Executes the machine on the GMMStats, and returns the (scalar) output.
forward_((MachineGMMStatsScalarBase)self, …) Executes the machine on the GMMStats, and returns the (scalar) output.
forward_ux((ISVMachine)self, …) Processes the GMM statistics and Ux to return a score.
is_similar_to((ISVMachine)self, …) Compares this ISVBase with the ‘other’ one to be approximately the same.
load((ISVMachine)self, (HDF5File)config) Loads the configuration parameters from a configuration file.
save((ISVMachine)self, (HDF5File)config) Saves the configuration parameters to a configuration file.

Attributes

dim_c The number of Gaussian components
dim_cd The dimensionality of the supervector space
dim_d The dimensionality of the feature space
dim_ru The dimensionality of the within-class variations subspace (rank of U)
isv_base The ISVBase attached to this machine
x The latent variable x (last one computed).
z The latent variable z of this machine
__call__((MachineGMMStatsScalarBase)self, (GMMStats)input) → float :

Executes the machine on the GMMStats, and returns the (scalar) output. NO CHECK is performed.

dim_c

The number of Gaussian components

dim_cd

The dimensionality of the supervector space

dim_d

The dimensionality of the feature space

dim_ru

The dimensionality of the within-class variations subspace (rank of U)

estimate_ux((ISVMachine)self, (GMMStats)stats, (object)ux) → None :

Estimates Ux (LPT assumption) given GMM statistics.

estimate_x((ISVMachine)self, (GMMStats)stats, (object)x) → None :

Estimates the session offset x (LPT assumption) given GMM statistics.

forward((MachineGMMStatsScalarBase)self, (GMMStats)input) → float :

Executes the machine on the GMMStats, and returns the (scalar) output.

forward_((MachineGMMStatsScalarBase)self, (GMMStats)input) → float :

Executes the machine on the GMMStats, and returns the (scalar) output. NO CHECK is performed.

forward_ux((ISVMachine)self, (GMMStats)stats, (object)ux) → float :

Processes the GMM statistics and Ux to return a score.

is_similar_to((ISVMachine)self, (ISVMachine)other[, (float)r_epsilon=1e-05[, (float)a_epsilon=1e-08]]) → bool :

Compares this ISVBase with the ‘other’ one to be approximately the same.

isv_base

The ISVBase attached to this machine

load((ISVMachine)self, (HDF5File)config) → None :

Loads the configuration parameters from a configuration file.

save((ISVMachine)self, (HDF5File)config) → None :

Saves the configuration parameters to a configuration file.

x

The latent variable x (last one computed). This is a feature provided for convenience, but this attribute is not ‘part’ of the machine. The session latent variable x is indeed not class-specific, but depends on the sample considered. Furthermore, it is not saved into the machine or used when comparing machines.

z

The latent variable z of this machine