<< Click to Display Table of Contents > sc_corr_table |
☒ 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
☒ 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
☒ 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
☒ 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: |
Table 374: Correct SamLight
☒ 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