WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

SpeechInterpreter   
✖
SpeechInterpreter

Listing of Interpreter Types »
[Experimental]

✖

represents an interpreter object that can be applied to a speech input to try to interpret it as an object of the specified form.

✖
SpeechInterpreter[form,test]

returns the interpreted object only if applying test to it yields True; otherwise, it returns a Failure object.

✖
SpeechInterpreter[form,test,fail]

returns the result of applying the function fail if the test fails.

Details and Options

  • SpeechInterpreter[…][audio] applies the interpreter to a particular audio recording.
  • Possible form specifications include:
  • "SemanticExpression"expression derived semantically from free-form input
    "SemanticNumber"number derived semantically (e.g. "half")
    "SemanticInteger"integer derived semantically (e.g. "six")
    "Boolean"Boolean value (true/false, 1/0, etc. giving True/False)
    "String"pure string
    "TextArea"text of any length (rendered in forms as a text area)
    "TextLine"single line of text
    "SemanticURL"URL derived semantically (e.g. from company name)
    "Date"date in any standard format
    "StructuredDate"date obtained from a picker
    "DateTime"date and time
    "Time"time of day
    "ComputedDate",etc.date derived by computation (e.g. "next tuesday")
    "Location"anything that yields a geo location
    "StreetAddress"any standard street address
    "Country"country or country-like territory
    "AdministrativeDivision"state, province, county, etc.
    "USState"US state
    "USCounty"US county
    "Quantity"quantity with units
    "ComputedQuantity"quantity derived by computation
    "PhysicalQuantity"physical quantity (e.g. "mass")
    "CurrencyAmount"currency amount (e.g. "$7.50")
    "CurrencyName"name of a currency (e.g. "US dollars")
    "Company"company
    "TickerSymbol"financial instrument ticker symbol
    "Color"color in any standard format
    "entity"any Wolfram Language entity type (e.g. "City")
    "entityclass"a class of entities (e.g. "CityClass")
    Restricted[form,spec]a form restricted in the specified way
    DelimitedSequence[form,…]a delimited sequence of forms returned as a list
    form1|form2|…several possible forms, tried in order
    {c1,c2,…}a literal set of choices ci
    {lab1c1,lab2c2,…}choices ci with labels labi
    AnySubset[{c1,c2,…}]any subset of the ci
    CompoundElement[{form1,…}]a list of elements specified by the formi
    CompoundElement[<|key1form1,…|>]an association of elements specified by the formi
    RepeatingElement[form,…]a list of elements all specified by form
    		CloudObject[…]a deployed GrammarRules object
    QuantityVariable["pq"]a quantity compatible with the physical quantity pq
  • $InterpreterTypes gives a complete list of possible interpreter types.
  • In the case of "entity", any domain supported by EntityValue can be used.
  • SpeechInterpreter[…][audio] returns an interpreted value, or Missing["NoInput"] if no speech is recognized from audio.
  • SpeechInterpreter[choices] allows a list of rules or an association for choices. A pure list of values can also be used when there is no ambiguity.
  • SpeechInterpreter[form,test][input] applies test to the result of interpreting input using the specified form.
  • If the result of applying test is True, then the interpretation of input is returned.
  • If the result of applying test is a Failure object, this object is immediately returned.
  • If the result of applying test is False or anything else, then in SpeechInterpreter[form,test,fail][input] the result of applying fail to the interpretation of input is returned. If no fail is given, then a Failure object is returned.
  • If SpeechInterpreter directly generates a Failure object, the following tags are used:
  • "InterpretationFailure"the string given could not be interpreted in the form specified
    "RestrictionFailure"interpretation succeeded, but a restriction failed
    "ConditionFailure"interpretation and restrictions succeeded, but explicit test failed
    "ConnectionFailure"required cloud connection could not be made
  • SpeechInterpreter supports the following options:
  • AmbiguityFunctionAutomaticfunction to apply to ambiguous semantic results
    GeoLocation$GeoLocationgeo location to assume for semantic interpretation
    Masking Allinterval of interest
    TargetDevice"CPU"the device on which to perform recognition
    TimeZone$TimeZonetime zone to assume for semantic interpretation
  • SpeechInterpreter[spec][{input1,input2,…}] is equivalent to {SpeechInterpreter[spec][input1],SpeechInterpreter[spec][input2],…}, except insofar as spec contains constructs such as CompoundElement or RepeatingElement that directly interpret the structure given.
  • SpeechInterpreter[spec][{input1,input2,…}] maps interpretation over all inputi, except insofar as spec contains constructs such as CompoundElement or RepeatingElement that directly interpret the structure given.
  • SpeechInterpreter[form][audio1|audio2|…] yields as a result the interpretation of the first of the audioi that can be interpreted using the specified form.
  • SpeechInterpreter uses machine learning. Its methods, training sets and biases included therein may change and yield varied results in different versions of the Wolfram Language.
  • SpeechInterpreter may download resources that will be stored in your local object store at $LocalBase, and that can be listed using LocalObjects[] and removed using ResourceRemove.

Examples

open allclose all

Basic Examples  (2)Summary of the most common use cases

Interpret a date, generating a DateObject:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-mh1jtu
Out[1]=1

Interpret a country, generating an Entity object:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-sk77xp
Out[1]=1

Scope  (19)Survey of the scope of standard use cases

Basic Uses  (3)

Interpret an integer:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-lbcsh3
Out[1]=1

Perform a test on the interpreted value, returning a Failure if the test result is not True:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-ddtqkq
Out[1]=1

Specify a custom failure function to evaluate:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-crqg4j
Out[1]=1

Input Specification  (4)

Interpret integers in a single recording:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-q8b7n1
Out[1]=1

Interpret integers in multiple recordings:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-0nynj1
Out[1]=1

Return the interpretation of the first of the recordings that can be interpreted as an integer:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-vmhyzo
Out[1]=1

Interpret a compound element and return a list of interpretations:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-jnzi1s
Out[1]=1

Form Specification  (5)

Use a single interpretation type:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-etxahp
Out[1]=1

Interpretation fails if the recording is not of the specified type:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-ujgobh
Out[1]=1

Use a list of alternative interpretation types. The first interpretation that succeeds is returned:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-i8y2g8
Out[1]=1

Return one of a literal set of choices matched by the speech in a recording:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-xyxy64
Out[1]=1

Return the value associated with the literal choice matched by the speech in a recording:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-nmmqas
Out[1]=1

Interpreter Types  (7)

Interpret a university, returning an Entity object:

In[3]:=3
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-hjagm
Out[3]=3

Interpret a location, returning a GeoPosition object:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-b9vgtc
Out[1]=1

Interpret input as a currency amount, returning a Quantity object:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-6n5vdu
Out[1]=1

Perform a computation on interpreted input:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-jt88e7
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-hxpz4
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-ijmtt
Out[3]=3

Interpret many types of entities:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-ehp8nm
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-c6sdcp
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-mfzkb0
Out[3]=3

Interpret a spoken free-form expression:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-j9ijw4
Out[1]=1

Interpret a sequence of colors:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-kbpvwb
Out[1]=1

Options  (1)Common values & functionality for each option

Masking  (1)

By default, the entire recording is used for interpretation:

In[5]:=5
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-dgxnog
Out[5]=5

Specify an interval of interest to be interpreted:

In[9]:=9
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-gss6ym
Out[9]=9

Applications  (2)Sample problems that can be solved with this function

Interpret an audio recording as an airline:

In[13]:=13
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-8zev6f
Out[13]=13

Interpret a spoken city:

In[1]:=1
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-6l4rd8
Out[1]=1

Show the recognized city on the map:

In[2]:=2
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-vrwtfy
Out[2]=2

Properties & Relations  (1)Properties of the function, and connections to other functions

SpeechInterpreter is effectively calling Interpreter on the result of SpeechRecognize:

In[6]:=6
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-j0wjef
Out[7]=7
In[8]:=8
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-xgp6dz
Out[8]=8

Compare with direct speech interpretation:

In[3]:=3
✖
https://wolfram.com/xid/0cpq3ko7iklw4p-hedy48
Out[3]=3
Wolfram Research (2020), SpeechInterpreter, Wolfram Language function, https://reference.wolfram.com/language/ref/SpeechInterpreter.html.
✖
Wolfram Research (2020), SpeechInterpreter, Wolfram Language function, https://reference.wolfram.com/language/ref/SpeechInterpreter.html.

Text

Wolfram Research (2020), SpeechInterpreter, Wolfram Language function, https://reference.wolfram.com/language/ref/SpeechInterpreter.html.

✖
Wolfram Research (2020), SpeechInterpreter, Wolfram Language function, https://reference.wolfram.com/language/ref/SpeechInterpreter.html.

CMS

Wolfram Language. 2020. "SpeechInterpreter." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/SpeechInterpreter.html.

✖
Wolfram Language. 2020. "SpeechInterpreter." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/SpeechInterpreter.html.

APA

Wolfram Language. (2020). SpeechInterpreter. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/SpeechInterpreter.html

✖
Wolfram Language. (2020). SpeechInterpreter. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/SpeechInterpreter.html

BibTeX

@misc{reference.wolfram_2025_speechinterpreter, author="Wolfram Research", title="{SpeechInterpreter}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/SpeechInterpreter.html}", note=[Accessed: 08-July-2025 ]}

✖
@misc{reference.wolfram_2025_speechinterpreter, author="Wolfram Research", title="{SpeechInterpreter}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/SpeechInterpreter.html}", note=[Accessed: 08-July-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_speechinterpreter, organization={Wolfram Research}, title={SpeechInterpreter}, year={2020}, url={https://reference.wolfram.com/language/ref/SpeechInterpreter.html}, note=[Accessed: 08-July-2025 ]}

✖
@online{reference.wolfram_2025_speechinterpreter, organization={Wolfram Research}, title={SpeechInterpreter}, year={2020}, url={https://reference.wolfram.com/language/ref/SpeechInterpreter.html}, note=[Accessed: 08-July-2025 ]}