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


assumes that the image is of something in the category cat.

Details and Options

  • ImageContainsQ tries to identify whether an image is an instance of a given category.
  • Possible forms for both object obj and category cat are:
  • "type"entity type, as used in Interpreter
    "concept"named concept, as used in "Concept" entities
    "word"English word, as used in WordData
    wordspecword sense specification, as used in WordData
    Entity[]any appropriate entity
    instance1|instance2|any of the instancei
  • The following options can be given:
  • AcceptanceThreshold 0.5what recognition probability to require
    PerformanceGoalAutomaticfavor algorithms with specific advantages
    RecognitionPrior 0.5prior probability for a True result
    TargetDevice"CPU"the target device on which to compute
  • ImageInstanceQ uses machine learning. Its methods, training sets and biases included therein may change and yield varied results in different versions of the Wolfram Language.
  • ImageInstanceQ may download resources that will be stored in your local object store at $LocalBase, and can be listed using LocalObjects[] and removed using ResourceRemove.


open allclose all

Basic Examples  (2)

Test whether an image is an instance of a particular object:

Perform the test within a specific category:

Options  (2)

AcceptanceThreshold  (1)

Using the default AcceptanceThreshold, an object may not be identified:

Specify a lower threshold to accept a less certain match:

RecognitionPrior  (1)

The default RecognitionPrior is 0.5:

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

Wolfram Research (2015), ImageInstanceQ, Wolfram Language function,


Wolfram Research (2015), ImageInstanceQ, Wolfram Language function,


Wolfram Language. 2015. "ImageInstanceQ." Wolfram Language & System Documentation Center. Wolfram Research.


Wolfram Language. (2015). ImageInstanceQ. Wolfram Language & System Documentation Center. Retrieved from


@misc{reference.wolfram_2024_imageinstanceq, author="Wolfram Research", title="{ImageInstanceQ}", year="2015", howpublished="\url{}", note=[Accessed: 16-June-2024 ]}


@online{reference.wolfram_2024_imageinstanceq, organization={Wolfram Research}, title={ImageInstanceQ}, year={2015}, url={}, note=[Accessed: 16-June-2024 ]}