This parameter specifies how many results to return, when Eduction finds multiple matches at the same offset (starting position) in the input text. Eduction returns only one result by default, but you can choose to return all of the matches or up to one per entity.
Set this parameter to one of the following values:
All
or True
. Eduction returns all results.OnePerEntity
. Eduction returns up to one result per entity at each offset.No
or False
. Eduction does not return multiple results at the same offset.If you are writing the results of Eduction to document fields in IDX format, and you have allowed multiple results for a single entity by setting this parameter to All
or True
, you should include the relevant fields in the parameter AllowDuplicates.
This parameter can be useful when the same text has multiple interpretations. For example, if the input text contains the word Georgia
, this could refer to a person's name, the U.S. state, or the country. By default, Eduction returns only one match. This is appropriate if it is not important to you that Georgia
has multiple interpretations. Set AllowMultipleResults=All
to return all three matches. Set AllowMultipleResults=OnePerEntity
to return one match from each entity.
The following table shows how the results from Eduction change when you set the parameters AllowMultipleResults
and AllowOverlaps
.
In this example, the input is "The President of the United States of America is in London today to meet the British Prime Minister", and three entities have been defined:
Parameters | AllowOverlaps=False | AllowOverlaps=True |
AllowMultipleResults =False |
Eduction returns the match "President of the United States" (entity1). The match "President" (entity2) is ignored because it shares the same starting point as "President of the United States" and The matches "United States" and "United States of America" (entity3) are ignored because they overlap with "President of the United States" and |
Eduction returns the match "President of the United States" (entity1). The match "President" (entity2) is ignored because it shares the same starting point as "President of the United States" and Overlapping matches are allowed, so Eduction returns a match "United States of America" (entity3). The match "United States" (entity3) is ignored because it shares the same starting point as "United States of America" and |
AllowMultipleResults =OnePerEntity |
Eduction returns the match "President of the United States" (entity1). Eduction returns the match "President" (entity2). Although it shares the same starting point as "President of the United States" it is matched by a different entity and The matches "United States" and "United States of America" (entity3) are ignored because they overlap with "President of the United States" and |
Eduction returns the match "President of the United States" (entity1). Eduction returns the match "President" (entity2). Although it shares the same starting point as "President of the United States" it is matched by a different entity and Overlapping matches are allowed, so Eduction returns a match "United States of America" (entity3). The match "United States" (entity3) is ignored because it shares the same starting point as "United States of America" and |
AllowMultipleResults =True |
Eduction returns the match "President of the United States" (entity1). Eduction returns the match "President" (entity2) because The matches "United States" and "United States of America" (entity3) are ignored because they overlap with "President of the United States" and |
Eduction returns all of the matches. These are "President of the United States" (entity1), "President" (entity2), "United States" (entity3), and "United States of America" (entity3). |
Type: | String |
Default: | No |
Required: | No |
Configuration Section: | Any section that you have defined for Eduction settings |
Example: | AllowMultipleResults=All
|
See Also: |
|