IMAQ Grade DataMatrix Barcode VI

Download PDF

Updated2023-02-21
16 minute(s) read

Owning Palette: Instrument Readers
Requires: NI Vision Development Module

Grades a Data Matrix barcode. You must first prepare this Data Matrix barcode image for grading using the IMAQ Read Data Matrix Barcode 3 VI.

Note Refer to the NI Vision Concepts Help for more information about grading Data Matrix barcodes.

Examples

IMAQ Grade Data Matrix Barcode ISO 16022

Grades a Data Matrix barcode using the Print Quality metrics included in the ISO 16022 specification. You must first prepare this Data Matrix barcode image for grading using the IMAQ Read Data Matrix Barcode 3 VI.

Supported Image Types

8-bit unsigned grayscale 16-bit unsigned grayscale 32-bit RGB 16-bit signed grayscale 64-bit RGB 32-bit HSL

IMAQ Grade Data Matrix Barcode ISO 16022

Image is a reference to the image that contains the Data Matrix code you want to grade. You must first prepare this image for grading using the IMAQ Read Data Matrix Barcode 3 VI.

error in (no error) describes the error status before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.

	status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
	code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
	source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.

Image (duplicate) is the reference to the image that contains the Data Matrix code.

AIM Grading Report is a cluster of information detailing the grading information for the Data Matrix code. If a Data Matrix code can not be located by the IMAQ Read Data Matrix Barcode 3 VI, the VI assigns the Data Matrix code an F for all grades.

	Overall Grade is the overall letter grade, which is equal to the lowest of the other five letter grades.
	Decoding Grade is the letter grade assigned to a Data Matrix code based on the success of the VI in decoding the Data Matrix code. The VI sets this grade to A if the VI could decode the Data Matrix code, otherwise the VI sets this grade to F.
	Symbol Contrast Grade is the letter grade assigned to a Data Matrix code based on the symbol contrast raw score.
	Print Growth Grade is the print growth letter grade for the Data Matrix code.
	Axial Nonuniformity Grade is the axial nonuniformity grade for the Data Matrix code.
	Unused Error Correction Grade is the unused error correction letter grade for the Data Matrix code.

AIM Score Report is a cluster of information detailing the raw AIM scores for the Data Matrix code. If a Data Matrix code could not be located by the IMAQ Read Data Matrix Barcode 3 VI, the VI assigns a zero for all raw scores.

	Symbol Contrast is the symbol contrast raw score representing the percentage difference between the mean of the reflectance of the darkest 10 percent and lightest 10 percent of the Data Matrix code.
	Print Growth is the print growth raw score for the Data Matrix code, which is based on the extent to which dark or light markings appropriately fill their cell boundaries.
	Axial Nonuniformity is the axial nonuniformity raw score for the Data Matrix code, which is based on how much the sampling point spacing differs from one axis to another.
	Unused Error Correction is the unused error correction raw score for the Data Matrix code, which is based on the extent to which regional or spot damage in the Data Matrix code has eroded the reading safety margin provided by the error correction.

error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.

	status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
	code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
	source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.

IMAQ Grade Data Matrix Barcode ISO 15415

Grades a Data Matrix barcode using the Print Quality metrics included in the ISO 15415 specification. You must first prepare this Data Matrix barcode image for grading using the IMAQ Read Data Matrix Barcode 3 VI.

Supported Image Types

8-bit unsigned grayscale 16-bit unsigned grayscale 32-bit RGB 16-bit signed grayscale 64-bit RGB 32-bit HSL

IMAQ Grade Data Matrix Barcode ISO 15415

Image is a reference to the image that contains the Data Matrix code you want to grade. You must first prepare this image for grading using the IMAQ Read Data Matrix Barcode 3 VI.

	status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
	code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
	source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.

Image (duplicate) is the reference to the image that contains the Data Matrix code.

ISO 15415 Grading Report is a cluster of information detailing the grading information for the Data Matrix code.

	Overall Grade is the overall letter grade, which is equal to the lowest of the other five letter grades.
	Decoding Grade is the letter grade assigned to a Data Matrix code based on the success of the VI in decoding the Data Matrix code. The VI sets this grade to A if the VI could decode the Data Matrix code, otherwise the VI sets this grade to F.
	Symbol Contrast Grade is the letter grade assigned to a Data Matrix code based on the symbol contrast raw score.
	Print Growth Grade is the print growth letter grade for the Data Matrix code.
	Axial Nonuniformity Grade is the axial nonuniformity grade for the Data Matrix code.
	Unused Error Correction Grade is the unused error correction letter grade for the Data Matrix code.
	Grid Nonuniformity Grade is the letter grade assigned to a Data Matrix code based on the grid nonuniformity raw score.
	Modulation Grade is the letter grade assigned to a Data Matrix code based on the modulation raw score. Modulation is the measure of the uniformity of reflectance of the dark and light modules in the barcode.
	Fixed Pattern Damage Grade is the letter grade assigned to a Data Matrix code based on the fixed pattern damage. Fixed pattern damage measures the damage in the finder pattern, quiet zone, clock pattern, and solid area segment regions.

ISO 15415 Score Report is a cluster of information detailing the raw AIM scores for the Data Matrix code. If a Data Matrix code could not be located by the IMAQ Read Data Matrix Barcode 3 VI, the VI assigns a zero for all raw scores.

	Symbol Contrast is the symbol contrast raw score representing the percentage difference between the mean of the reflectance of the darkest 10 percent and lightest 10 percent of the Data Matrix code.
	Print Growth is the print growth raw score for the Data Matrix code, which is based on the extent to which dark or light markings appropriately fill their cell boundaries.
	Axial Nonuniformity is the axial nonuniformity raw score for the Data Matrix code, which is based on how much the sampling point spacing differs from one axis to another.
	Unused Error Correction is the unused error correction raw score for the Data Matrix code, which is based on the extent to which regional or spot damage in the Data Matrix code has eroded the reading safety margin provided by the error correction.
	Grid Nonuniformity is the grid nonuniformity raw score for the Data Matrix code, which is the largest vector deviation of the grid intersections, determined by the reference decode algorithm from the binarized image of a given symbol, from their ideal theoretical position.
	Fixed Pattern Damage is the fixed pattern damage raw score for the Data Matrix code, which is the extent of damage in the finder pattern and quiet zone pattern.

	status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
	code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
	source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.

IMAQ Grade Data Matrix Barcode AIM DPM

Grades a Data Matrix barcode using the Print Quality metrics included in the AIM DPM specification. You must first prepare this Data Matrix barcode image for grading using the IMAQ Read Data Matrix Barcode 3 VI.

Supported Image Types

8-bit unsigned grayscale 16-bit unsigned grayscale 32-bit RGB 16-bit signed grayscale 64-bit RGB 32-bit HSL

IMAQ Grade Data Matrix Barcode AIM DPM

Image is a reference to the image that contains the Data Matrix code you want to grade. You must first prepare this image for grading using the IMAQ Read Data Matrix Barcode 3 VI.

	status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
	code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
	source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.

Image (duplicate) is the reference to the image that contains the Data Matrix code.

	Overall Grade is the overall letter grade, which is equal to the lowest of the other five letter grades.
	Decoding Grade is the letter grade assigned to a Data Matrix code based on the success of the VI in decoding the Data Matrix code. The VI sets this grade to A if the VI could decode the Data Matrix code, otherwise the VI sets this grade to F.
	Symbol Contrast Grade is the letter grade assigned to a Data Matrix code based on the symbol contrast raw score.
	Print Growth Grade is the print growth letter grade for the Data Matrix code.
	Axial Nonuniformity Grade is the axial nonuniformity grade for the Data Matrix code.
	Unused Error Correction Grade is the unused error correction letter grade for the Data Matrix code.

	Symbol Contrast is the symbol contrast raw score representing the percentage difference between the mean of the reflectance of the darkest 10 percent and lightest 10 percent of the Data Matrix code.
	Print Growth is the print growth raw score for the Data Matrix code, which is based on the extent to which dark or light markings appropriately fill their cell boundaries.
	Axial Nonuniformity is the axial nonuniformity raw score for the Data Matrix code, which is based on how much the sampling point spacing differs from one axis to another.
	Unused Error Correction is the unused error correction raw score for the Data Matrix code, which is based on the extent to which regional or spot damage in the Data Matrix code has eroded the reading safety margin provided by the error correction.

	status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
	code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code.
	source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.

Examples

Refer to the following for examples that use this VI.

LabVIEW\examples\Vision\Barcodes\Data Matrix Grading AIM DPM 2006.vi

NI Vision for LabVIEW

Table of Contents

IMAQ Grade DataMatrix Barcode VI

IMAQ Grade Data Matrix Barcode ISO 16022

Supported Image Types

IMAQ Grade Data Matrix Barcode ISO 15415

Supported Image Types

IMAQ Grade Data Matrix Barcode AIM DPM

Supported Image Types

Examples

Log in to get a better experience