swirec_state_beam

Specifies the primary guide to control the number of paths considered. Primary guide for the Viterbi beam search.

Value

Float: -100–100. As many as three values are allowed.

A typical range is between -60 and 0.

DEFAULT: 0, -15, -35

How to set

Shown in precedence order (see Rules of parameter precedence):

Set in the browser, using the Vendor-Specific-Parameters header in a RECOGNIZE method.

In a parameter grammar.

In a grammar using a <meta> tag (see the text on recognition-time parameters in Parameters set in grammar files).

In the application's session xml in the <speechrecog> section of <sessionparameters>

In Management Station set on the Nuance recognition service. If not using Management Station, set in a Recognizer configuration file (User-nrsxx.xml).

Usage

This is an advanced feature for developers who are familiar with the Recognizer and its underlying models. It can be used to trade off accuracy and CPU usage according to the needs of the application.

Performance

Changing the default value can seriously impair accuracy or lead to an increase in CPU usage. After changing the value, you must thoroughly test recognition accuracy and CPU usage before applying the change to a production system.

When set via VoiceXML or MRCP, the setting is valid for the next recognition event for all active grammars. When set via a grammar, the setting is valid until the grammar is de-activated. After the event or deactivation, the settings return to the values set in a configuration file.

This parameter provides the primary guide for the Viterbi beam search. It is used to prune all active search paths. A higher value allows consideration of more paths (that is, it prunes fewer paths). This tends to improve accuracy at the expense of higher computation. You can use it when you need higher accuracy or lower CPU usage.

This parameter specifies as many as 3 possible values. The value used depends on the setting of swirec_load_adjusted_speedvsaccuracy and on the system load at recognition time. When the speed versus accuracy parameter is turned on, the Recognizer automatically refines and improves recognition results by using extra CPU cycles if they are available. By default, the Recognizer uses the first value defined and then it uses the second or third value as CPU load increases. (The CPU thresholds are labeled as idle, normal, and busy.) If fewer than 3 values are specified, the value in the final position is assumed to be repeated.

Browsers usually set this parameter in a RECOGNIZE request, and the parameter automatically reverts to the previous value after the recognition event. (Alternatively, browsers can use the SET-PARAMS method. See Configuring Recognizer with the browser.)

Vendor-Specific-Parameters: swirec_state_beam=0 -15 -25

Sample definition in a grammar file:

<meta name="swirec_state_beam" content="0 -15 -35"/>

Sample definition in the <speechrecog> section of a session.xml file:

<param name="swirec_state_beam">
 <value>0</value>
 <value>-15</value>
 <value>-35</value>
</param>

Related parameters