<< Click to Display Table of Contents > 

Client Control Interface Manual > Other > sc_corr_table

sc_corr_table
Previous pageReturn to chapter overviewNext page

Correction Mode

Correction Points

2D Fit Type

Correct SamLight

Send Cor Table Values

 

Correction Mode
 

Set

Get

DLL Function

int CCI_Return = ScSetLongValue(int Value_Type, int Parameter)

ASCII Function

int CCI_Return = ScCciSetLongValue(int Value_Type, int Parameter)

Description

Specifies the correction mode of CorrectSamLight

Value_Type

Type: int

ID:

Location: ScComSAMLightClientCtrlValueTypes

scComSAMLightClientCtrlLongValueTypeCorrectionMode

81

Parameter

Type: int

Unit: none

Location: none

scComSAMLightClientCtrlCorrectionModeOld

0

Old algorithm: The grid points of the UCF file will be mapped through a linear interpolation of the 4 enclosing measure points. Finding the enclosing points could fail and lead to single grid point distortions. Postfix: _YYYYMMDDOld.ucf

scComSAMLightClientCtrlCorrectionModeRTS

1

Rotation, Translation, Scale: Rotation, translation and scaling operations are used to minimizes the sum of squared residuals of all calib points. Postfix: _YYYYMMDDRts.ucf

scComSAMLightClientCtrlCorrectionModeIDW

2

Inverse Distance Weighting: The position of each grid point is influenced by the closest x calib points weighted by their inverse distance. The number of influence points can be chosen with CorrectionPoints. This algorithm tends to cause unwanted oscillations. Postfix: _YYYYMMDDIdw#.ucf

scComSAMLightClientCtrlCorrectionMode2dFit

4

2D Fit: Minimizes the sum of squared residuals (distance between the fit and the calibration points). The more points in sc_calib_points.txt, the better is the compensation of measuring errors.

It is possible to try different fit modes and to compare the results in *_fit_log.txt. The fit order can be selected by 2dFitType. Postfix: _YYYYMMDDFit2D#.ucf

CCI_Return

Type: int

CCI return number, see error list.

Notes

 

C# Example: Select Fit2D correction algorithm:

 

int CCI_Return = cci.ScSetLongValue((int)ScComSAMLightClientCtrlValueTypes.scComSAMLightClientCtrlLongValueTypeCorrectionMode, (int) ScComSAMLightClientCtrlValueTypes.scComSAMLightClientCtrlCorrectionMode2dFit);

Table 371: Correction Mode

Correction Points
 

Set

Get

DLL Function,

int CCI_Return = ScSetLongValue(int Value_Type, int Parameter)

ASCII Function

int CCI_Return = ScCciSetLongValue(int Value_Type, int Parameter)

Description

Specifies the number of influence points for each grid point for inverse distance weighting (IDW) mode. A value of '4' seems to lead to good results. IDW mode must be enabled with CorrectionModeIDW.

Value_Type

Type: int

ID:

Location: ScComSAMLightClientCtrlValueTypes

scComSAMLightClientCtrlLongValueTypeCorrectionPoints

82

Parameter

Type: int

Unit: none

0: Disable.

1: Enable.

CCI_Return

Type: int

CCI return number, see error list.

Notes

-

C# Example: Correct points in Fit2D correction algorithm:

 

int CCI_Return = cci.ScSetLongValue((int)ScComSAMLightClientCtrlValueTypes.scComSAMLightClientCtrlLongValueTypeCorrectionPoints, (int) ScComSAMLightClientCtrlValueTypes.scComSAMLightClientCtrlCorrectionMode2dFit);

Table 372: Correction Points

2D Fit Type
 

Set

Get

DLL Function,

int CCI_Return = ScSetLongValue(int Value_Type, int Fit_Mode)

ASCII Function

int CCI_Return = ScCciSetLongValue(int Value_Type, int Fit_Mode)

Description

Selects the 2D fit order to adjust a correction file (*.ucf) by <SCAPS>\system\sc_calib_points.txt. 2D fit algorithm must be enabled with CorrectionMode2dFit. Postfix: _YYYYMMDDFit2D#.ucf.

Value_Type

Type: int

ID:

Location: ScComSAMLightClientCtrlValueTypes

scComSAMLightClientCtrlLongValueType2dFitType

92

Fit_Mode

Type: int

Unit: none

1&2: 2D Fit Basic: Recommended for measurements with big errors. Improved compensation of measurement errors. 1_Basic can only compensate linear (trapezoid) distortions and should not be used for the neutral correction file (cor_neutral.ucf).

3&4: 2D Fit Advanced: Recommended for most scenarios. 3_Advanced is the default mode.

5&6: 2D Fit Expert: Only recommended for precise measurements which means the measurement error is really small.

CCI_Return

Type: int

CCI return number, see error list.

Notes

-

C# Example: Select Fit2D order, for example 3_Advanced:

 

int CCI_Return = cci.ScSetLongValue((int)

ScComSAMLightClientCtrlValueTypes.scComSAMLightClientCtrlLongValueType2dFitType, 3);

Table 373: 2D Fit Type

Correct SamLight
 

Set

Get

DLL Function

int CCI_Return = ScExecCommand(int Cmd_ID)

ASCII Function

int CCI_Return = ScCciExecCommand(int Cmd_ID)

Description

Executes the correction of the currently used correction file with <SCAPS>\system\sc_calib_points.txt. The new correction file is applied in SAMLight and it is saved in the same folder as the previous used one. The correction mode can be chosen with CorrectionMode. An example can be found in the chapter Correct UCF. In sc_corr_table, this function is called 'Correct UCF by calibration points'.

Cmd_ID

Type: int

ID:

Location: ScComSAMLightClientCtrlExecCommandConstants

scComSAMLightClientCtrlExecCommandCorrectSamLight

50

CCI_Return

Type: int

CCI return number, see error list.

Notes

-

C# Example: Execute the correction with <SCAPS>\system\sc_calib_points.txt and apply the new correction file in SAMLight:

 
int CCI_Return = cci.ScExecCommand((int)ScComSAMLightClientCtrlExecCommandConstants.scComSAMLightClientCtrlExecCommandCorrectSamLight);

Table 374: Correct SamLight

Send Cor Table Values
 

Set

Get

DLL Function

int CCI_Return = ScSetDoubleValue(int Value_Type, double Parameter)

ASCII Function

int CCI_Return = ScCciSetDoubleValue(int Value_Type, double Parameter)

Description

Insert new head offset commands during the marking.

Value_Type

Type: int

ID:

Location: ScComSAMLightClientCtrlValueTypes

scComSAMLightClientCtrlDoubleValueTypeSendCorTableValues

65630

Parameter

Type: int

Unit: none

Set the desired values.

CCI_Return

Type: int

CCI return number, see error list.

Notes

 

Table 375: Send Cor Table Values