JoeScan

Calibration Parameters

A calibration fixture is a physical object that you use as a reference point for the scanners' coordinate system. You use these parameters to tell JSDiag the location of the features that make up this object. The available features are CircleFeature's, SquareFeature's, and LineFeature's. A calibration fixture can be made up of many features of only one type, i.e. a lot of CircleFeature's with no SquareFeature's or LineFeature's.

You can put many different CalibFixture's in a single parameter file. A single ScannerConfig can have many different CalibFixture names listed with it's CalibrationFixtureNames parameter.

How to Define a Calibration Fixture in the Parameter Editor

  1. Define calibration fixtures with CalibFixture blocks that contain CircleFeature's, SquareFeature's, or LineFeature's.

  2. Use the CalibrationFixtureNames parameter in a ScannerConfig block to tell the scanners which calibration fixtures to use.

CalibFixture

Value Format:

CalibFixture YourFixtureNameHere
{
    YourFeaturesHere
}

Location:outside a ScannerConfig block

There can be multiple CalibFixture blocks in a single parameter file, each one with a different name.

Calibration fixtures are declared in the same parameter file as the ScannerConfig's. All the features must be the same type within a calibration fixture.

CalibrationFixtureNames

Value Format:comma-separated list of names
Default Value:no calibration fixtures
Location:inside a ScannerConfig block

Goes in a ScannerConfig to tell those scanners to use the listed calibration fixtures in the Calibration Editor.

CircleFeature

Value Format:Radius CenterX CenterY
Units:inches/millimeters
Location:inside a CalibFixture block

The first number is the radius of the circle. The last two numbers are the x-y coordinates of the center of the circle. The radius must be greater than zero. It's easiest to calibrate against if the fixture is asymmetrical -- there's only one way to get it right. They cannot be mixed with SquareFeature's or LineFeature's.

#A sample CalibFixture with a few circles in it
CalibFixture SomeCircles
{
	#             Radius  CenterX  CenterY
	CircleFeature  1.0     -2.0     -3.0    #Radius is 1.0 Centered at the coordinates (-2.0", -3.0")
	CircleFeature  1.0      2.0      3.0    #Radius is 1.0 Centered at the coordinates ( 2.0",  3.0")
	CircleFeature  3.0      2.0     -1.0    #Radius is 3.0 Centered at the coordinates ( 2.0",  1.0")
}

SquareFeature

Value Format:LeftX BottomY Width Height
Units:inches/millimeters
Location:inside a CalibFixture block

The first two numbers are the x-y coordinates of the lower-left corner. The third number is the width of the square, and the fourth number is the height of the square. The width and height must be greater than zero. They cannot be mixed with CircleFeature's or LineFeature's.

#A sample CalibFixture with a few squares in it
CalibFixture SomeSquares
{
	#             LeftX  BottomY  Width  Height
	SquareFeature  0.0    -1.0     1.0    2.0    #Bottom-Left corner at (0.0", 0.0"), 1.0" wide and 2.0" tall
	SquareFeature  1.0     2.0     3.0    4.0    #Bottom-Left corner at (1.0", 2.0"), 3.0" wide and 4.0" tall
}

LineFeature

Value Format:X1 Y1 X2 Y2
Units:inches/millimeters
Location:inside a CalibFixture block

The first two numbers are the x-y coordinates of the beginning of the line and the last two numbers are the x-y coordinates of the end of the line. They cannot be mixed with CircleFeature's or SquareFeature's.

#A sample CalibFixture with a few lines in it
CalibFixture SomeLines
{
	#            FirstX  FirstY  SecondX  SecondY
	LineFeature   0.0     0.0      1.0      1.0    #A line from (0.0", 0.0") to (1.0", 1.0")
	LineFeature   1.0     1.0      2.0      0.0    #A line from (1.0", 1.0") to (2.0", 0.0")
	LineFeature   2.0     0.0      3.0      3.0    #A line from (2.0", 0.0") to (3.0", 3.0")
}