swirec_max_parses_per_literal

Maximum number of parses evaluated by Recognizer for a single literal string.

Value

Integer: 1–99.

Default

10 (parses)

Automatically set to 1 for robust parsing grammars (unless you override with a <meta> in the grammar file). For details, see Robust parsing grammars.

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 or SET-PARAMS 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 Management Station set on the Nuance recognition service. If not using Management Station, set in a Recognizer configuration file (User-nrsxx.xml).

Usage

Prevents degraded performance when a grammar allows a large number of parses.

This is an advanced feature for developers who are familiar with Recognizer and its underlying models. It is typically used with advanced natural language grammars (see Adding natural language capabilities).

Performance

Limiting the maximum number of parses, limits the total CPU cycles used.

Changing the default value can seriously impair accuracy and confidence. After changing the value, you must thoroughly test recognition accuracy before applying the change to a production system.

This parameter controls the maximum number of parses (interpretations) that can be evaluated by Recognizer for a single literal string in the grammar.

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_max_parses_per_literal=20

Sample definition in a grammar file:

<meta name="swirec_max_parses_per_literal" content="20"/>

Related parameters