Jconf 構造体によるパラメータ情報の管理 [詳細]

Jconf configuration APIのコラボレーション図

関数
JCONF_AM *	j_jconf_am_new ()
	音響モデル(AM)パラメータ構造体を新たに割り付ける.
void	j_jconf_am_free (JCONF_AM *amconf)
	音響モデル(AM)パラメータ構造体を解放する.
boolean	j_jconf_am_regist (Jconf jconf, JCONF_AM amconf, char *name)
	音響モデル(AM)パラメータ構造体を jconf に登録する． jconf内に同じ名前のモジュールが既に登録されている場合はエラーとなる．
JCONF_LM *	j_jconf_lm_new ()
	言語モデル (LM) パラメータ構造体を新たに割り付ける内部メンバにはデフォルト値が格納される.
void	j_jconf_lm_free (JCONF_LM *lmconf)
	言語モデル (LM) パラメータ構造体を解放する
boolean	j_jconf_lm_regist (Jconf jconf, JCONF_LM lmconf, char *name)
	言語モデル(LM)パラメータ構造体を jconf に登録する． jconf内に同じ名前のモジュールが既に登録されている場合はエラーとなる．
JCONF_SEARCH *	j_jconf_search_new ()
	探索パラメータ(SEARCH)構造体を新たに割り付ける.
void	j_jconf_search_free (JCONF_SEARCH *sconf)
	探索パラメータ(SEARCH)構造体を解放する
boolean	j_jconf_search_regist (Jconf jconf, JCONF_SEARCH sconf, char *name)
	探索(SEARCH)パラメータ構造体を jconf に登録する． jconf内に同じ名前のモジュールが既に登録されている場合はエラーとなる．
Jconf *	j_jconf_new ()
	全体のパラメータ構造体を新たに割り付ける.
void	j_jconf_free (Jconf *jconf)
	全体のパラメータ構造体を開放する.
static void	j_config_remove_initial (Jconf *jconf)
	複数インスタンスが定義されている場合、初期インスタンス(id=0)は無効なので消す.
int	j_config_load_args (Jconf jconf, int argc, char argv[])
	コマンド引数からパラメータを読み込み，jconf 内の各設定インスタンスに値を格納する.
int	j_config_load_string (Jconf jconf, char string)
	コマンド引数を含む文字列からパラメータを読み込み，jconf 内の各設定インスタンスに値を格納する.
int	j_config_load_file (Jconf jconf, char filename)
	jconf ファイルからパラメータを読み込み，jconf 内の各設定インスタンスに値を格納する.
Jconf *	j_config_load_args_new (int argc, char *argv[])
	コマンド引数からパラメータを読み込み，その値を格納した新たな設定インスタンスを割り付けて返す.
Jconf *	j_config_load_file_new (char *filename)
	新たな設定インスタンスを割り付け，そこに jconfファイルから設定パラメータを読み込んで返す.
Jconf *	j_config_load_string_new (char *string)
	新たな設定インスタンスを割り付け，そこに文字列から設定パラメータを読み込んで返す.
void	j_add_dict (JCONF_LM lm, char dictfile)
	追加辞書ファイルの読み込みを指定する.
void	j_add_word (JCONF_LM lm, char wordentry)
	追加の単語エントリを指定する.
JCONF_AM *	j_get_amconf_by_name (Jconf jconf, char name)
	jconf内の AM モジュール設定構造体を名前で検索する.
JCONF_AM *	j_get_amconf_by_id (Jconf *jconf, int id)
	jconf内の AM モジュール設定構造体を ID で検索する.
JCONF_AM *	j_get_amconf_default (Jconf *jconf)
	デフォルトの AM 設定を返す.
JCONF_LM *	j_get_lmconf_by_name (Jconf jconf, char name)
	jconf内の LM モジュール設定構造体を名前で検索する.
JCONF_LM *	j_get_lmconf_by_id (Jconf *jconf, int id)
	jconf内の LM モジュール設定構造体を ID で検索する.
JCONF_SEARCH *	j_get_searchconf_by_name (Jconf jconf, char name)
	jconf内の SESARCH モジュール設定構造体を名前で検索する.
JCONF_SEARCH *	j_get_searchconf_by_id (Jconf *jconf, int id)
	jconf内の SEARCH モジュール設定構造体を ID で検索する.
boolean	j_jconf_finalize (Jconf *jconf)
	jconf設定パラメータを最終的に決定する

説明

Jconf 構造体によるパラメータ情報の管理

関数

JCONF_AM* j_jconf_am_new ( )

音響モデル(AM)パラメータ構造体を新たに割り付ける.

内部メンバにはデフォルト値が格納される.

戻り値:: the newly allocated AM parameter structure

instance.c の 333 行で定義されています。

参照元 initialize_GMM(), j_jconf_new(), と opt_parse().

関数の呼び出しグラフ:

呼出しグラフ:

void j_jconf_am_free ( JCONF_AM * amconf )

音響モデル(AM)パラメータ構造体を解放する.

内部メンバにはデフォルト値が格納される.

引数:

amconf [in] AM configuration

instance.c の 360 行で定義されています。

参照元 j_jconf_free(), j_process_am_remove(), と opt_parse().

呼出しグラフ:

boolean j_jconf_am_regist	(	Jconf *	jconf,
		JCONF_AM *	amconf,
		char *	name
	)

音響モデル(AM)パラメータ構造体を jconf に登録する． jconf内に同じ名前のモジュールが既に登録されている場合はエラーとなる．

引数:

jconf	[i/o] global jconf
amconf	[in] AM configuration to register
name	[in] module name

戻り値:: TRUE on success, FALSE on failure

instance.c の 386 行で定義されています。

参照元 opt_parse().

関数の呼び出しグラフ:

呼出しグラフ:

JCONF_LM* j_jconf_lm_new ( )

言語モデル (LM) パラメータ構造体を新たに割り付ける内部メンバにはデフォルト値が格納される.

戻り値:: the newly allocated LM parameter structure.

instance.c の 437 行で定義されています。

参照元 j_jconf_new(), と opt_parse().

関数の呼び出しグラフ:

呼出しグラフ:

void j_jconf_lm_free ( JCONF_LM * lmconf )

言語モデル (LM) パラメータ構造体を解放する

引数:

lmconf [in] LM parameter structure

instance.c の 462 行で定義されています。

参照元 j_jconf_free(), j_process_lm_remove(), と opt_parse().

呼出しグラフ:

boolean j_jconf_lm_regist	(	Jconf *	jconf,
		JCONF_LM *	lmconf,
		char *	name
	)

言語モデル(LM)パラメータ構造体を jconf に登録する． jconf内に同じ名前のモジュールが既に登録されている場合はエラーとなる．

引数:

jconf	[i/o] global jconf
lmconf	[in] LM configuration to register
name	[in] module name

戻り値:: TRUE on success, FALSE on failure

instance.c の 503 行で定義されています。

参照元 j_process_add_lm(), と opt_parse().

関数の呼び出しグラフ:

呼出しグラフ:

JCONF_SEARCH* j_jconf_search_new ( )

探索パラメータ(SEARCH)構造体を新たに割り付ける.

内部メンバにはデフォルト値が格納される.

戻り値:: the newly allocated SEARCH parameter structure.

instance.c の 554 行で定義されています。

参照元 j_jconf_new(), と opt_parse().

関数の呼び出しグラフ:

呼出しグラフ:

void j_jconf_search_free ( JCONF_SEARCH * sconf )

探索パラメータ(SEARCH)構造体を解放する

引数:

sconf [in] SEARCH parameter structure

instance.c の 579 行で定義されています。

参照元 j_jconf_free(), j_process_add_lm(), j_process_remove(), と opt_parse().

呼出しグラフ:

boolean j_jconf_search_regist	(	Jconf *	jconf,
		JCONF_SEARCH *	sconf,
		char *	name
	)

探索(SEARCH)パラメータ構造体を jconf に登録する． jconf内に同じ名前のモジュールが既に登録されている場合はエラーとなる．

引数:

jconf	[i/o] global jconf
sconf	[in] SEARCH configuration to register
name	[in] module name

戻り値:: TRUE on success, FALSE on failure

instance.c の 605 行で定義されています。

参照元 j_process_add_lm(), と opt_parse().

関数の呼び出しグラフ:

呼出しグラフ:

Jconf* j_jconf_new ( )

全体のパラメータ構造体を新たに割り付ける.

JCONF_AM, JCONF_LM, JCONF_SEARCHも１つづつ割り当てられる. これらは -AM 等の指定を含まない 3.x 以前の jconf を読み込んだときに，そのまま用いられる.

戻り値:: the newly allocated global configuration parameter structure.

instance.c の 661 行で定義されています。

参照元 j_config_load_args_new(), j_config_load_file_new(), j_config_load_string_new(), と j_output_argument_help().

関数の呼び出しグラフ:

呼出しグラフ:

void j_jconf_free ( Jconf * jconf )

全体のパラメータ構造体を開放する.

JCONF_AM, JCONF_LM, JCONF_SEARCHもすべて開放される.

引数:

jconf [in] global configuration parameter structure

instance.c の 714 行で定義されています。

参照元 j_config_load_args_new(), j_config_load_file_new(), j_config_load_string_new(), j_output_argument_help(), と j_recog_free().

関数の呼び出しグラフ:

呼出しグラフ:

static void j_config_remove_initial ( Jconf * jconf ) [static]

複数インスタンスが定義されている場合、初期インスタンス(id=0)は無効なので消す.

引数:

jconf [i/o] global configuration instance

jfunc.c の 332 行で定義されています。

参照元 j_config_load_args(), j_config_load_file(), と j_config_load_string().

呼出しグラフ:

int j_config_load_args	(	Jconf *	jconf,
		int	argc,
		char *	argv[]
	)

コマンド引数からパラメータを読み込み，jconf 内の各設定インスタンスに値を格納する.

引数:

jconf	[i/o] global configuration instance
argc	[in] number of arguments
argv	[in] list of argument strings

戻り値:: 0 on success, or -1 on failure.

jfunc.c の 376 行で定義されています。

参照元 j_config_load_args_new().

関数の呼び出しグラフ:

呼出しグラフ:

int j_config_load_string	(	Jconf *	jconf,
		char *	string
	)

コマンド引数を含む文字列からパラメータを読み込み，jconf 内の各設定インスタンスに値を格納する.

引数:

jconf	[i/o] global configuration instance
argstr	[in] argument string

戻り値:: 0 on success, or -1 on failure.

jfunc.c の 408 行で定義されています。

参照元 j_config_load_string_new().

関数の呼び出しグラフ:

呼出しグラフ:

int j_config_load_file	(	Jconf *	jconf,
		char *	filename
	)

jconf ファイルからパラメータを読み込み，jconf 内の各設定インスタンスに値を格納する.

引数:

jconf	[i/o] glbal configuration instance
filename	[in] jconf filename

戻り値:: 0 on sucess, or -1 on failure.

jfunc.c の 444 行で定義されています。

参照元 j_config_load_file_new().

関数の呼び出しグラフ:

呼出しグラフ:

Jconf* j_config_load_args_new	(	int	argc,
		char *	argv[]
	)

コマンド引数からパラメータを読み込み，その値を格納した新たな設定インスタンスを割り付けて返す.

引数:

argc	[in] number of arguments
argv	[in] list of argument strings

戻り値:: the newly allocated global configuration instance.

jfunc.c の 476 行で定義されています。

参照元 main().

関数の呼び出しグラフ:

呼出しグラフ:

Jconf* j_config_load_file_new ( char * filename )

新たな設定インスタンスを割り付け，そこに jconfファイルから設定パラメータを読み込んで返す.

引数:

filename [in] jconf filename

戻り値:: the newly allocated global configuration instance.

jfunc.c の 506 行で定義されています。

関数の呼び出しグラフ:

Jconf* j_config_load_string_new ( char * string )

新たな設定インスタンスを割り付け，そこに文字列から設定パラメータを読み込んで返す.

引数:

string [in] option string

戻り値:: the newly allocated global configuration instance.

jfunc.c の 536 行で定義されています。

関数の呼び出しグラフ:

void j_add_dict	(	JCONF_LM *	lm,
		char *	dictfile
	)

追加辞書ファイルの読み込みを指定する.

複数回呼ばれた場合、すべて読み込まれる。指定された辞書は起動時に通常の辞書のあとに続けて読み込まれる.

引数:

lm	[i/o] a LM configuration
dictfile	[in] dictinoary file name

戻り値:: the newly allocated global configuration instance.

jfunc.c の 569 行で定義されています。

参照元 opt_parse().

関数の呼び出しグラフ:

呼出しグラフ:

void j_add_word	(	JCONF_LM *	lm,
		char *	wordentry
	)

追加の単語エントリを指定する.

内容は辞書ファイルと同じフォーマット. 起動までに複数回呼ばれた場合、そのすべてが起動時に追加される.

引数:

lm	[i/o] a LM configuration
wordentry	[in] word entry string in dictionary format

jfunc.c の 599 行で定義されています。

参照元 opt_parse().

関数の呼び出しグラフ:

呼出しグラフ:

JCONF_AM* j_get_amconf_by_name	(	Jconf *	jconf,
		char *	name
	)

jconf内の AM モジュール設定構造体を名前で検索する.

引数:

jconf	[in] global configuration
name	[in] AM module name

戻り値:: the specified AM configuration, or NULL if not found.

jfunc.c の 859 行で定義されています。

参照元 opt_parse().

関数の呼び出しグラフ:

呼出しグラフ:

JCONF_AM* j_get_amconf_by_id	(	Jconf *	jconf,
		int	id
	)

jconf内の AM モジュール設定構造体を ID で検索する.

引数:

jconf	[in] global configuration
id	[in] AM module ID

戻り値:: the specified AM configuration, or NULL if not found.

jfunc.c の 893 行で定義されています。

参照元 opt_parse().

関数の呼び出しグラフ:

呼出しグラフ:

JCONF_AM* j_get_amconf_default ( Jconf * jconf )

デフォルトの AM 設定を返す.

AMが複数設定されている場合，最も最近のものを返す.

引数:

jconf [in] global configuration

戻り値:: the specified AM configuration, or NULL if not found.

jfunc.c の 930 行で定義されています。

参照元 j_process_add_lm().

呼出しグラフ:

JCONF_LM* j_get_lmconf_by_name	(	Jconf *	jconf,
		char *	name
	)

jconf内の LM モジュール設定構造体を名前で検索する.

引数:

jconf	[in] global configuration
name	[in] LM module name

戻り値:: the specified LM configuration, or NULL if not found.

jfunc.c の 957 行で定義されています。

参照元 opt_parse().

関数の呼び出しグラフ:

呼出しグラフ:

JCONF_LM* j_get_lmconf_by_id	(	Jconf *	jconf,
		int	id
	)

jconf内の LM モジュール設定構造体を ID で検索する.

引数:

jconf	[in] global configuration
id	[in] LM module ID

戻り値:: the specified LM configuration, or NULL if not found.

jfunc.c の 991 行で定義されています。

参照元 opt_parse().

関数の呼び出しグラフ:

呼出しグラフ:

JCONF_SEARCH* j_get_searchconf_by_name	(	Jconf *	jconf,
		char *	name
	)

jconf内の SESARCH モジュール設定構造体を名前で検索する.

引数:

jconf	[in] global configuration
name	[in] SEARCH module name

戻り値:: the found SEARCH configuration, or NULL if not found.

jfunc.c の 1025 行で定義されています。

関数の呼び出しグラフ:

JCONF_SEARCH* j_get_searchconf_by_id	(	Jconf *	jconf,
		int	id
	)

jconf内の SEARCH モジュール設定構造体を ID で検索する.

引数:

jconf	[in] global configuration
id	[in] SEARCH module ID

戻り値:: the found SEARCH configuration, or NULL if not found.

jfunc.c の 1059 行で定義されています。

関数の呼び出しグラフ:

boolean j_jconf_finalize ( Jconf * jconf )

jconf設定パラメータを最終的に決定する

この関数は，jconf ファイルやコマンドオプションによって与えられた jconf 内のパラメータについて精査を行う. 具体的には，値の範囲のチェックや，競合のチェック，設定から算出される各種パラメータの計算，使用するモデルに対する指定の有効性などをチェックする.

この関数は，アプリケーションによって jconf の各値の指定が終了した直後，エンジンインスタンスの作成やモデルのロードが行われる前に呼び出されるべきである.

引数:

jconf [i/o] global jconf configuration structure

戻り値:: TRUE when all check has been passed, or FALSE if not passed.

m_chkparam.c の 95 行で定義されています。

参照元 j_create_instance_from_jconf(), と j_process_add_lm().

関数の呼び出しグラフ:

呼出しグラフ: