List of abbreviations, specified as a string array, character vector,
cell array of character vectors, or a table.
If Abbreviations
is a string array, character vector, or cell array of character vectors, then the function treats these as regular abbreviations. If the next word is a capitalized sentence starter, then the function breaks at the trailing period. The function ignores any differences in the letter case of the abbreviations. Specify the sentence starters using the Starters
name-value pair.
To specify different behaviors when splitting sentences at abbreviations, specify Abbreviations
as a table. The table must have variables named Abbreviation
and Usage
, where Abbreviation
contains the abbreviations, and Usage
contains the type of each abbreviation. The following table describes the possible values of Usage
, and the behavior of the function when passed abbreviations of these types.
Usage | Behavior | Example Abbreviation | Example Text | Detected Sentences |
---|
regular | If the next word is a capitalized sentence starter, then break
at the trailing period. Otherwise, do not break at the trailing period. | "appt." | "Book an appt. We'll meet then." | "Book an appt."
"We'll meet
then."
|
"Book an appt. today." | "Book an appt. today." |
inner | Do not break after trailing period. | "Dr." | "Dr. Smith." | "Dr. Smith." |
reference | If the next token is not a number, then break at a trailing
period. If the next token is a number, then do not break at the trailing
period. | "fig." | "See fig. 3." | "See fig. 3." |
"Try a fig. They are nice." | "Try a fig."
"They are
nice."
|
unit | If the previous word is a number and the following word is a capitalized
sentence starter, then break at a trailing period. | "in." | "The height is 30 in. The width is 10 in." | "The height is 30 in."
"The
width is 10 in."
|
If the previous word is a number and the following word is not capitalized,
then do not break at a trailing period. | "The item is 10 in. wide." | "The item is 10 in. wide." |
If the previous word is not a number, then break at a trailing
period. | "Come in. Sit down." | "Come in."
"Sit
down."
|
The default value is the output of the abbreviations
function. For Japanese and Korean text, abbreviations do not
usually impact sentence detection.
Tip
By default, the function treats single letter abbreviations, such as "V.", or tokens with mixed single letters and periods, such as "U.S.A." as regular abbreviations. You do not need to include these abbreviations in Abbreviations
.
Example: ["cm" "mm" "in"]
Data Types: char
| string
| table
| cell