name: VerifyHMM

synopsis:

g++ [flags ...] file ... -l /isip/tools/lib/$ISIP_BINARY/lib_pr.a

#include <VerifyHMM.h>

VerifyHMM();
boolean run(Sdb& sdb);

quick start:

VerifyHMM hmm;
hmm.setParamFile(L"diagnose_params.sof");
Sdb raw_list_sdb;
boolean is_list = true;
raw_list_sdb.append(L"diagnose_mfcc_list.sof", is_list);
hmm.run(sdb);

description:

The VerifyHMM class is used to implement Hidden Markov Model-based speaker verification technology. It provides the Likelihood_Ratio and Baum-Welch algorithms for speaker verification and speaker enrollment.

dependencies:

public constants:

define class name:
```
static const String CLASS_NAME;
```

define enumerations:

enum ALGORITHM { VERIFY = 0, TRAIN, MIXTURE_SPLITTING, DEF_ALGORITHM = VERIFY };

enum IMPLEMENTATION { LIKELIHOOD_RATIO = 0, BAUM_WELCH, VARIANCE_SPLITTING, LIKELIHOOD, DEF_IMPLEMENTATION = LIKELIHOOD_RATIO };

define name maps:

static const NameMap IMPL_MAP;

static const NameMap ALGO_MAP;

define i/o constants:

static const String PARAM_IMPOSTER_LANGUAGE_MODEL;

static const String PARAM_IMPOSTER_STATISTICAL_MODEL_POOL;

static const String PARAM_DECISION_THRESHOLDS;

define public constants:

static const String DEF_DECISION_THRESHOLDS;

protected data:

algorithm name:

ALGORITHM algorithm_d;

implementation name:

IMPLEMENTATION implementation_d;

imposter language model file:

Filename imp_lm_file_d;

imposter statistical model pool file:

Filename imp_smp_file_d;

decision thresholds:

VectorFloat decision_thresholds_d;

hierarchical search for imposter models:

HierarchicalSearch imp_search_engine_d;

declare the memory manager:
```
static MemoryManager mgr_d;
```

required public methods:

static methods:
```
static const String& name();
```

debug methods:

static boolean diagnose(Integral::DEBUG debug_level);

destructor/constructor(s):

~VerifyHMM();

VerifyHMM();

VerifyHMM(const VerifyHMM& arg);

assign methods:
```
boolean assign(const VerifyHMM& arg);
```
operator= method:
```
not present.
```

i/o methods:

long sofSize() const;

boolean read(Sof& sof, long tag, const String& name = CLASS_NAME);

boolean write(Sof& sof, long tag, const String& name = CLASS_NAME) const;

boolean readData(Sof& sof, const String& pname = DEF_PARAM, long size = SofParser::FULL_OBJECT, boolean param = true, boolean nested = false);

boolean writeData(Sof& sof, const String& param = DEF_PARAM) const;

equality methods:
```
not present.
```

memory management methods:

static void* operator new(size_t size);

static void* operator new[](size_t size);

static void operator delete(void* ptr);

static void operator delete[](void* ptr);

static boolean setGrowSize(long grow_size);

class-specific public methods:

declare configuration methods:

ALGORITHM getAlgorithm();

boolean setAlgorithm(ALGORITHM arg);

IMPLEMENTATION getImplementation();

boolean setImplementation(IMPLEMENTATION arg);

Filename& getImposterLanguageModelFile();

boolean setImposterLanguageModelFile(const Filename& arg);

Filename& getImposterStatisticalModelPoolFile();

boolean setImposterStatisticalModelPoolFile(const Filename& arg);

VectorFloat getDecisionThresholds();

boolean setDecisionThresholds(VectorFloat decision_thresholds);

private methods:

none

examples:

This example shows how to run the VerifyHMM verifier using Likelihood_Ratio algorithm

// declare a VerifyHMM object
//
VerifyHMM hmm;

// set up the param file for hmm and front end specification
//
hmm.setParamFile(L"diagnose_params.sof");

// setup the input speech file list
//      
Sdb raw_list_sdb;
boolean is_list = true;
raw_list_sdb.append(L"diagnose_raw_list.sof", is_list);

// run the VerifyHMM verifier on the input speech file list
//
hmm.run(raw_list_sdb);

notes:

none