:Revision=1
:html
<<
128.138
Calibration-Object|Calibration
--
The <!RW>Calibration IP object gives access to the calibvration data of the software calibration system.

The separate calibratable subsystems are addressed by their name  (e.g. 'ME3000' for the Meilhaus ME3000 card). Single calibration values are addressed by a subname and a channel number. The allowed names and num,bers differ from subsystem to subsystem.
>>

<<
128.138.1
Functions of the Calibration-Object|Functions
--
>>

<<
128.138.1.1
Calibration.Get|Get
--
<!DEF>
function <!TW>Calibration.Get (sDevice, sValueName : string; rChannel : real) : real;
<!TXT>
Gets a calibration value.

 <!PW>sDevice is the name of the subsystem
 <!PW>sValueName is the name of the calibration value
 <!PW>rChannel is the channel number

Example:
<!CODE>
rOffset:=Calibration.Get ('ME3000', 'ADC.Offset', 1);
<!TXT>
Result: The offset of ADC channel 1 of the ME3000 card.

Attention: If the combination of <!PW>sDevice, <!PW>sValueName and <!PW>rChannel doesn't address a valid calibration value, a runtime error will be raised.
>>

<<
128.138.2
Procedures of the Calibration-Object|Procedures
--
>>

<<
128.138.2.1
Calibration.Set|Set
--
<!DEF>
procedure <!TW>Calibration.Set (sDevice, sValueName : string; rChannel, rValue : real);
<!TXT>
Sets a calibration value.

 <!PW>sDevice is the name of the subsystemSystems an
 <!PW>sValueName is the name of the calibration value
 <!PW>rChannel is the channel number
 <!PW>rValue is the new value to be set

Example:
<!CODE>
Calibration.Set ('ME3000', 'ADC.Offset', 1, 0);
<!TXT>
Result: Will set the Offset of the ADC Channel 1 of the ME3000 card to 0 volts.

Attention: If the combination of <!PW>sDevice, <!PW>sValueName and <!PW>rChannel doesn't address a valid calibration value, a runtime error will be raised.
>>

<<
128.138.2.2
Calibration.Save|Save
--
<!DEF>
procedure <!TW>Calibration.Save (sFileName : string [; sDevice : string]);
<!TXT>
Saves the calibration data to a file.

 <!PW>sFileName is the name of the file. It may begin with a path template. If the parameter is empty (''), the value defined in  the basic setup will be used.

If <!PW>sDevice is given and not empty, only the data of this subsystem will be saved. Is <!PW>sDevice not given or emtpy, all subsystems will be saved.

Attention: May change values of the basic setup!
>>

<<
128.138.2.3
Calibration.Load|Load
--
<!DEF>
procedure <!TW>Calibration.Load (sFileName : string [; sDevice : string]);
<!TXT>
Loads calibration values from a file.

 <!PW>sFileName is the name of the file. It may begin with a path template. If the parameter is empty (''), the value defined in  the basic setup will be used.

If <!PW>sDevice is given and not empty, only the data of this subsystem will be loaded. Is <!PW>sDevice not given or emtpy, all subsystems will be loaded.
>>

<<
128.138.2.4
Calibration.Off|Off
--
<!DEF>
procedure <!TW>Calibration.Off (sDevice : string);
<!TXT>
Resets all calibration values to their default value.

If <!PW>sDevice is given and not empty, only the data of this subsystem will be reset. Is <!PW>sDevice not given or emtpy, all subsystems will be reset.

Attention: The old values are lost, if not saved.
>>
