WOLFRAM

ImageIdentify[image]

yields the result of attempting to identify what image is a picture of.

ImageIdentify[image,category]

restricts the identification of image to objects within the specified category.

ImageIdentify[image,category,n]

gives a list of up to n possible identifications.

ImageIdentify[image,category,n,"prop"]

gives the specified property for each identification.

Details and Options

  • ImageIdentify[{image1,image2,},] can be used to identify objects in multiple images.
  • In ImageIdentify[image,category], possible forms for category include:
  • "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
    category1|category2|any of the categoryi
  • By default, ImageIdentify returns objects of the form Entity["Concept",].
  • The property "prop" can be one of the following:
  • "Concept"a concept entity object
    "Entity"when possible, a concrete entity object
    "Probability"an association of concepts and probabilities
    "cprop"a property supported by "Concept" entities
    {prop1,}a list of property specifications
  • The following options can be given:
  • AcceptanceThreshold Automaticidentification acceptance threshold
    PerformanceGoal Automaticwhat to optimize in the identification
    SpecificityGoal Automaticwhat specificity of object type to seek
    TargetDevice"CPU"the target device on which to compute
  • Possible settings for PerformanceGoal include "Speed" and "Quality".
  • Possible settings for SpecificityGoal include:
  • "Low"favor general categories of objects
    "High"favor specific kinds of objects
    sspecificity between 0 (lowest) and 1 (highest)
  • When no content is found at an acceptable threshold, Missing["Unidentified"] is returned.
  • ImageIdentify uses machine learning. Its methods, training sets and biases included therein may change and yield varied results in different versions of the Wolfram Language.
  • ImageIdentify 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

Identify the object present in the image:

Out[6]=6

Identify what type of dog is present in the image:

Out[1]=1

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

Return a result in a specific category:

Out[1]=1

Return a list of results:

Out[1]=1

Return a list of results and their associated probability:

Out[1]=1

Options  (4)Common values & functionality for each option

AcceptanceThreshold  (1)

The AcceptanceThreshold is selected automatically:

Out[1]=1

Specify a custom threshold:

Out[2]=2

If no identification is above the threshold, a Missing object is returned:

Out[14]=14

PerformanceGoal  (1)

Use PerformanceGoal"Speed" to get a result as fast as possible:

Out[5]=5

Use a slower, more accurate recognition:

Out[6]=6

SpecificityGoal  (2)

Privilege a result with a low specificity:

Out[5]=5

Privilege a result with a high specificity:

Out[3]=3

Use a custom value:

Out[4]=4

Get a table of identifications for different values of specificity:

Out[1]=1

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

The neural net used by ImageIdentify can be accessed using NetModel:

Out[2]=2
Out[3]=3

Possible Issues  (1)Common pitfalls and unexpected behavior

If a recognition category is specified, probabilities are renormalized in that category:

Out[1]=1

Remove the category constraint to recognize the object correctly:

Out[2]=2

Neat Examples  (1)Surprising or curious use cases

Get 10 different identifications, along with their probabilities:

Out[1]=1

Visualize the result of object identification using a WordCloud:

Out[2]=2
Wolfram Research (2015), ImageIdentify, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageIdentify.html (updated 2023).
Wolfram Research (2015), ImageIdentify, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageIdentify.html (updated 2023).

Text

Wolfram Research (2015), ImageIdentify, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageIdentify.html (updated 2023).

Wolfram Research (2015), ImageIdentify, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageIdentify.html (updated 2023).

CMS

Wolfram Language. 2015. "ImageIdentify." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2023. https://reference.wolfram.com/language/ref/ImageIdentify.html.

Wolfram Language. 2015. "ImageIdentify." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2023. https://reference.wolfram.com/language/ref/ImageIdentify.html.

APA

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

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

BibTeX

@misc{reference.wolfram_2024_imageidentify, author="Wolfram Research", title="{ImageIdentify}", year="2023", howpublished="\url{https://reference.wolfram.com/language/ref/ImageIdentify.html}", note=[Accessed: 09-January-2025 ]}

@misc{reference.wolfram_2024_imageidentify, author="Wolfram Research", title="{ImageIdentify}", year="2023", howpublished="\url{https://reference.wolfram.com/language/ref/ImageIdentify.html}", note=[Accessed: 09-January-2025 ]}

BibLaTeX

@online{reference.wolfram_2024_imageidentify, organization={Wolfram Research}, title={ImageIdentify}, year={2023}, url={https://reference.wolfram.com/language/ref/ImageIdentify.html}, note=[Accessed: 09-January-2025 ]}

@online{reference.wolfram_2024_imageidentify, organization={Wolfram Research}, title={ImageIdentify}, year={2023}, url={https://reference.wolfram.com/language/ref/ImageIdentify.html}, note=[Accessed: 09-January-2025 ]}