TextCases[text,form]

gives a list of all cases of text identified as being of type form that appear in text.

TextCases[text,{form1,form2,}]

gives an association of results for all the types formi.

TextCases[text,formspecprop]

gives the specified property for each result found.

TextCases[text,formspec{prop1,prop2,}]

gives a list of properties for each result found.

TextCases[text,spec,n]

gives the first n cases found.

Details and Options

  • In TextCases[text,], text can be a string, a file with plain text represented by File[], a ContentObject expression or a list of these text objects.
  • TextCases[{text1,text2,},] gives cases for each texti.
  • Identification type form can be:
  • "type"any text content type (e.g. "Noun", "City")
    Entity[,]a specific entity of a text content type
    form1|form2|
  • form matching any of the formi
  • Containing[outer,inner]forms of type outer containing type inner
    Verbatim["string"]a specific string to be matched exactly
    patterna string pattern to be matched
  • Possible choices for the property prop are:
  • "String"string of the identified text (default)
    "Position"start and end position of the string in text
    "Probability"estimated probability that the identification is correct
    "Interpretation"standard interpretation of the identified string
    "Snippet"a snippet around the identified string
    "HighlightedSnippet"a snippet with the identified string highlighted
    fapply f to the association containing all properties
    {prop1,prop2,}a list of property specifications
  • The following options can be given:
  • AcceptanceThresholdAutomaticminimum probability to accept identification
    PerformanceGoalAutomaticfavor algorithms with specific advantages
    TargetDevice"CPU"whether CPU or GPU computation should be used for entity detection
    VerifyInterpretationFalsewhether interpretability should be verified

Examples

open all close all

Basic Examples  (6)

Find the cities in a text:

In[1]:=
Click for copyable input
Out[1]=

Find the nouns in a sentence:

In[1]:=
Click for copyable input
Out[1]=

Find currency amounts and get interpretations:

In[1]:=
Click for copyable input
Out[1]=

Find cities, countries and dates in text:

In[1]:=
Click for copyable input
Out[1]=

Obtain probabilities and interpretations:

In[2]:=
Click for copyable input
Out[2]=

Find all the locations and get their positions:

In[1]:=
Click for copyable input
Out[1]=

Find all references to New York City in a text:

In[1]:=
Click for copyable input
Out[1]=

Scope  (5)

Options  (3)

Applications  (6)

Properties & Relations  (3)

Introduced in 2015
(10.2)
|
Updated in 2019
(12.0)