Initialize Card (Activity) - Revision history

Dgreenwood at 15:50, 13 August 2025

2025-08-13T15:50:28Z

← Older revision		Revision as of 10:50, 13 August 2025
Line 4:		Line 4:

	The '''Initialize Card''' activity is a specialized step in Grooper’s microfiche processing workflow. Its primary purpose is to organize and prepare the raw image tiles from a scanned microfiche card, setting the stage for accurate frame detection and extraction in subsequent activities.		The '''Initialize Card''' activity is a specialized step in Grooper’s microfiche processing workflow. Its primary purpose is to organize and prepare the raw image tiles from a scanned microfiche card, setting the stage for accurate frame detection and extraction in subsequent activities.
			*<li class="attn-bullet"> Grooper's microfiche processing components were developed for and tested using Mekel brand scanners. Please contact support (support@bisok.com) to verify compatibility with other microfiche scanners.
	[[File:Fiche graphic.png\|600px\|right]]		[[File:Fiche graphic.png\|600px\|right]]
	== What is Initialize Card? ==		== What is Initialize Card? ==

Dgreenwood at 15:45, 13 August 2025

2025-08-13T15:45:24Z

← Older revision		Revision as of 10:45, 13 August 2025
Line 47:		Line 47:
	== General configuration steps ==		== General configuration steps ==

	The Initialize Card activity is typically the first ~~step~~ in a microfiche [[Batch Process]]. To use it:		The Initialize Card activity is typically one of the first steps in a microfiche [[Batch Process]]. To use it:

	# Add the Initialize Card (Sort Tiles) activity to your [[Batch Process]].		# Add the Initialize Card (Sort Tiles) activity to your [[Batch Process]].
Line 55:		Line 55:
	# Set the expected "Strip Count" and "Tile Count" to match your fiche card layout.		# Set the expected "Strip Count" and "Tile Count" to match your fiche card layout.
	# Adjust the "Overscan Size" if your tiles include extra image area at the top or bottom of strips.		# Adjust the "Overscan Size" if your tiles include extra image area at the top or bottom of strips.
	~~# Run the [[Batch Process]] on your imported microfiche cards.~~

	== Example workflow ==		== Example workflow ==
Line 68:		Line 67:
	# Fiche scan files are imported into Grooper.		# Fiche scan files are imported into Grooper.
	# '''Initialize Card''' – Organize tiles and create a preview image.		# '''Initialize Card''' – Organize tiles and create a preview image.
	# ~~'''~~Detect Frames~~'''~~ – Detect frame locations on each strip.		# Detect Frames – Detect frame locations on each strip.
	# ~~'''~~Clip Frames~~'''~~ – Extract each frame as a separate page.		# Clip Frames – Extract each frame as a separate page.
	# Additional steps such as image cleanup, OCR, classification, and data extraction.		# Additional steps such as image cleanup, OCR, classification, and data extraction.

Dgreenwood: /* What is Initialize Card? */

2025-08-13T15:34:44Z

What is Initialize Card?

← Older revision		Revision as of 10:34, 13 August 2025
Line 15:		Line 15:
	** Level 3 - The Tiles: Batch Folders in the strip folders form each tile in the strip. The raw image files are attached to each Batch Folder.		** Level 3 - The Tiles: Batch Folders in the strip folders form each tile in the strip. The raw image files are attached to each Batch Folder.
	* Subsequent "[[Detect Frames]]" and "[[Clip Frames]]" steps must be completed to fully isolate page images from the raw image scans for subsequent Grooper processing.		* Subsequent "[[Detect Frames]]" and "[[Clip Frames]]" steps must be completed to fully isolate page images from the raw image scans for subsequent Grooper processing.
			<br clear=all>
	[[File:Fiche Tree.png\|thumb\|left\|Example image file and folder organization in a Batch after Initialize Card runs. Cards are at folder level 1. Strips are at folder level 2. Tiles are at folder level 3.]]		[[File:Fiche Tree.png\|thumb\|left\|Example image file and folder organization in a Batch after Initialize Card runs. Cards are at folder level 1. Strips are at folder level 2. Tiles are at folder level 3.]]

Dgreenwood at 15:34, 13 August 2025

2025-08-13T15:34:25Z

← Older revision		Revision as of 10:34, 13 August 2025
Line 4:		Line 4:

	The '''Initialize Card''' activity is a specialized step in Grooper’s microfiche processing workflow. Its primary purpose is to organize and prepare the raw image tiles from a scanned microfiche card, setting the stage for accurate frame detection and extraction in subsequent activities.		The '''Initialize Card''' activity is a specialized step in Grooper’s microfiche processing workflow. Its primary purpose is to organize and prepare the raw image tiles from a scanned microfiche card, setting the stage for accurate frame detection and extraction in subsequent activities.
			[[File:Fiche graphic.png\|600px\|right]]
	== What is Initialize Card? ==		== What is Initialize Card? ==

Dgreenwood: /* What is Initialize Card? */

2025-08-13T15:33:58Z

What is Initialize Card?

← Older revision		Revision as of 10:33, 13 August 2025
Line 6:		Line 6:

	== What is Initialize Card? ==		== What is Initialize Card? ==
	~~[[File:Fiche graphic.png\|600px\|right]]~~
	'''Initialize Card''' the first processing step applied to a newly imported microfiche card.		'''Initialize Card''' the first processing step applied to a newly imported microfiche card.
	* Microfiche cards are typically scanned as a collection of small, '''overlapping''' image tiles, each representing a portion of the card.		* Microfiche cards are typically scanned as a collection of small, '''overlapping''' image tiles, each representing a portion of the card.
Line 15:		Line 15:
	** Level 3 - The Tiles: Batch Folders in the strip folders form each tile in the strip. The raw image files are attached to each Batch Folder.		** Level 3 - The Tiles: Batch Folders in the strip folders form each tile in the strip. The raw image files are attached to each Batch Folder.
	* Subsequent "[[Detect Frames]]" and "[[Clip Frames]]" steps must be completed to fully isolate page images from the raw image scans for subsequent Grooper processing.		* Subsequent "[[Detect Frames]]" and "[[Clip Frames]]" steps must be completed to fully isolate page images from the raw image scans for subsequent Grooper processing.
	~~<br clear=all>~~
	[[File:Fiche Tree.png\|thumb\|left\|Example image file and folder organization in a Batch after Initialize Card runs. Cards are at folder level 1. Strips are at folder level 2. Tiles are at folder level 3.]]		[[File:Fiche Tree.png\|thumb\|left\|Example image file and folder organization in a Batch after Initialize Card runs. Cards are at folder level 1. Strips are at folder level 2. Tiles are at folder level 3.]]

Dgreenwood: /* How does it work? */

2025-08-13T15:33:39Z

How does it work?

← Older revision		Revision as of 10:33, 13 August 2025
Line 31:		Line 31:

	== How does it work? ==		== How does it work? ==
			[[File:Fische Preview.png\|thumb\|Example preview image generated by Initialize Card (redacted to obscure document data).]]
	The Initialize Card activity performs the following key operations:		The Initialize Card activity performs the following key operations:
	# '''Tile sorting and grouping''':		# '''Tile sorting and grouping''':
Line 37:		Line 37:
	#* Groups tiles into subfolders by strip (row) and tile (column), creating a logical folder structure within the [[Batch Folder]].		#* Groups tiles into subfolders by strip (row) and tile (column), creating a logical folder structure within the [[Batch Folder]].
	#* Validates that the number of detected strips and tiles matches the expected configuration, raising errors if not.		#* Validates that the number of detected strips and tiles matches the expected configuration, raising errors if not.
	# '''Preview image assembly''': ~~[[File:Fische Preview.png\|thumb\|Example preview image generated by Initialize Card (redacted to obscure document data).]]~~		# '''Preview image assembly''':
	#* Combines the sorted tiles to generate a low-resolution preview image of the fiche card.		#* Combines the sorted tiles to generate a low-resolution preview image of the fiche card.
	#* Handles vertical overscan (extra image area at the top or bottom of strips) using the "Overscan Size" property, cropping as needed for a clean preview.		#* Handles vertical overscan (extra image area at the top or bottom of strips) using the "Overscan Size" property, cropping as needed for a clean preview.

Dgreenwood: /* What is Initialize Card? */

2025-08-13T15:32:51Z

What is Initialize Card?

← Older revision		Revision as of 10:32, 13 August 2025
Line 15:		Line 15:
	** Level 3 - The Tiles: Batch Folders in the strip folders form each tile in the strip. The raw image files are attached to each Batch Folder.		** Level 3 - The Tiles: Batch Folders in the strip folders form each tile in the strip. The raw image files are attached to each Batch Folder.
	* Subsequent "[[Detect Frames]]" and "[[Clip Frames]]" steps must be completed to fully isolate page images from the raw image scans for subsequent Grooper processing.		* Subsequent "[[Detect Frames]]" and "[[Clip Frames]]" steps must be completed to fully isolate page images from the raw image scans for subsequent Grooper processing.
			<br clear=all>
	[[File:Fiche Tree.png\|thumb\|left\|Example image file and folder organization in a Batch after Initialize Card runs. Cards are at folder level 1. Strips are at folder level 2. Tiles are at folder level 3.]]		[[File:Fiche Tree.png\|thumb\|left\|Example image file and folder organization in a Batch after Initialize Card runs. Cards are at folder level 1. Strips are at folder level 2. Tiles are at folder level 3.]]

Dgreenwood: /* What is it for? */

2025-08-13T15:32:08Z

What is it for?

← Older revision		Revision as of 10:32, 13 August 2025
Line 18:		Line 18:

	== What is it for? ==		== What is it for? ==
			<div class="flowlist">
	The main goals of the Initialize Card activity are:		The main goals of the Initialize Card activity are:

Line 26:		Line 26:

	This organization is essential for accurate frame detection, extraction, and downstream data processing.		This organization is essential for accurate frame detection, extraction, and downstream data processing.
			</div>
	<br clear=all>		<br clear=all>

Dgreenwood: /* How does it work? */

2025-08-13T15:30:47Z

How does it work?

Dgreenwood: /* How does it work? */

2025-08-13T15:16:23Z

How does it work?

← Older revision		Revision as of 10:16, 13 August 2025
Line 38:		Line 38:
	#* Handles vertical overscan (extra image area at the top or bottom of strips) using the "Overscan Size" property, cropping as needed for a clean preview.		#* Handles vertical overscan (extra image area at the top or bottom of strips) using the "Overscan Size" property, cropping as needed for a clean preview.
	#* Stitches the strip images together, aligning them to minimize visible seams.		#* Stitches the strip images together, aligning them to minimize visible seams.
	#:[[File:Fische Preview.png\|thumb~~\|none~~\|Example preview image generated by Initialize Card (redacted to obscure document data).]]		#:[[File:Fische Preview.png\|thumb\|Example preview image generated by Initialize Card (redacted to obscure document data).]]
	# '''Cleanup and finalization''':		# '''Cleanup and finalization''':
	#* Removes the original "previews" folder after the preview image is created.		#* Removes the original "previews" folder after the preview image is created.

← Older revision		Revision as of 10:30, 13 August 2025
Line 26:		Line 26:

	This organization is essential for accurate frame detection, extraction, and downstream data processing.		This organization is essential for accurate frame detection, extraction, and downstream data processing.

			<br clear=all>

	== How does it work? ==		== How does it work? ==
Line 34:		Line 36:
	#* Groups tiles into subfolders by strip (row) and tile (column), creating a logical folder structure within the [[Batch Folder]].		#* Groups tiles into subfolders by strip (row) and tile (column), creating a logical folder structure within the [[Batch Folder]].
	#* Validates that the number of detected strips and tiles matches the expected configuration, raising errors if not.		#* Validates that the number of detected strips and tiles matches the expected configuration, raising errors if not.
	# '''Preview image assembly''':		# '''Preview image assembly''': [[File:Fische Preview.png\|thumb\|Example preview image generated by Initialize Card (redacted to obscure document data).]]
	#* Combines the sorted tiles to generate a low-resolution preview image of the fiche card.		#* Combines the sorted tiles to generate a low-resolution preview image of the fiche card.
	#* Handles vertical overscan (extra image area at the top or bottom of strips) using the "Overscan Size" property, cropping as needed for a clean preview.		#* Handles vertical overscan (extra image area at the top or bottom of strips) using the "Overscan Size" property, cropping as needed for a clean preview.
	#* Stitches the strip images together, aligning them to minimize visible seams.		#* Stitches the strip images together, aligning them to minimize visible seams.
	~~#:[[File:Fische Preview.png\|thumb\|Example preview image generated by Initialize Card (redacted to obscure document data).]]~~
	# '''Cleanup and finalization''':		# '''Cleanup and finalization''':
	#* Removes the original "previews" folder after the preview image is created.		#* Removes the original "previews" folder after the preview image is created.
	#* Saves the preview image as an attachment to the [[Batch Folder]] for use in review and diagnostics.		#* Saves the preview image as an attachment to the [[Batch Folder]] for use in review and diagnostics.
	~~<br clear=all>~~

	== General configuration steps ==		== General configuration steps ==