LM/AM/SR instance API
[JuliusLib API]

Collaboration diagram for LM/AM/SR instance API:

Functions to handle modules and processes directly. More...

Functions
Recog *	j_recog_new ()
	Allocate memory for a new engine instance.
void	j_recog_free (Recog *recog)
	Free an engine instance.
Recog *	j_create_instance_from_jconf (Jconf *jconf)
	Instanciate / generate a new engine instance according to the given global configuration instance.
boolean	j_load_am (Recog *recog, JCONF_AM *amconf)
	Load an acoustic model.
boolean	j_load_lm (Recog *recog, JCONF_LM *lmconf)
	Load a language model.
boolean	j_load_all (Recog *recog, Jconf *jconf)
	Read in all models for recognition.
boolean	j_launch_recognition_instance (Recog *recog, JCONF_SEARCH *sconf)
	Launch a recognition process instance.
boolean	j_final_fusion (Recog *recog)
	Combine all loaded models and settings into one engine instance.

---

Detailed Description

Functions to handle modules and processes directly.

---

Function Documentation

Recog* j_recog_new

(

)

Allocate memory for a new engine instance.

Returns:

the newly allocated engine instance.

Definition at line 746 of file instance.c.

Referenced by j_create_instance_from_jconf().

Here is the caller graph for this function:

void j_recog_free

(

Recog *

recog

)

Free an engine instance.

All allocated memories in the instance will be also released.

Parameters:

recog

[in] engine instance.

Definition at line 800 of file instance.c.

Referenced by j_create_instance_from_jconf(), and main().

Here is the caller graph for this function:

Recog* j_create_instance_from_jconf

(

Jconf *

jconf

)

Instanciate / generate a new engine instance according to the given global configuration instance.

It inspects all parameters in the global configuration instance, load all models into memory, build tree lexicons, allocate work area and caches. It does all setup to start recognition except A/D-in initialization.

Parameters:

jconf

[in] gloabl configuration instance

Returns:

the newly created engine instance.

Definition at line 661 of file jfunc.c.

Referenced by main().

Here is the caller graph for this function:

boolean j_load_am	(	Recog *	recog,
		JCONF_AM *	amconf
	)

Load an acoustic model.

This function will create an AM process instance using the given AM configuration, and load models specified in the configuration into the instance. Then the created instance will be installed to the engine instance. The amconf should be registered to the global jconf before calling this function.

Parameters:

	recog	[i/o] engine instance
	amconf	[in] AM configuration to load

Returns:

TRUE on success, or FALSE on error.

Definition at line 428 of file m_fusion.c.

Referenced by j_load_all().

Here is the caller graph for this function:

boolean j_load_lm	(	Recog *	recog,
		JCONF_LM *	lmconf
	)

Load a language model.

This function will create an LM process instance using the given LM configuration, and load models specified in the configuration into the instance. Then the created instance will be installed to the engine instance. The lmconf should be registered to the recog->jconf before calling this function.

To convert phoneme sequence to triphone at loading, you should specify which AM to use with this LM by the argument am.

Parameters:

	recog	[i/o] engine instance
	lmconf	[in] LM configuration to load

Returns:

TRUE on success, or FALSE on error.

Definition at line 517 of file m_fusion.c.

Referenced by j_load_all(), and j_process_add_lm().

Here is the caller graph for this function:

boolean j_load_all	(	Recog *	recog,
		Jconf *	jconf
	)

Read in all models for recognition.

This function create AM/LM processing instance for each AM/LM configurations in jconf. Then the model for each instance will be loaded into memory and set up for recognition. GMM will also be read here.

Parameters:

	recog	[i/o] engine instance
	jconf	[in] global configuration variables

Returns:

TRUE on success, FALSE on failure.

Definition at line 615 of file m_fusion.c.

Referenced by j_create_instance_from_jconf().

Here is the caller graph for this function:

boolean j_launch_recognition_instance	(	Recog *	recog,
		JCONF_SEARCH *	sconf
	)

Launch a recognition process instance.

This function will create an recognition process instance using the given SEARCH configuration, and launch recognizer for the search. Then the created instance will be installed to the engine instance. The sconf should be registered to the global jconf before calling this function.

Parameters:

	recog	[i/o] engine instance
	sconf	[in] SEARCH configuration to launch

Returns:

TRUE on success, or FALSE on error.

Definition at line 865 of file m_fusion.c.

Referenced by j_final_fusion(), and j_process_add_lm().

Here is the caller graph for this function:

boolean j_final_fusion

(

Recog *

recog

)

Combine all loaded models and settings into one engine instance.

This function will finalize preparation of recognition:

• create required MFCC calculation instances,
• create recognition process instance for specified LM/AM combination,
• set model-specific recognition parameters,
• build tree lexicon for each process instance for the 1st pass,
• prepare work area and cache area for recognition,
• initialize some values / work area for frontend processing.

After this function, all recognition setup was done and we are ready for start recognition.

This should be called after j_jconf_finalize() and j_load_all() has been completed. You should put the jconf at recog->jconf before calling this function.

Parameters:

recog

[in] engine instance

Returns:

TRUE when all initialization successfully done, or FALSE if any error has been occured.

Definition at line 1111 of file m_fusion.c.

Referenced by j_create_instance_from_jconf().

Here is the caller graph for this function:

---