WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

AudioInstanceQ

[Experimental]

✖
AudioInstanceQ[audio,obj]

gives True if audio sounds to be an instance of the object obj, and gives False otherwise.

✖
AudioInstanceQ[audio,obj,cat]

assumes that audio is the sound of something in the category cat.

Details and Options

  • AudioInstanceQ tries to identify whether an audio signal is an instance of a given category.
  • Possible forms for both object obj and category cat are:
  • "class"named sound class, as used in "Sound" entities
    Entity[…]any appropriate entity
    instance1|instance2|…any of the instancei
  • The following options can be given:
  • AcceptanceThreshold Automaticminimum probability to consider acceptable
    Masking Allinterval of interest
    PerformanceGoalAutomaticwhat to optimize in the identification
    RecognitionPrior 0.5prior probability for a True result
    TargetDevice"CPU"the target device on which to compute
  • AudioInstanceQ uses machine learning. Its methods, training sets and biases included therein may change and yield varied results in different versions of the Wolfram Language.
  • AudioInstanceQ may download resources that will be stored in your local object store at $LocalBase, and can be listed using LocalObjects[] and removed using ResourceRemove.

Examples

open allclose all

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

Test whether an audio signal is an instance of a particular object:

In[142]:=142
✖
https://wolfram.com/xid/0n4qcfpluwz-ud2796
Out[142]=142
In[141]:=141
✖
https://wolfram.com/xid/0n4qcfpluwz-j5lmgt
Out[141]=141
In[147]:=147
✖
https://wolfram.com/xid/0n4qcfpluwz-g2rbqu
Out[147]=147

Test whether an audio signal is an instance of either of the given categories:

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

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

By default, no assumptions are made about the sound category of the audio signal:

In[7]:=7
✖
https://wolfram.com/xid/0n4qcfpluwz-6oc8wq
Out[7]=7

Assume that the audio signal belongs to a specific sound category:

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

Assume that the audio signal belongs to a specific set of sound categories:

In[17]:=17
✖
https://wolfram.com/xid/0n4qcfpluwz-cda944
Out[17]=17

Options  (3)Common values & functionality for each option

AcceptanceThreshold  (1)

By default, an automatic acceptance threshold is used:

In[167]:=167
✖
https://wolfram.com/xid/0n4qcfpluwz-laz9ho
Out[167]=167

Specify the acceptance threshold:

In[167]:=167
✖
https://wolfram.com/xid/0n4qcfpluwz-45fq46
Out[167]=167

Masking  (1)

By default, the entire audio signal is checked for the specified object:

In[3]:=3
✖
https://wolfram.com/xid/0n4qcfpluwz-d5ecqa
In[4]:=4
✖
https://wolfram.com/xid/0n4qcfpluwz-c2z2ze
Out[4]=4

Restrict the test to a specific interval:

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

RecognitionPrior  (1)

The default RecognitionPrior is 0.5:

In[4]:=4
✖
https://wolfram.com/xid/0n4qcfpluwz-yc5z3
Out[4]=4

Assign a very low prior probability to the object to be tested for:

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

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

Find all recordings in the ExampleData collection that are recognized as a musical instrument:

In[4]:=4
✖
https://wolfram.com/xid/0n4qcfpluwz-c8gb1e
In[6]:=6
✖
https://wolfram.com/xid/0n4qcfpluwz-qj9el5
In[8]:=8
✖
https://wolfram.com/xid/0n4qcfpluwz-hpbwjk
Out[8]=8

Find other sounds that are similar to a recording:

In[1]:=1
✖
https://wolfram.com/xid/0n4qcfpluwz-c2fasn

Compute an object identification using AudioIdentify:

In[2]:=2
✖
https://wolfram.com/xid/0n4qcfpluwz-3abe6
Out[2]=2

Find sounds with the same identification in the ExampleData collection:

In[3]:=3
✖
https://wolfram.com/xid/0n4qcfpluwz-fvn5qp
In[4]:=4
✖
https://wolfram.com/xid/0n4qcfpluwz-dmqhz6
In[5]:=5
✖
https://wolfram.com/xid/0n4qcfpluwz-fwiues
Out[5]=5

Compute a list of more general objects using the broader sound property of Entity objects:

In[6]:=6
✖
https://wolfram.com/xid/0n4qcfpluwz-fbkslt
Out[6]=6

Find sounds within broader categories:

In[7]:=7
✖
https://wolfram.com/xid/0n4qcfpluwz-ln9ehd
In[8]:=8
✖
https://wolfram.com/xid/0n4qcfpluwz-bau4c3
Out[8]=8

Compute a larger list of related sounds using AudioIdentify:

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

Find similar sounds among the ExampleData collection:

In[10]:=10
✖
https://wolfram.com/xid/0n4qcfpluwz-dt80iu
In[11]:=11
✖
https://wolfram.com/xid/0n4qcfpluwz-fwvb47
Out[11]=11

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

AudioInstanceQ and AudioIdentify offer complementary functionality:

In[1]:=1
✖
https://wolfram.com/xid/0n4qcfpluwz-mtshc

Compute the most probable object identification:

In[18]:=18
✖
https://wolfram.com/xid/0n4qcfpluwz-f16j0l
Out[18]=18

Pass the identification to AudioInstanceQ:

In[19]:=19
✖
https://wolfram.com/xid/0n4qcfpluwz-gtxdua
Out[19]=19

Get the probability associated with the identification:

In[21]:=21
✖
https://wolfram.com/xid/0n4qcfpluwz-c8jaxc
Out[21]=21
In[22]:=22
✖
https://wolfram.com/xid/0n4qcfpluwz-19qd8
Out[22]=22

The minimum acceptable probability corresponds to the confidence in the original identification:

In[25]:=25
✖
https://wolfram.com/xid/0n4qcfpluwz-d6e6a8
Out[25]=25

Specifying a minimum acceptable probability for the tested-for object will have no effect if the tested-for object does not belong to one of the assumed categories, if specified.

Test whether a recording of an acoustic guitar is an animal:

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

Specify a very low acceptable threshold:

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

Test whether the recording is a guitar, assuming that it belongs to the category of animal sounds:

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

Specifying a very low acceptance threshold will not yield a match since a "guitar" sound is not in the "animal" category:

In[4]:=4
✖
https://wolfram.com/xid/0n4qcfpluwz-icesek
Out[4]=4
Wolfram Research (2020), AudioInstanceQ, Wolfram Language function, https://reference.wolfram.com/language/ref/AudioInstanceQ.html.
✖
Wolfram Research (2020), AudioInstanceQ, Wolfram Language function, https://reference.wolfram.com/language/ref/AudioInstanceQ.html.

Text

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

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

CMS

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

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

APA

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

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

BibTeX

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

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

BibLaTeX

@online{reference.wolfram_2025_audioinstanceq, organization={Wolfram Research}, title={AudioInstanceQ}, year={2020}, url={https://reference.wolfram.com/language/ref/AudioInstanceQ.html}, note=[Accessed: 21-April-2025 ]}

✖
@online{reference.wolfram_2025_audioinstanceq, organization={Wolfram Research}, title={AudioInstanceQ}, year={2020}, url={https://reference.wolfram.com/language/ref/AudioInstanceQ.html}, note=[Accessed: 21-April-2025 ]}