Labeled Value (Value Extractor) - Revision history

Rpatton: // via Wikitext Extension for VSCode

2025-10-15T16:07:06Z

// via Wikitext Extension for VSCode

← Older revision		Revision as of 11:07, 15 October 2025
Line 16:		Line 16:
	A '''Labeled Value''' in Grooper is a method for extracting data from documents where a specific piece of information (the ''value'') is identified by a nearby descriptive text (the ''label''). This approach is common in forms, invoices, and other semi-structured documents, where fields such as "Invoice Total: $1,234.56" or "Date of Birth: 01/01/2000" appear.		A '''Labeled Value''' in Grooper is a method for extracting data from documents where a specific piece of information (the ''value'') is identified by a nearby descriptive text (the ''label''). This approach is common in forms, invoices, and other semi-structured documents, where fields such as "Invoice Total: $1,234.56" or "Date of Birth: 01/01/2000" appear.

	A '''Label''' is the descriptive text that gives context to the data being extracted (for example, "Invoice Total" or "Date of Birth"). A '''Value''' is the actual data associated with that label (such as "$1,234.56" or "01/01/2000"). Labels ~~are essential because they~~ clarify what the value means, ensuring that extracted data is accurate and meaningful.		A '''Label''' is the descriptive text that gives context to the data being extracted (for example, "Invoice Total" or "Date of Birth"). A '''Value''' is the actual data associated with that label (such as "$1,234.56" or "01/01/2000"). Labels clarify what the value means, ensuring that extracted data is accurate and meaningful.

	We use Labeled Values in Grooper to:		We use Labeled Values in Grooper to:
	* '''Increase accuracy''' by associating data with its context.		* '''Increase accuracy''' by associating data with its context.
	* '''Simplify configuration''' for documents with similar data but different layouts or terminology.		* '''Simplify configuration''' for documents with similar data but different layouts or terminology.
	* '''Speed up onboarding''' of new ~~document types~~ by focusing on label-value relationships.		* '''Speed up onboarding''' of new Document Types by focusing on label-value relationships.

	However, there are some drawbacks:		However, there are some drawbacks:
Line 42:		Line 42:
	You can use the Labeled Value extractor anywhere you can select an Extractor, but this example uses a Data Field.		You can use the Labeled Value extractor anywhere you can select an Extractor, but this example uses a Data Field.

	# In ~~Grooper Design Studio~~, navigate to your Data Model and select the desired Data Field.		# In your Node Tree, navigate to your Data Model and select the desired Data Field.
	# In the Data Field's property grid, find the "Value Extractor" property.		# In the Data Field's property grid, find the "Value Extractor" property.
	# Click the "☰" to the right of the property to access the drop down.		# Click the "☰" to the right of the property to access the drop down.
	# Choose '''Labeled Value''' from the list of available extractors.		# Choose '''Labeled Value''' from the list of available extractors.
			# Expand out the Labeled Value's sub properties.
	# Set the "Label Extractor" property to an extractor to match all possible label variants for your field (e.g., "Invoice Total", "Total Due"). Configure your chosen extractor to collect the labels.		# Set the "Label Extractor" property to an extractor to match all possible label variants for your field (e.g., "Invoice Total", "Total Due"). Configure your chosen extractor to collect the labels.
	#* A [[List Match]] extractor is one of the more common extractors used to extract the labels for a Labeled Value.		#* A [[List Match]] extractor is one of the more common extractors used to extract the labels for a Labeled Value.
Line 58:		Line 59:

	; '''Maximum Distance'''		; '''Maximum Distance'''
	: Sets how far the value can be from the label (in ~~units like~~ inches ~~or millimeters~~). This helps control which values are considered "close enough" to a label to be paired.		: Sets how far the value can be from the label (in inches). This helps control which values are considered "close enough" to a label to be paired.

	; '''Maximum Noise'''		; '''Maximum Noise'''
	: Sets how many unrelated characters are allowed in the region between the label and value. This helps prevent incorrect pairings in cluttered layouts.		: Sets how many unrelated alphanumeric characters are allowed in the region between the label and value. This helps prevent incorrect pairings in cluttered layouts.

	=== Adjusting Maximum Distance and Maximum Noise ===		=== Adjusting Maximum Distance and Maximum Noise ===
Line 68:		Line 69:
	# Expand the Labeled Value extractor's sub properties.		# Expand the Labeled Value extractor's sub properties.
	# Find the "Maximum Distance" property and expand its sub properties.		# Find the "Maximum Distance" property and expand its sub properties.
	#* Edit the values for ~~left~~, ~~top~~, ~~right~~, and ~~bottom~~ distances as needed for your extraction. The number will need to be given in inches (e.g., <code>3in</code> for 3 inches).		#* Edit the values for Left, Top, Right, and Bottom distances as needed for your extraction. The number will need to be given in inches (e.g., <code>3in</code> for 3 inches).
	# Find the "Maximum Noise" property. Edit the maximum number of noise characters allowed as needed for your extraction (e.g., <code>5</code>).		# Find the "Maximum Noise" property. Edit the maximum number of noise characters allowed as needed for your extraction (e.g., <code>5</code>).
	# Save and test extraction. If values are missed or incorrect values are paired with a label, try adjusting these two properties.		# Save and test extraction. If values are missed or incorrect values are paired with a label, try adjusting these two properties further.

	'''Guidance:'''		'''Guidance:'''
Line 84:		Line 85:
	=== What are Label Sets? ===		=== What are Label Sets? ===

	A Label Set is a mapping between Data Elements (such as Data Fields) and the text labels used to identify them on a specific ~~document type~~. Label Sets enable rapid onboarding of new ~~document types~~ by allowing you to define which labels correspond to which fields.		A Label Set is a mapping between Data Elements (such as Data Fields) and the text labels used to identify them on a specific Document Type. Label Sets enable rapid onboarding of new Document Types by allowing you to define which labels correspond to which fields.

	For more information on Label Sets, visit our [[Label Sets]] wiki article.		For more information on Label Sets, visit our [[Label Sets]] wiki article.
Line 96:		Line 97:

	'''Cons:'''		'''Cons:'''
	* Requires multiple Document Types for each label difference.		* Requires multiple Document Types, one for each label difference.
	* Requires initial setup of Label Sets for each Document Type.		* Requires initial setup of Label Sets for each Document Type.
	* Will not work with unstructured documents without labels.		* Will not work with unstructured documents without labels.
Line 113:		Line 114:
	#* Make sure your cursor is inside the Label text box and double click on the label on the document.		#* Make sure your cursor is inside the Label text box and double click on the label on the document.
	#* Make sure your cursor is inside the Label text box, click the Rubberband icon at the top of the Labels panel, and draw a box around the label you want to collect.		#* Make sure your cursor is inside the Label text box, click the Rubberband icon at the top of the Labels panel, and draw a box around the label you want to collect.
	# Repeat for all ~~fields~~ you want to include in the Label Set.		#** The third option is recommended as it avoids missing parts of the label or typos when entering in the information.
			#** If there is an error in your labels, a red thumbs down icon will appear next to the collected label.
			# Repeat for all Data Fields you want to include in the Label Set.
	# Save the Label Set.		# Save the Label Set.
	# Repeat for each document in your Batch.		# Repeat for each document in your Batch.
Line 120:		Line 123:

	=== Step-by-step: Configuring a Data Field to use a Label Set with Labeled Value ===		=== Step-by-step: Configuring a Data Field to use a Label Set with Labeled Value ===

			Once you have your labels collected, you can then configure your Labeled Value the same way as you would any Labeled Value extractor with one difference. You do not have to set a Label Extractor! We already have that covered with our Label Set.

	# Select the Data Field you want to configure.		# Select the Data Field you want to configure.
Line 137:		Line 142:
	'''See Also:'''		'''See Also:'''
	* [[Label Sets]]		* [[Label Sets]]
			* [[Labeling Behavior]]
			* [[Document Type]]
	* [[Data Extraction]]		* [[Data Extraction]]
	* [[Data Context]]		* [[Data Context]]

Rpatton: /* Pros and cons of using Label Sets with Labeled Values */

2025-10-15T15:54:42Z

Pros and cons of using Label Sets with Labeled Values

← Older revision		Revision as of 10:54, 15 October 2025
Line 91:		Line 91:

	'''Pros:'''		'''Pros:'''
	* Centralizes label management for each ~~document type~~.		* Centralizes label management for each Document Type.
	* Makes it easy to update or add new label variants without editing extractors.		* Makes it easy to update or add new label variants without editing extractors.
	* Supports rapid onboarding and template creation.		* Supports rapid onboarding and template creation.

	'''Cons:'''		'''Cons:'''
	* Requires initial setup of Label Sets for each ~~document type~~.		* Requires multiple Document Types for each label difference.
	* ~~May~~ not work ~~for fields~~ without labels ~~or with highly variable layouts~~.		* Requires initial setup of Label Sets for each Document Type.
			* Will not work with unstructured documents without labels.

	=== Step-by-step: Collecting Data Field labels for a Label Set ===		=== Step-by-step: Collecting Data Field labels for a Label Set ===

Rpatton: /* What are Label Sets? */

2025-10-15T15:49:21Z

What are Label Sets?

← Older revision		Revision as of 10:49, 15 October 2025
Line 84:		Line 84:
	=== What are Label Sets? ===		=== What are Label Sets? ===

	A ~~[[Label Sets\|~~Label Set]] is a mapping between Data Elements (such as Data Fields) and the text labels used to identify them on a specific document type. Label Sets enable rapid onboarding of new document types by allowing you to define which labels correspond to which fields.		A Label Set is a mapping between Data Elements (such as Data Fields) and the text labels used to identify them on a specific document type. Label Sets enable rapid onboarding of new document types by allowing you to define which labels correspond to which fields.

			For more information on Label Sets, visit our [[Label Sets]] wiki article.

	=== Pros and cons of using Label Sets with Labeled Values ===		=== Pros and cons of using Label Sets with Labeled Values ===

Rpatton at 15:48, 15 October 2025

2025-10-15T15:48:36Z

← Older revision		Revision as of 10:48, 15 October 2025
Line 3:		Line 3:
	<blockquote>{{#lst:Glossary\|Labeled Value}}</blockquote>		<blockquote>{{#lst:Glossary\|Labeled Value}}</blockquote>

	{\|class="~~wip~~-box"		{\|class="download-box"
	\|		\|
	~~'''WIP'''~~		[[File:Asset 22@4x.png]]
	\|		\|
	~~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~~.		You may download the ZIP(s) below and upload it into your own Grooper environment (version 2025). 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:2025 Wiki Labeled Value Batches.zip]]
	~~This tag will be removed upon draft completion~~.		* [[Media:2025 Wiki Labeled Value Project.zip]]
	\|}		\|}

Rpatton: // via Wikitext Extension for VSCode

2025-10-15T15:12:50Z

// via Wikitext Extension for VSCode

← Older revision		Revision as of 10:12, 15 October 2025
Line 84:		Line 84:
	=== What are Label Sets? ===		=== What are Label Sets? ===

	A [[Label Set]] is a mapping between Data Elements (such as Data Fields) and the text labels used to identify them on a specific document type. Label Sets enable rapid onboarding of new document types by allowing you to define which labels correspond to which fields.		A [[Label Sets\|Label Set]] is a mapping between Data Elements (such as Data Fields) and the text labels used to identify them on a specific document type. Label Sets enable rapid onboarding of new document types by allowing you to define which labels correspond to which fields.

	=== Pros and cons of using Label Sets with Labeled Values ===		=== Pros and cons of using Label Sets with Labeled Values ===
Line 99:		Line 99:
	=== Step-by-step: Collecting Data Field labels for a Label Set ===		=== Step-by-step: Collecting Data Field labels for a Label Set ===

	# In ~~Grooper Design Studio~~, select your Content Type.		Make sure you have a [[Labeling Behavior]] set on your Content Type, otherwise you will not have access to the "Labels" tab.

			# Set the Data Field's Value Extractor property to a Labeled Value.
			# Leave the Label Extractor and Value Extractor for the Labeled Value blank for now.
			# In your Node Tree, select your Content Type.
	# Go to the "Labels" tab (visible if a Labeling Behavior is defined).		# Go to the "Labels" tab (visible if a Labeling Behavior is defined).
	# For each Data Field, ~~highlight~~ the label text on ~~a sample~~ document and ~~assign it~~ to ~~the field~~.		# Make sure each document in your Batch is classified.
			# For each Data Field, use one of three methods to collect the label:
			#* Type in the label text from the document into the Label text box in the Labels panel.
			#* Make sure your cursor is inside the Label text box and double click on the label on the document.
			#* Make sure your cursor is inside the Label text box, click the Rubberband icon at the top of the Labels panel, and draw a box around the label you want to collect.
	# Repeat for all fields you want to include in the Label Set.		# Repeat for all fields you want to include in the Label Set.
	# Save the Label Set.		# Save the Label Set.
			# Repeat for each document in your Batch.

			<div style="position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 1.7777777777777777; padding: 40px 0 40px 0;"><iframe src="https://app.supademo.com/embed/cmgs1s3e1036yx20i25mcdf5n?embed_v=2&utm_source=embed" loading="lazy" title="03 Collecting Labels" allow="clipboard-write" frameborder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>

	=== Step-by-step: Configuring a Data Field to use a Label Set with Labeled Value ===		=== Step-by-step: Configuring a Data Field to use a Label Set with Labeled Value ===

	# Select the Data Field you want to configure.		# Select the Data Field you want to configure.
	# Set the "Extractor" property to '''Labeled Value'''.		# Set the "Value Extractor" property to '''Labeled Value''' if not already set.
			#* This should have previously been set when collecting the labels, but everything in this section can be done before the labels are collected.
	# Leave the "Label Extractor" property blank. This tells Grooper to use the Label Set for label detection.		# Leave the "Label Extractor" property blank. This tells Grooper to use the Label Set for label detection.
	# ~~(Optional) Leave~~ the "Value Extractor" blank if you want to extract all content to the right or below the label~~, or~~ use a ~~static value from the Label Set~~.		# Set a Value Extractor on the Labeled Value to return the type of data you want extracted.
			#* Optionally, you can leave the "Value Extractor" blank if you want to extract all content to the right or below the label. It is recommended to always use a Value Extractor when possible though.
	# Save and test extraction.		# Save and test extraction.

			<div style="position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 1.7777777777777777; padding: 40px 0 40px 0;"><iframe src="https://app.supademo.com/embed/cmgs46sid01jxyh0ig16hwl6s?embed_v=2&utm_source=embed" loading="lazy" title="04 Configuring the Labeled Value" allow="clipboard-write" frameborder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>

	== Labeled Value summary ==		== Labeled Value summary ==

Rpatton: // via Wikitext Extension for VSCode

2025-10-15T13:44:03Z

// via Wikitext Extension for VSCode

← Older revision		Revision as of 08:44, 15 October 2025
Line 65:		Line 65:
	=== Adjusting Maximum Distance and Maximum Noise ===		=== Adjusting Maximum Distance and Maximum Noise ===

	# Select your ~~Data Field and open~~ the Labeled Value extractor's properties.		# Select your object in the Node Tree with the Labeled Value extractor set on it.
	# Find the "Maximum Distance" property. ~~Enter~~ values for left, top, right, and bottom distances (e.g., <code>~~2in~~</code> for ~~right~~).		# Expand the Labeled Value extractor's sub properties.
	# Find the "Maximum Noise" property. ~~Enter~~ the maximum number of noise characters allowed (e.g., <code>5</code>).		# Find the "Maximum Distance" property and expand its sub properties.
	# Save and test extraction. If values are missed~~, increase the distances~~ or ~~noise limit. If~~ incorrect values are paired, ~~decrease them~~.		#* Edit the values for left, top, right, and bottom distances as needed for your extraction. The number will need to be given in inches (e.g., <code>3in</code> for 3 inches).
			# Find the "Maximum Noise" property. Edit the maximum number of noise characters allowed as needed for your extraction (e.g., <code>5</code>).
			# Save and test extraction. If values are missed or incorrect values are paired with a label, try adjusting these two properties.

	'''Guidance:'''		'''Guidance:'''
	* Use smaller distances and lower noise limits for tightly grouped, clean documents.		* Use smaller distances and lower noise limits for tightly grouped, clean documents.
	* Increase these settings for documents with more variation or clutter.		* Increase these settings for documents with more variation or clutter.

			In the example below, we go through several examples of how both the Maximum Distance and Maximum Noise properties can be configured to return values.

	<div style="position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 1.7777777777777777; padding: 40px 0 40px 0;"><iframe src="https://app.supademo.com/embed/cmgqzncq400czyw0ixno5za73?embed_v=2&utm_source=embed" loading="lazy" title="02 Maximum Distance & Maximum Noise" allow="clipboard-write" frameborder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>		<div style="position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 1.7777777777777777; padding: 40px 0 40px 0;"><iframe src="https://app.supademo.com/embed/cmgqzncq400czyw0ixno5za73?embed_v=2&utm_source=embed" loading="lazy" title="02 Maximum Distance & Maximum Noise" allow="clipboard-write" frameborder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>

Rpatton: /* Adjusting Maximum Distance and Maximum Noise */

2025-10-15T13:29:13Z

Adjusting Maximum Distance and Maximum Noise

← Older revision		Revision as of 08:29, 15 October 2025
Line 73:		Line 73:
	* Use smaller distances and lower noise limits for tightly grouped, clean documents.		* Use smaller distances and lower noise limits for tightly grouped, clean documents.
	* Increase these settings for documents with more variation or clutter.		* Increase these settings for documents with more variation or clutter.

			<div style="position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 1.7777777777777777; padding: 40px 0 40px 0;"><iframe src="https://app.supademo.com/embed/cmgqzncq400czyw0ixno5za73?embed_v=2&utm_source=embed" loading="lazy" title="02 Maximum Distance & Maximum Noise" allow="clipboard-write" frameborder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>

	== Labeled Value with Label Sets ==		== Labeled Value with Label Sets ==

Rpatton: /* How to Configure a Labeled Value Extractor */

2025-10-14T16:05:01Z

How to Configure a Labeled Value Extractor

← Older revision		Revision as of 11:05, 14 October 2025
Line 48:		Line 48:
	# Set the "Label Extractor" property to an extractor to match all possible label variants for your field (e.g., "Invoice Total", "Total Due"). Configure your chosen extractor to collect the labels.		# Set the "Label Extractor" property to an extractor to match all possible label variants for your field (e.g., "Invoice Total", "Total Due"). Configure your chosen extractor to collect the labels.
	#* A [[List Match]] extractor is one of the more common extractors used to extract the labels for a Labeled Value.		#* A [[List Match]] extractor is one of the more common extractors used to extract the labels for a Labeled Value.
	# Set the "Value Extractor" property to an extractor to match the expected value format (e.g., a ~~regular expression for currency~~). Configure your chosen extractor to collect the values.		# Set the "Value Extractor" property to an extractor to match the expected value format (e.g., using a [[Pattern Match]] extractor to extract currencies). Configure your chosen extractor to collect the values.
	# Save your changes and test extraction on sample documents.		# Save your changes and test extraction on sample documents.

Rpatton: /* How they work */

2025-10-14T16:04:12Z

How they work

← Older revision		Revision as of 11:04, 14 October 2025
Line 27:		Line 27:
	* Complex layouts or noisy documents may require additional configuration.		* Complex layouts or noisy documents may require additional configuration.

	== How ~~they work~~ ==		== How to ==

	Labeled Values work by pairing a label with its corresponding value based on their spatial relationship in the document. The [[Labeled Value]] extractor identifies candidate labels and values, then determines which pairs belong together by analyzing their proximity and layout.		Labeled Values work by pairing a label with its corresponding value based on their spatial relationship in the document. The [[Labeled Value]] extractor identifies candidate labels and values, then determines which pairs belong together by analyzing their proximity and layout.
Line 38:		Line 38:
	* Automated classification and data validation		* Automated classification and data validation

	=== ~~Step-by-step: Using the~~ Labeled Value ~~extractor in a Data Field~~ ===		=== How to Configure a Labeled Value Extractor ===

	You can use the Labeled Value extractor anywhere you can select an Extractor, but this example uses a Data Field.		You can use the Labeled Value extractor anywhere you can select an Extractor, but this example uses a Data Field.

	# In Grooper Design Studio, navigate to your Data Model and select the desired Data Field.		# In Grooper Design Studio, navigate to your Data Model and select the desired Data Field.
	# In the Data Field's ~~properties~~, find the "Extractor" property.		# In the Data Field's property grid, find the "Value Extractor" property.
	# Click the ~~ellipsis (...)~~ to ~~open~~ the ~~Extractor selection dialog~~.		# Click the "☰" to the right of the property to access the drop down.
	# Choose '''Labeled Value''' from the list of available extractors.		# Choose '''Labeled Value''' from the list of available extractors.
	# ~~Configure~~ the "Label Extractor" property to match all possible label variants for your field (e.g., "Invoice Total", "Total Due").		# Set the "Label Extractor" property to an extractor to match all possible label variants for your field (e.g., "Invoice Total", "Total Due"). Configure your chosen extractor to collect the labels.
	# ~~Configure~~ the "Value Extractor" property to match the expected value format (e.g., a regular expression for currency).		#* A [[List Match]] extractor is one of the more common extractors used to extract the labels for a Labeled Value.
	~~# (Optional) Adjust~~ the ~~"Footer Extractor" if your value is delimited by a footer label~~.		# Set the "Value Extractor" property to an extractor to match the expected value format (e.g., a regular expression for currency). Configure your chosen extractor to collect the values.
	# Save your changes and test extraction on sample documents.		# Save your changes and test extraction on sample documents.

			<div style="position: relative; box-sizing: content-box; max-height: 80vh; max-height: 80svh; width: 100%; aspect-ratio: 1.7777777777777777; padding: 40px 0 40px 0;"><iframe src="https://app.supademo.com/embed/cmgjf24km00ddx00iqw8rywzw?embed_v=2&utm_source=embed" loading="lazy" title="01 Configuring a Labeled Value Extractor" allow="clipboard-write" frameborder="0" webkitallowfullscreen="true" mozallowfullscreen="true" allowfullscreen style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"></iframe></div>

	== Advanced options ==		== Advanced options ==

Rpatton: // via Wikitext Extension for VSCode

2025-10-08T18:39:11Z

// via Wikitext Extension for VSCode

← Older revision		Revision as of 13:39, 8 October 2025
Line 1:		Line 1:
	{{~~Migrated~~}}		{{AutoVersion}}
	{{~~2023~~:~~{{PAGENAME}~~}}}
			<blockquote>{{#lst:Glossary\|Labeled Value}}</blockquote>

			{\|class="wip-box"
			\|
			'''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.
			\|}

			== Introduction ==

			A '''Labeled Value''' in Grooper is a method for extracting data from documents where a specific piece of information (the ''value'') is identified by a nearby descriptive text (the ''label''). This approach is common in forms, invoices, and other semi-structured documents, where fields such as "Invoice Total: $1,234.56" or "Date of Birth: 01/01/2000" appear.

			A '''Label''' is the descriptive text that gives context to the data being extracted (for example, "Invoice Total" or "Date of Birth"). A '''Value''' is the actual data associated with that label (such as "$1,234.56" or "01/01/2000"). Labels are essential because they clarify what the value means, ensuring that extracted data is accurate and meaningful.

			We use Labeled Values in Grooper to:
			* '''Increase accuracy''' by associating data with its context.
			* '''Simplify configuration''' for documents with similar data but different layouts or terminology.
			* '''Speed up onboarding''' of new document types by focusing on label-value relationships.

			However, there are some drawbacks:
			* Labeled Value extraction may not work well if labels are missing or inconsistent.
			* Complex layouts or noisy documents may require additional configuration.

			== How they work ==

			Labeled Values work by pairing a label with its corresponding value based on their spatial relationship in the document. The [[Labeled Value]] extractor identifies candidate labels and values, then determines which pairs belong together by analyzing their proximity and layout.

			For example, in a Data Field for "Invoice Total", the extractor can be configured to recognize label variants like "Invoice Amount", "Total Due", or "Amount Owed", and match them with the correct value (such as a currency amount).

			Labeled Values are used in many contexts within Grooper, including:
			* Data Fields in a Data Model (e.g., extracting patient names, dates, or totals)
			* Batch Processes that require field-level data extraction
			* Automated classification and data validation

			=== Step-by-step: Using the Labeled Value extractor in a Data Field ===

			You can use the Labeled Value extractor anywhere you can select an Extractor, but this example uses a Data Field.

			# In Grooper Design Studio, navigate to your Data Model and select the desired Data Field.
			# In the Data Field's properties, find the "Extractor" property.
			# Click the ellipsis (...) to open the Extractor selection dialog.
			# Choose '''Labeled Value''' from the list of available extractors.
			# Configure the "Label Extractor" property to match all possible label variants for your field (e.g., "Invoice Total", "Total Due").
			# Configure the "Value Extractor" property to match the expected value format (e.g., a regular expression for currency).
			# (Optional) Adjust the "Footer Extractor" if your value is delimited by a footer label.
			# Save your changes and test extraction on sample documents.

			== Advanced options ==

			The Labeled Value extractor includes advanced properties to fine-tune extraction:

			; '''Maximum Distance'''
			: Sets how far the value can be from the label (in units like inches or millimeters). This helps control which values are considered "close enough" to a label to be paired.

			; '''Maximum Noise'''
			: Sets how many unrelated characters are allowed in the region between the label and value. This helps prevent incorrect pairings in cluttered layouts.

			=== Adjusting Maximum Distance and Maximum Noise ===

			# Select your Data Field and open the Labeled Value extractor's properties.
			# Find the "Maximum Distance" property. Enter values for left, top, right, and bottom distances (e.g., <code>2in</code> for right).
			# Find the "Maximum Noise" property. Enter the maximum number of noise characters allowed (e.g., <code>5</code>).
			# Save and test extraction. If values are missed, increase the distances or noise limit. If incorrect values are paired, decrease them.

			'''Guidance:'''
			* Use smaller distances and lower noise limits for tightly grouped, clean documents.
			* Increase these settings for documents with more variation or clutter.

			== Labeled Value with Label Sets ==

			=== What are Label Sets? ===

			A [[Label Set]] is a mapping between Data Elements (such as Data Fields) and the text labels used to identify them on a specific document type. Label Sets enable rapid onboarding of new document types by allowing you to define which labels correspond to which fields.

			=== Pros and cons of using Label Sets with Labeled Values ===

			'''Pros:'''
			* Centralizes label management for each document type.
			* Makes it easy to update or add new label variants without editing extractors.
			* Supports rapid onboarding and template creation.

			'''Cons:'''
			* Requires initial setup of Label Sets for each document type.
			* May not work for fields without labels or with highly variable layouts.

			=== Step-by-step: Collecting Data Field labels for a Label Set ===

			# In Grooper Design Studio, select your Content Type.
			# Go to the "Labels" tab (visible if a Labeling Behavior is defined).
			# For each Data Field, highlight the label text on a sample document and assign it to the field.
			# Repeat for all fields you want to include in the Label Set.
			# Save the Label Set.

			=== Step-by-step: Configuring a Data Field to use a Label Set with Labeled Value ===

			# Select the Data Field you want to configure.
			# Set the "Extractor" property to '''Labeled Value'''.
			# Leave the "Label Extractor" property blank. This tells Grooper to use the Label Set for label detection.
			# (Optional) Leave the "Value Extractor" blank if you want to extract all content to the right or below the label, or use a static value from the Label Set.
			# Save and test extraction.

			== Labeled Value summary ==

			Labeled Values in Grooper provide a powerful way to extract data by associating labels with their corresponding values. They are flexible, support advanced options for handling complex layouts, and integrate seamlessly with Label Sets for rapid onboarding and template management.

			'''See Also:'''
			* [[Label Sets]]
			* [[Data Extraction]]
			* [[Data Context]]