The channel.params file tells the API which channels to retrieve from the archive file. It is required for all Kvis versions 1.0 and later and is not used in all earlier versions. The file consists of a series of telemetry channels and parameters for each channel. Example lines are given below. The columns are:
Type name
Full channel name Must match name in archive file
Required 1 = required, 0 = optional
Default value if optional (character string)
Trigger channel 1 = yes, 0 = no
Raw trigger channel 1 = yes, 0 = no
Bin size For Rawdata channels only
Latency in seconds, mainly for enum channels
All required channels must be present within the latency time given for a data sample to be returned. Optional channels will return the default value if data is not present in the archive file at the given time. The trigger channel is the channel used by the API to set the data sample times. The Rawdata type is a specific format for returning fringe tracker data that must be specially treated by the API. Based on the fringe tracker telemetry channels given in the file, Kvis will make the appropriate function calls for the real time system version.
Example lines:
FT_ServoMode FringeTracker[0].ServoMode 1 0 0 0 0 5 FT_TrackMode FringeTracker[0].CompleteControllerSet.TrackModeUpdate.TrackMode 1 0 0 0 0 5 FT_OperatingMode FringeTracker[0].OperatingMode 1 0 0 0 0 5 FT_CalibrationTag FringeTracker[0].CalibrationTag 1 0 0 0 0 5 Seq_StarId Seq[0].StarId 1 none 0 0 0 -1 Raw00 FringeTracker[0].CompleteControllerSet.ControllerData.RawData[0][0] 1 0 0 0 5 -1 Raw10 FringeTracker[0].CompleteControllerSet.ControllerData.RawData[1][0] 1 0 0 0 5 -1 Raw11 FringeTracker[0].CompleteControllerSet.ControllerData.RawData[1][1] 1 0 0 0 5 -1 Raw12 FringeTracker[0].CompleteControllerSet.ControllerData.RawData[1][2] 1 0 0 0 5 -1 Raw13 FringeTracker[0].CompleteControllerSet.ControllerData.RawData[1][3] 1 0 1 1 5 -1 FT_OPD0 FringeTracker[0].CompleteControllerSet.ControllerData.OPD[0] 1 0 0 0 0 -1 FT_OPD1 FringeTracker[0].CompleteControllerSet.ControllerData.OPD[1] 1 0 0 0 0 -1 DL0_metrology DelayLine[0].CompleteControllerSet.ControllerData.LaserPositionOPD 1 0 0 0 0 -1 DL0_ServoMode DelayLine[0].ServoMode 0 SM_TRACK 0 0 0 5 DL1_metrology DelayLine[1].CompleteControllerSet.ControllerData.LaserPositionOPD 1 0 0 0 0 -1 DL1_lasererror DelayLine[1].CompleteControllerSet.ControllerData.LaserError 0 0 0 0 0 -1
The full channel names for archive file telemetry can be found by running the inventory program. channel.params files are archived with the data files.