2023:Collation Provider (Property) - Revision history

Dgreenwood at 16:18, 5 February 2026

2026-02-05T16:18:41Z

← Older revision		Revision as of 11:18, 5 February 2026
Line 1:		Line 1:
	{{AutoVersion}}		{{AutoVersion}}

	~~{{stubs}}~~

	<blockquote>{{#lst:Glossary\|Collation Provider}}</blockquote>		<blockquote>{{#lst:Glossary\|Collation Provider}}</blockquote>

Dgreenwood at 21:34, 12 May 2025

2025-05-12T21:34:48Z

@@ Line 28: / Line 28: @@
 * [[Media:2023.1_Wiki_Collation-Provider_Project.zip]]
 |}
 == About ==

Randallkinard at 17:29, 3 May 2024

2024-05-03T17:29:28Z

@@ Line 28: / Line 28: @@
 * [[Media:2023.1_Wiki_Collation-Provider_Project.zip]]
 |}
 == About ==

Randallkinard at 16:05, 22 April 2024

2024-04-22T16:05:42Z

Show changes

Randallkinard: Randallkinard moved page 2023:Collation Provider to 2023:Collation Provider (Property) without leaving a redirect: new naming convention

2024-04-18T19:38:55Z

Randallkinard moved page 2023:Collation Provider to 2023:Collation Provider (Property) without leaving a redirect: new naming convention

← Older revision	Revision as of 14:38, 18 April 2024
(No difference)

Dsmith at 18:25, 12 March 2024

2024-03-12T18:25:47Z

← Older revision		Revision as of 13:25, 12 March 2024
Line 21:		Line 21:
	* Multi-Column		* Multi-Column

			<br>
			<br>
			{\|class="download-box"
			\|
			[[File:Asset 22@4x.png]]
			\|
			You may download the ZIP(s) below and upload it into your own Grooper environment (version 2023.1). The first contains one or more '''Batches''' of sample documents. The second contains one or more '''Projects''' with resources used in examples throughout this article.
			* [[Media:2023.1_Wiki_Collation-Provider_Batch.zip]]
			* [[Media:2023.1_Wiki_Collation-Provider_Project.zip]]
			\|}
	== About ==		== About ==

Dgreenwood at 18:12, 9 January 2024

2024-01-09T18:12:15Z

← Older revision		Revision as of 13:12, 9 January 2024
Line 1:		Line 1:
	{{AutoVersion}}		{{AutoVersion}}
	{{stubs}}		{{stubs}}
	<section begin="~~collation_provider_glossary~~" />		<section begin="glossary" />
	<blockquote>		<blockquote>
	'''''Collation Providers''''' allow '''[[Data Type]]''' extractor results to be combined, organized, or utilized in specific ways.		'''''Collation Providers''''' allow '''[[Data Type]]''' extractor results to be combined, organized, or utilized in specific ways.
	</blockquote>		</blockquote>
	<section end="~~collation_provider_glossary~~" />		<section end="glossary" />
	Results can be combined, organized into arrays, returned as a key-value pair's value, and more.		Results can be combined, organized into arrays, returned as a key-value pair's value, and more.

Dgreenwood at 20:35, 4 January 2024

2024-01-04T20:35:08Z

← Older revision		Revision as of 15:35, 4 January 2024
Line 1:		Line 1:
			{{AutoVersion}}
	{{stubs}}		{{stubs}}
	~~{{AutoVersion}}~~		<section begin="collation_provider_glossary" />
	<~~blockquote style~~="~~font-size:14pt~~">		<blockquote>
	'''''Collation Providers''''' allow '''[[Data Type]]''' extractor results to be combined, organized, or utilized in specific ways.		'''''Collation Providers''''' allow '''[[Data Type]]''' extractor results to be combined, organized, or utilized in specific ways.
	</blockquote>		</blockquote>
			<section end="collation_provider_glossary" />
	Results can be combined, organized into arrays, returned as a key-value pair's value, and more.		Results can be combined, organized into arrays, returned as a key-value pair's value, and more.

Dgreenwood at 22:58, 3 January 2024

2024-01-03T22:58:30Z

Dgreenwood at 18:58, 28 December 2023

2023-12-28T18:58:48Z

← Older revision		Revision as of 13:58, 28 December 2023
Line 1:		Line 1:
	{~~\|cellpadding=10 cellspacing=5 style="margin:12px"~~		{{stubs}}
	~~\|-style="background-color:#ed2330; color:white"~~		{{AutoVersion}}
	~~\|style="font-size:14pt"\|'''WIP'''~~
	\|
	~~This article is a work-in-progress or created as a placeholder for testing purposes. This article is subject to change and/or expansion. It may be incomplete, inaccurate, or stop abruptly.~~

	~~This tag will be removed upon draft completion.~~
	\|}

	~~<onlyinclude>~~
	<blockquote style="font-size:14pt">		<blockquote style="font-size:14pt">
	'''''Collation Providers''''' allow '''[[Data Type]]''' extractor results to be combined, organized, or utilized in specific ways.		'''''Collation Providers''''' allow '''[[Data Type]]''' extractor results to be combined, organized, or utilized in specific ways.
Line 27:		Line 19:
	* Pattern-Based		* Pattern-Based
	* Multi-Column		* Multi-Column
	~~</onlyinclude>~~

	== About ==		== About ==
Line 127:		Line 118:

	Previously, the collated result would always take the average of the individual results's confidence scores. The '''''Confidence Mode''''' property allows you to choose ''Average'' to take the average confidence score of the individual results, ''Min'' to take the smallest confidence score of all the individual results, or ''Max'' to take the largest confidence score.		Previously, the collated result would always take the average of the individual results's confidence scores. The '''''Confidence Mode''''' property allows you to choose ''Average'' to take the average confidence score of the individual results, ''Min'' to take the smallest confidence score of all the individual results, or ''Max'' to take the largest confidence score.

	~~[[Category:Articles]]~~
	~~[[Category:Stub]]~~

← Older revision		Revision as of 17:58, 3 January 2024
Line 26:		Line 26:
	Often, this requires something more complex than returning a single result. The relationships between multiple extraction results are often important. The fact results are physically related to each other on the page, or text exists between one or more results, or results are in one order versus another can be used accomplish various goals in Grooper.		Often, this requires something more complex than returning a single result. The relationships between multiple extraction results are often important. The fact results are physically related to each other on the page, or text exists between one or more results, or results are in one order versus another can be used accomplish various goals in Grooper.

	For example, the ''Individual'', ''Array'', and ''Ordered Array'' Collation Providers all collate results differently.		For example, the '''''Individual''''', '''''Array''''', and '''''Ordered Array''''' Collation Providers all collate results differently.

	=== Individual, Array, and Ordered Array ===		=== Individual, Array, and Ordered Array ===
Line 54:		Line 54:
	=== Array ===		=== Array ===

	The ''Array'' ~~Collation Provider~~ organizes and returns results much differently.		The '''''Array''''' provider organizes and returns results much differently.
	* First, it will only return results if multiple extraction results are lined up in a particular order on the page, according to the "layout" set for this provider. For example, an ''Array'' collated extractor using a '''''Horizontal Layout''''' will only return results if they are aligned horizontally, one result after another from left to right.		* First, it will only return results if multiple extraction results are lined up in a particular order on the page, according to the "layout" set for this provider. For example, an '''''Array''''' collated extractor using a '''''Horizontal Layout''''' will only return results if they are aligned horizontally, one result after another from left to right.
	* Second, instead of each result being returned individually, all results meeting the layout requirements are returned as a single value.		* Second, instead of each result being returned individually, all results meeting the layout requirements are returned as a single value.

	Essentially, an ''Array'' collated result is a collection of results who share a layout relationship, that are all lined up together (either horizontally, vertically, or in the left/right and top/bottom text flow of the document).		Essentially, an '''''Array''''' collated result is a collection of results who share a layout relationship, that are all lined up together (either horizontally, vertically, or in the left/right and top/bottom text flow of the document).

	{\|cellpadding=10 cellspacing=5		{\|cellpadding=10 cellspacing=5
	\|style="width:40%" valign=top\|		\|style="width:40%" valign=top\|
	# This '''Data Type''' extractor has the exact same child extractors, but uses the ''Array'' ~~Collation Provider~~ instead of ''Individual''.		# This '''Data Type''' extractor has the exact same child extractors, but uses the '''''Array''''' provider instead of ''Individual''.
	# The parent '''Data Type's''' '''''Collation''''' property is set to ''Array''.		# The parent '''Data Type's''' '''''Collation''''' property is set to ''Array''.
	# The '''''Minimum Elements''''' property defaults to ''2''.		# The '''''Minimum Elements''''' property defaults to ''2''.
Line 77:		Line 77:
	=== Ordered Array ===		=== Ordered Array ===

	The ''Ordered Array'' ~~Collation Provider~~ is similar to the ''Array'' provider, but it is much more restrictive about how allowable results can be organized. ''Only'' arrays whose extracted elements are in the listed order of the children extractors are returned.		The ''''Ordered Array''''' provider is similar to the '''''Array''''' provider, but it is much more restrictive about how allowable results can be organized. ''Only'' arrays whose extracted elements are in the listed order of the children extractors are returned.

	{\|cellpadding=10 cellspacing=5		{\|cellpadding=10 cellspacing=5
	\|style="width:40%" valign=top\|		\|style="width:40%" valign=top\|
	# This '''Data Type''' extractor has the exact same child extractors, but uses the ''Ordered Array'' ~~Collation Provider~~.		# This '''Data Type''' extractor has the exact same child extractors, but uses the '''''Ordered Array''''' provider.
	#* Notice the order of each child extractor. First "Name" then "Date" then "City/State" then "Number of Days" and last, "Party"		#* Notice the order of each child extractor. First "Name" then "Date" then "City/State" then "Number of Days" and last, "Party"
	# The parent '''Data Type's''' '''''Collation''''' property is set to ''Ordered Array''.		# The parent '''Data Type's''' '''''Collation''''' property is set to ''Ordered Array''.
	# The '''''Horizontal Layout''''' is set to ''Enabled'', just like our example of the ''Array'' ~~Collation Provider~~.		# The '''''Horizontal Layout''''' is set to ''Enabled'', just like our example of the '''''Array''''' provider.
	# Notice several arrays were tossed out of our "Results" list.		# Notice several arrays were tossed out of our "Results" list.
	#* The second table has the "Days in Office" column ''before'' the "Birthplace". When it came time to finding that array, all the elements are there, but they are not in the order of the child elements in the Node Tree. The "Number of Days" extractor comes ''after'' the "City/State" extractor.		#* The second table has the "Days in Office" column ''before'' the "Birthplace". When it came time to finding that array, all the elements are there, but they are not in the order of the child elements in the Node Tree. The "Number of Days" extractor comes ''after'' the "City/State" extractor.
Line 109:		Line 109:
	=== The AND Collation Provider ===		=== The AND Collation Provider ===

	The ''AND'' Collation Provider is a brand new provider in version 2.90. Aspects of this collation could have been approximated using the ''Combine'' or ''Array'' providers, in some cases. However, it's functionality is unique and distinct from these two Collation Providers.		The '''''AND'''' '''''Collation Provider''''' is a brand new provider in version 2.90. Aspects of this collation could have been approximated using the '''''Combine''''' or '''''Array''''' providers, in some cases. However, it's functionality is unique and distinct from these two '''''Collation Providers'''''.

	=== Confidence Mode ===		=== Confidence Mode ===

	The '''''Confidence Mode''''' property is new to the ''Combine'', ''AND'', ''Array'', ''Ordered Array'', ''Key-Value Pair'' and ''Key-Value List'' Collation Providers in version 2.90. Each of these providers orders and/or combines multiple extraction results in various ways. If any of results are matched using ''FuzzyRegEx'', the overall confidence score of the collated result must be determined, in some way, based on the confidence of each individual result.		The '''''Confidence Mode''''' property is new to the '''''Combine''''', '''''AND''''', '''''Array''''', '''''Ordered Array''''', '''''Key-Value Pair''''' and '''''Key-Value List''''' Collation Providers in version 2.90. Each of these providers orders and/or combines multiple extraction results in various ways. If any of results are matched using ''FuzzyRegEx'', the overall confidence score of the collated result must be determined, in some way, based on the confidence of each individual result.

	For example, an ''Array'' may have three results as its elements. Result 1 may have a confidence score of 100%. Result 2 may have a confidence score of 90%. Result 3 may have a confidence score of 80%. So, what is the confidence of the collated array? Is it 100%? Is it 80%? Is it an average of the three scores (90%)?		For example, an '''''Array''''' may have three results as its elements. Result 1 may have a confidence score of 100%. Result 2 may have a confidence score of 90%. Result 3 may have a confidence score of 80%. So, what is the confidence of the collated array? Is it 100%? Is it 80%? Is it an average of the three scores (90%)?

	Previously, the collated result would always take the average of the individual results's confidence scores. The '''''Confidence Mode''''' property allows you to choose ''Average'' to take the average confidence score of the individual results, ''Min'' to take the smallest confidence score of all the individual results, or ''Max'' to take the largest confidence score.		Previously, the collated result would always take the average of the individual results's confidence scores. The '''''Confidence Mode''''' property allows you to choose ''Average'' to take the average confidence score of the individual results, ''Min'' to take the smallest confidence score of all the individual results, or ''Max'' to take the largest confidence score.