lv_show_config is a very effective tool at checking configuration and performing various tests of the LumenVox services.
Unfortunately, this tool can often cause confusion for users that do not have American English licenses and/or languages installed. This article describes how to perform simple validation of your ASR licensing and engine performance if you do not have any American English licenses, or American English acoustic models loaded.
During the following example, we'll be using the SimpleASRClient tool, along with language specific grammars to exercise both licensing and ASR for your chosen language.
Select the language(s) you would like to test from the selection below, and download the corresponding test grammar file to your local system.
Once you have the grammar(s) downloaded to your local system, you will then need to download the test audio file that we will be using to. This same audio file can be used for testing all languages.
Note:
You can also use the list of attachments at the bottom of this article to download any of these files if needed.
Now that the necessary test files have been downloaded, you can proceed to running the SimpleASRClient to test the desired languages. For more information on this utility, please read our main SimpleASRClient article.
As a reminder, the usage for SimpleASRClient is:
SimpleASRClient <grammarlabel> <grammar> <audio format> <audio file> [<ASR IP>]
- <grammar label> is a name you assign to the loaded grammar to make it easier to call upon that grammar during the activate grammar sequence of the application.
- <grammar> is the location (either a path on disk or a fully qualified URI) to the grammar you wish to be loaded.
- <audio format> indicates in which format the audio you are providing exists.
Acceptable formats are 0 for Unknown Format, 1 for ULAW 8 kHz, 2 for PCM 8 kHz, 3 for PCM 16 kHz, 4 for ALAW 8 kHz.
(The audio format for the test.ulaw audio sample is ulaw 8 kHz so use number 1 for the audio format parameter.) - optionally, <ASR IP> is the IP address of the LumenVox ASR server. This can be used to talk to a remote ASR.
Note:
If no path is specified for either the grammar or the audio file, the Linux client will first look in the local directory and then in /usr/share/lumenvox/client/data. The Windows client only looks in the local folder. Please ensure the files you downloaded above are in your local folder, or you will need to specify the full path to each file.
American English
Running this test for American English can be done using the following command:
Sample use on Windows:
C:\Program Files\Lumenvox\Engine>SimpleASRClient.exe grammar_label en-us-test.gram 1 test.ulaw
Sample use on Linux:
# SimpleASRClient grammar_label en-us-test.gram 1 test.ulaw
Sample output (Windows):
C:\Program Files\Lumenvox\Engine>SimpleASRClient.exe grammar_label en-us-test.gram 1 test.ulaw
Loaded Grammar!
Loaded Audio!
Decode returned!
Alternative 1:
Interpretation 1 of 1
Grammar Label :grammar_label
Input Sentence : TEST
Interpretation String: TEST
Interpretation Score : 974
Sample output (Linux):
# SimpleASRClient grammar_label en-us-test.gram 1 test.ulaw
Loaded Grammar!
Loaded Audio!
Decode returned!
Alternative 1:
Interpretation 1 of 1
Grammar Label :grammar_label
Input Sentence : TEST
Interpretation String: TEST
Interpretation Score : 974
The actual Input Sentence, Interpretation String and Interpretation Score you see being returned for this test is not really important - as long as you get some sort of results that is similar to that shown here, and more importantly, you do not see any errors being reported, this means that your license and ASR functionality for the selected language is working correctly.
The results will all be fairly similar for all languages, only the name of the grammar file will change based on the selected language, as shown below:
Australian English
Running this test for Australian English can be done using the following command:
Sample use on Windows:
C:\Program Files\Lumenvox\Engine>SimpleASRClient.exe grammar_label en-au-test.gram 1 test.ulaw
Sample use on Linux:
# SimpleASRClient grammar_label en-au-test.gram 1 test.ulaw
The results should be similar to the American English shown above. If you see no errors, then your licensing and ASR for this language is working.
British English
Running this test for British English can be done using the following command:
Sample use on Windows:
C:\Program Files\Lumenvox\Engine>SimpleASRClient.exe grammar_label en-gb-test.gram 1 test.ulaw
Sample use on Linux:
# SimpleASRClient grammar_label en-gb-test.gram 1 test.ulaw
The results should be similar to the American English shown above. If you see no errors, then your licensing and ASR for this language is working.
Indian English
Running this test for Indian English can be done using the following command:
Sample use on Windows:
C:\Program Files\Lumenvox\Engine>SimpleASRClient.exe grammar_label en-in-test.gram 1 test.ulaw
Sample use on Linux:
# SimpleASRClient grammar_label en-in-test.gram 1 test.ulaw
The results should be similar to the American English shown above. If you see no errors, then your licensing and ASR for this language is working.
Mexican Spanish
Running this test for Mexican Spanish can be done using the following command:
Sample use on Windows:
C:\Program Files\Lumenvox\Engine>SimpleASRClient.exe grammar_label es-mx-test.gram 1 test.ulaw
Sample use on Linux:
# SimpleASRClient grammar_label es-mx-test.gram 1 test.ulaw
The results should be similar to the American English shown above. If you see no errors, then your licensing and ASR for this language is working.
Colombian Spanish
Running this test for Colombian Spanish can be done using the following command:
Sample use on Windows:
C:\Program Files\Lumenvox\Engine>SimpleASRClient.exe grammar_label es-co-test.gram 1 test.ulaw
Sample use on Linux:
# SimpleASRClient grammar_label es-co-test.gram 1 test.ulaw
The results should be similar to the American English shown above. If you see no errors, then your licensing and ASR for this language is working.
French Canadian
Running this test for French Canadian can be done using the following command:
Sample use on Windows:
C:\Program Files\Lumenvox\Engine>SimpleASRClient.exe grammar_label fr-ca-test.gram 1 test.ulaw
Sample use on Linux:
# SimpleASRClient grammar_label fr-ca-test.gram 1 test.ulaw
The results should be similar to the American English shown above. If you see no errors, then your licensing and ASR for this language is working.
Brazilian Portuguese
Running this test for Brazilian Portuguese can be done using the following command:
Sample use on Windows:
C:\Program Files\Lumenvox\Engine>SimpleASRClient.exe grammar_label pt-br-test.gram 1 test.ulaw
Sample use on Linux:
# SimpleASRClient grammar_label pt-br-test.gram 1 test.ulaw
The results should be similar to the American English shown above. If you see no errors, then your licensing and ASR for this language is working.
German
Running this test for German can be done using the following command:
Sample use on Windows:
C:\Program Files\Lumenvox\Engine>SimpleASRClient.exe grammar_label de-de-test.gram 1 test.ulaw
Sample use on Linux:
# SimpleASRClient grammar_label de-de-test.gram 1 test.ulaw
The results should be similar to the American English shown above. If you see no errors, then your licensing and ASR for this language is working.
Italian
Running this test for Italian can be done using the following command:
Sample use on Windows:
C:\Program Files\Lumenvox\Engine>SimpleASRClient.exe grammar_label it-it-test.gram 1 test.ulaw
Sample use on Linux:
# SimpleASRClient grammar_label it-it-test.gram 1 test.ulaw
The results should be similar to the American English shown above. If you see no errors, then your licensing and ASR for this language is working.
