#****************************************************************************** # E.S.O. - VLT project # # "@(#) $Id: dicVIRCAM_ICS.txt,v 0.7 2004/07/29 12:05:28 vltsccm Exp $" # # VIRCAM_ICS/ICB_CFG dictionaries # # Refer to appendix A of document VLT-SPE-ESO-17240-1676 for details. # # who when what # -------- -------- ---------------------------------------------- # sbeard 19/06/03 Original copied from V1.23 of dicXXXX_ICS.txt # sbeard 09/07/03 Removed keywords for unwanted components. # sbeard 06/02/04 Inserted "i" to allow more than one ICS. # smclay 05/05/04 Added sensor device # sbeard 11/05/04 Added INS.LSMi, INS.LSCi, INS.VACi, INS.OMGi # and CCCi keywords. # sbeard 15/07/04 Removed INS.OMGi keywords # sbeard 21/07/04 Added FILTi.TIME, FILTi.ERROR and FILTi.INPOS # keywords, as required by VISTA data flow group. # Comments shortened. # sbeard 28/07/04 Changed FILTi.TIME to FILTi.DATE to be # consistent with HOWFS.DATE. INS becomes INS, # since VIRCAM now only uses one ICS. # smclay 29/07/04 Added OK and INIT keywords for sensor logs. # # #****************************************************************************** # # The VIRCAM_ICS dictionary contains all keywords used by VIRCAM ICS at # runtime to execute and understand commands with -function option, # such as SETUP and STATUS. # # NOTE: Header keywords must be agreed with the VISTA Data Flow group. # # IMPORTANT NOTE: The "Value Format" entry defines the precision of # the keyword value, following the ANSI-C printf # rules. Specially for float or double numbers, # roundings are possible and affects all commands, # in particular SETUP and STATUS. # In order to avoid undesired roundings, the # appropriate precision must be defined in this field. # #****************************************************************************** # # Notes # 1) The letters within () indicate the Class that keyword belongs to: # c = config # h = header # l = conf-log # p = private # s = setup # o = ops-log # DICTIONARY VIRCAM_ICS "VIRCAM" "VISTA IR Camera Instrument ICS keywords" REVISION "$Revision: 0.7 $" CONTEXT "Instrument" # # 1.1 General instrument config. # # # 1.2 Environments and LCUs # # # 2.1 ICS general config. # # # 2.2 ICS setup and header # INS.ID %30s Instrument ID (chl) Combines the ESO identification of the instrument and the software version of the control software. Format: NAME/HW-REV/SW-VERSION INS.DID %30s Data dictionary for INS (ch) Name and version of ESO DID to which INS keywords comply to. INS.OPER %30s Instrument Operator (hs) Initials and family name of instrument operator or service observer. INS.SWSIM %15s Software simulation (chs) Possible values: NORMAL: no simulation. LCU_SIM: LCU is simulated by WS simulator. HW_SIM: Hardware is simulated on LCU. INS.MODE %10s Instrument mode (hs) Acronym of instrument mode used. This acronym identifies the operating mode of the instrument (HOWFS or IMAGING). INS.PATH %10s Optical path (h) The optical path within the instrument used for this exposure (INFRARED). # # The following configuration parameters describe the individual instrument # devices. Each device type has its own set of configuration parameters. # # Defaults: # # - The .TYPE keyword specifies the implementation to be used # for the device. The default corresponds to the implementation supplied # by Base ICS. # # - If the .PREFIX keyword is not supplied, then the 'FITS prefix' # needed by the ic0 devices corresponds to the . # # # 3. Device configuration [Devices marked (X) to be removed] # # # 3.6 Filter wheel # # Config. FITS keywords: # DEVNAME, DEVDESC, LCUID, AVAIL, SWSIM, # STOFF, USESW, # TWOSTEP, MOVETOUT, INITTOUT, # CHGABLE, POSNUM, POSIDi, IDi, NAMEi, FOCUSi, DENSITY # Setup and header FITS keywords: # NO, ID, NAME, SWSIM, OFFANG, GOTO # Maint. keywords (reserved): # ENC, ENCREL, LIMIT, TURN, SPEED. # Conf. log FITS keywords: # INIT, MOVE, STOP, CHANGE. # # 3.6.1 Filter config. FITS keywords # # BUG - WHY IS SWSIM ACCEPTED AND STOFF IS NOT ??? # SPECIFYING FILTi or FILT1 MAKES NO DIFFERENCE. # INS.FILTi.SWSIM %c If T, function software simulated (cho) INS.FILTi.STOFF %d Offset [steps] to be applied (cho) An offset in motor steps to be applied to all positions. Allows for backup reference switch. INS.FILTi.USESW %c If T, in-position switch is used (cho) # Each element position registers only the IDi of the mounted element. # A corresponding ID entry is searched to retrieve the rest of the # element data. # # A list of elements that can be mounted in this function is described # with entries IDi, NAMEi, FOCUSi and DENSITYi (one keyword set describes one # element, see section 3.6 of the INS Common Software Spec. manual, # VLT-SPE-ESO-17240-0385). INS.FILTi.IDi %10s Filter unique id (chls) ESO identification number for the filter. Format: #n where n is a unique number for the observatory. INS.FILTi.NAMEi %15s Filter name (chls) Name for the filter. Format: SYSTEM/NAME where the filter system is given when applicable, eg BESS for Besselian. INS.FILTi.FOCUSi %.3f Filter focus offset [m] (chls) Optical focus offset introduced by the filter. INS.FILTi.DENSITYi %.1f Filter optical density (chls) Approx. optical density of the filter. # 3.6.2 Filter setup and header FITS keywords # INS.FILTi %10s Filter wheel device (o) INS.FILTi.NO %d Filter wheel position index (hs) Index of the selected position of the filter wheel INS.FILTi.ENC %d Filter wheel absolute position [Enc] (s) INS.FILTi.ENCREL %d Filter wheel relative position [Enc] (s) INS.FILTi.LIMIT %10s Move to the limit (s) Move to the lower or upper limit. INS.FILTi.TURN %10s Turn right/left (s) Turn the wheel to the right or to the left. INS.FILTi.SPEED %.1f Turning speed (s) Speed (default units) the wheel is turned (see TURN). INS.FILTi.INPOS %c If T, in-position switch is closed (h) # 3.6.3 Filter operational logs. # INS.FILTi.INIT %s Hardware initialisation (o) INS.FILTi.MOVE %s Motion execution (o) INS.FILTi.STOP %s Motion stop (o) INS.FILTi.CHANGE %s Filter changed (o) Filter element has been physically replaced. Maintenance operation. INS.FILTi.DATE %s Filter index time (ho) Date/Time when filter wheel was last indexed. INS.FILTi.ERROR %d Last filter wheel error [Enc] (ho) Difference between expected and actual count when filter wheel last indexed. # 3.6.4 Filter ICS GUI widget. # # # 3.13 Sensors # # Each sensor device INS.SENSORi manages a set of related sensors values # INS.SENSi. The index SENSi of each sensor value must be unique within # the instrument (to be able to report each sensor value with a different # FITS keyword). # # There is no relation between sensor device indexes (SENSORi) and sensor # value indexes (SENSi), e.g. one sensor device INS.SENSOR3 can manage # e.g. the sensor values INS.SENS12 to INS.SENS16. # # The sensor values managed by one sensor device are usually connected # to a single harware port (PORT). The hardware port of analog sensors # is normally a serial port, the hardware 'port' of a digital sensor # device is an ACRO board. # # # 3.13.1 Analog sensors # # Config. FITS keywords: # DEVNAME, DEVDESC, DEVTYPE, LCUID, AVAIL, SWSIM, # PORT, NUM, NAMEi, DESCi, HEADERi, FITSi, LOGi, # SENADDRi, SENTYPEi, SENREFi, SENRAMPi, SENUNITi. # Setup and header FITS keywords: # INS.SENSi.ST, INS.SENSi.STAT, INS.SENSi.VAL, INS.SENSi.REF. # Maint. keywords (reserved): # - # Conf. log FITS keywords: # INIT. # # # 3.13.2 Digital sensors (DEVTYPE=DIGITAL) # # Config. FITS keywords: # DEVNAME, DEVDESC, DEVTYPE, LCUID, AVAIL, SWSIM, # ID, NAME, PORT, NUM, NAMEi, DESCi, HEADERi, FITSi, LOGi, # SIGBITi, SIGWIDTHi, SIGLOWi, SIGVALi, SIGSIMi. # Setup and header FITS keywords: # INS.SENSi.ST, INS.SENSi.STAT, INS.SENSi.VAL. # Maint. keywords (reserved): # - # Conf. log FITS keywords: # INIT. # # 3.13.[12].1 Sensors common config. FITS keywords # # NOTE: Do we need these SENSOR keywords as well as the LSM and LSC keywords? # INS.SENSORi.SWSIM %c If T, function software simulated (cho) INS.SENSORi.ID %10s Sensor device unique id (clo) ESO identification number for the sensor device. INS.SENSORi.NAME %30s Sensor device common name (clo) Name for the sensor device. # Lakeshore 218 temperature monitor keywords INS.LSMi %10s Sensor device (o). INS.LSMi.SWSIM %c If T, function software simulated (cho) INS.LSMi.ID %10s Sensor device unique id (clo) ESO identification number for the sensor device. INS.LSMi.NAME %30s Sensor device common name (clo) Name for the sensor device. INS.LSMi.OK %c If T, controller was operational (h). INS.LSMi.INIT %s Hardware initialisation (o). # Lakeshore 332 temperature controller keywords INS.LSCi %10s Sensor device (o). INS.LSCi.SWSIM %c If T, function software simulated (cho) INS.LSCi.ID %10s Sensor device unique id (clo) ESO identification number for the sensor device. INS.LSCi.NAME %30s Sensor device common name (clo) Name for the sensor device. INS.LSCi.OK %c If T, controller was operational (h). INS.LSCi.INIT %s Hardware initialisation (o). # Pfeiffer vacuum sensor keywords INS.VACi %10s Sensor device (o). INS.VACi.SWSIM %c If T, function software simulated (cho) INS.VACi.ID %10s Sensor device unique id (clo) ESO identification number for the sensor device. INS.VACi.NAME %30s Sensor device common name (clo) Name for the sensor device. INS.VACi.OK %c If T, controller was operational (h). INS.VACi.INIT %s Hardware initialisation (o). # Cabinet cooling controller keywords INS.CCCi %10s Sensor device (o). INS.CCCi.SWSIM %c If T, function software simulated (cho) INS.CCCi.ID %10s Sensor device unique id (clo) ESO identification number for the sensor device. INS.CCCi.NAME %30s Sensor device common name (clo) Name for the sensor device. INS.CCCi.OK %c If T, controller was operational (h). INS.CCCi.INIT %s Hardware initialisation (o). # 3.13.1.1 Analog sensors config. FITS keywords # # 3.13.2.1 Digital sensors config. FITS keywords # # 3.13.[12].2 Sensors setup and header FITS keywords # ################################################################################### # Sensors (physical devices) # INS.SENSORi %10s Sensor device (o) INS.SENSi.ID %10s Sensor type (ho) INS.SENSi.NAME %15s Sensor name (ho) INS.SENSi.VAL %.3f Sensor value (ho) INS.SENSi.STAT %s Sensor string value (ho) # Sensor statistics values during an exposure (e.g. pressure, humidity) INS.SENSi.MIN %.3f Minimum value (h) INS.SENSi.MAX %.3f Maximum value (h) INS.SENSi.MEAN %.3f Average value (ho) INS.SENSi.RMS %.3f RMS of samples over exposure (ho) INS.SENSi.TMMEAN %.3f Time weighted average (ho) INS.SENSi.GRAD %.3f Linear regression slope (ho) INS.SENSi.LRCONST %.3f Linear regression constant (ho) INS.SENSi.LRRMS %.3f Linear regression RMS (ho) INS.SENSi.DETCOEF %.3f Lin. reg. determination coeff. (ho) INS.SENSi.UNITi %.8s Sensor unit (hc) # Temperature sensor statistics values during an exposure INS.TEMPi.ID %10s Sensor type (ho) INS.TEMPi.NAME %15s Sensor name (ho) INS.TEMPi.VAL %.3f Temperature (ho) INS.TEMPi.MIN %.3f Minimum value (h) INS.TEMPi.MAX %.3f Maximum value (h) INS.TEMPi.MEAN %.3f Average value (ho) INS.TEMPi.RMS %.3f RMS of samples over exposure (ho) INS.TEMPi.TMMEAN %.3f Time weighted average (ho) INS.TEMPi.GRAD %.3f Linear regression slope (ho) INS.TEMPi.LRCONST %.3f Linear regression constant (ho) INS.TEMPi.LRRMS %.3f Linear regression RMS (ho) INS.TEMPi.DETCOEF %.3f Lin. reg. determination coeff. (ho) INS.TEMPi.UNITi %.8s Temperature unit (hc) # Pressure sensor statistics values during an exposure INS.PRESi.ID %10s Sensor type (ho). INS.PRESi.NAME %15s Sensor name (ho). INS.PRESi.VAL %.3f Pressure (ho). INS.PRESi.MIN %.3f Minimum value (h). INS.PRESi.MAX %.3f Maximum value (h). INS.PRESi.MEAN %.3f Average value (ho). INS.PRESi.RMS %.3f RMS of samples over exposure (ho). INS.PRESi.TMMEAN %.3f Time waighted average (ho). INS.PRESi.GRAD %.3f Linear regression slope (ho). INS.PRESi.LRCONST %.3f Linear regression constant (ho). INS.PRESi.LRRMS %.3f Linear regression RMS (ho). INS.PRESi.DETCOEF %.3f Lin. reg. determination coeff. (ho). INS.PRESi.UNITi %.8s Pressure unit (hc). # 3.13.[12].3 Sensors operational logs. # INS.SENSORi.INIT %s Hardware initialisation (o) #___oOo___