Browse
 
Tools
Rss Categories

Testing different ASR languages

Reference Number: AA-02079 Views: 5228 0 Rating/ Voters

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.

  

Language

  
  

Code

  
  

Grammar File

  
  

 

  
  

American English

  
  

en-US

  
  

en-us-test.gram

  

 

  

Australian English

  
  

en-AU

  
  

en-au-test.gram

  

 

  

British English

  
  

en-GB

  
  

en-gb-test.gram

  

 

  

Indian English

  
  

en-IN

  
  

en-in-test.gram

  

 

  

Mexican Spanish

  
  

es-MX

  
  

es-mx-test.gram

  

 

  

Colombian Spanish

  
  

es-CO

  
  

es-co-test.gram

  

 

  

French Canadian

  
  

fr-CA

  
  

fr-ca-test.gram

  

 

  

Brazilian Portuguese

  
  

pt-BR

  
  

pt-br-test.gram

  

 

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.

  

All Languages

  
  


  
  

test.ulaw

  

 


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.

Attachments
en-au-test.gram 139 b Download File
en-gb-test.gram 139 b Download File
en-in-test.gram 139 b Download File
en-us-test.gram 139 b Download File
es-co-test.gram 139 b Download File
es-mx-test.gram 139 b Download File
fr-ca-test.gram 139 b Download File
pt-br-test.gram 139 b Download File
test.ulaw 15.1 Kb Download File