| |
|
|
|
6 REFERENCE
6.1 tplOBS
tplOBS <dbAlias>
dbAlias alias of the OS OLDB root point
Abort [-current]
Abort the observation.
Continue
Continue the observation.
End
End the observation.
Pause
Pause the observation.
Setup <buffer>
Setup the observation.
SetupSubsys <subsystem> <buffer>
Forward a setup command to the specified OS subsystem
SetupKeys [<filterList>]
Return all OCS keywords except keywords present in <filterList>
SetupSave <dicList> <keyVal> <filename>
Save in the reference setup file <filename> (no extension) the contents of
<keyVal> ("<keyword1> <value1> .. <keywordN> <valueN>").
Keywords are checked against all dictionaries defined in <dicList>
and must be registered for class Setup
Library slxtcl is used and must therefore be linked
SetupLookup <dicList> <key> <filename>
Look in the reference setup file <filename> (no extension) for the
keyword <key> and return its value.
Keywords are checked against all dictionaries defined in <dicList>
and must be registered for class Setup
Library slxtcl is used and must therefore be linked
Start [<detId>]
Start the observation.
detId: value of the optional parameter -detId
Wait
Wait for the end of the observation.
Timeout [<newTimeout>]
Set the normal timeout and return its value
SetupTimeout [<newTimeout>]
Set the SETUP timeout and return its value
WaitTimeout
Return the WAIT timeout.
StopLoop dcs
Stop a loop of exposures possibly running on a dcs subsystem.
StartLoop dcs [<detIdFlag>]
Start a loop of exposures directly on a dcs subsystem.
detIdFlag: if 1, add option -detId to the START command. Default 0
ExpStatus [<n>]
Return the exposure status
n: exposure, if the observation has several exposures.
1: Off
2: Inactive
3: Setup
4: Started
5: Integrating
6: Paused
7: Reading out
8: Processing
9: Transfering
10: Storing
11: Completed
12: Failed
13: Aborted
Comment
Send Comment command.
ImgName [<tplId>] [<dprType>]
Build the default value of OCS.DETi.IMGNAME from TPL.ID and DPR.TYPE
tplId: template ID. Default: value of TPL.ID
dprType: data type. Default: value of DPR.TYPE
Expose <tplId> <dcsList> <funcS> <fileS> [<nrep>] [<imgLst>] [<idFlg>]
Perform simple exposures (sequence SETUP+START+WAIT).
tplId: template ID (see $TPL(ID))
dcsList: list of dcs objects involved in the exposure
funcS: -function parameter string for SETUP
fileS: -file parameter string for SETUP (if "", no -file specified)
nrep: how many times the exposure must be repeated (default 1)
imgLst: list of image file names to be used (default: use ImgName method)
idFlg: if 1, add option -detId to the START command. Default 0
ExposeDark <tplId> <dcsList> <fileS> [<nrep>] [<imgLst>] [<idFlg>]
Perform dark exposures (sequence SETUP+START+WAIT).
tplId: template ID (see $TPL(ID))
dcsList: list of dcs objects involved in the exposure
fileS: -file parameter string for SETUP (if "", no -file specified)
nrep: how many times the exposure must be repeated (default 1)
imgLst: list of image file names to be used (default $TPL(ID).fits)
idFlg: if 1, add option -detId to the START command. Default 0
The first command of an observation must be always Setup.
The last command of an observation must be always either
Abort or Wait.
6.2 tplDCS
tplDCS <dbAlias> name subsystem [<detIndex>] [<imageScale>]
dbAlias - alias of the DCS point
subsystem - name of OS subsystem for this DCS
detIndex - value of DETi index (default "" = no index)
imageScale - value returned by ImageScale (deafult -1)
SetupKeys [<filterList>]
Return all INS keywords except keywords present in <filterList>
SetupMode [<speed>]
Set the mode according to the supplied parameters.
speed = readout speed (default "" = keep it unchanged)
SetupFullFrame
Set the read-out for full frame (no window)
ExpTime [<dit>] [<ndit>]
Set the exposure time and return the corresponding FITS keywords.
dit Intergation time (default -1 = keep it unchanged)
ndit Number of integrations (default -1 = keep it unchanged)
Repeat [<nrep>]
Set the FITS keywords definiting the number of repeated exposures
nrep number of repeated exposures (default 0 = infinite loop)
Mode [<speed>]
Return the mode according to the supplied FITS keywords.
speed = readout speed (default "" = keep it unchanged)
Modes
Return a list of accepted modes (DET.READ.SPEED values).
Filename
Return the image filename.
ImageScale
Return the image scale that should be used to display
an image with MIDAS (see tplMIDAS LoadImage).
'DET'
Returns 'DETi'.
Name
Returns the detector name.
Subsystem
Returns the DCS subsystem name, as known to OS.
ExpStatus
Returns the current exposure status.
IsImageReal
Return 1 if image is read from the chip, otherwise 0
IsWsOnlyUsed
Return 1 if only the WS part of DCS is used, otherwise 0
IsLoopRunning
Return 1 if exposure loop is running, otherwise 0
IsLoopSupported
Return 1 if exposure looping is supported, otherwise 0
IsFileNameFixed
Return 1 if the image file name cannot be specified by the user, otherwise 0
Wait [<expStatus>]
Waits till the exposure status reaches the specified value (default "-reading")
Values supported: "-integrating"
"-reading"
"-transfering"
"-reading&transfering"
"-finished"
"-loop_running"
6.2.1 tplACE
6.2.2 tplFIERA
6.2.3 tplIRACE
6.3 tplICS
tplICS <icsDbPoint> <osDbAlias> <osSubsysName> <icsProcName>
icsDbPoint ICS OLDB root point in the Instrument Environment
osDbAlias alias of the OS point in the Instrument Environment
osSubsysName name of ICS subsystem as known to OS
icsProcName name of the ICS WS front-end process (e.g. xxiControl)
IsUsed
Returns 1 if ICS is available, 0 otherwise.
EnvName
Returns the ICS environment
ProcName
Returns the ICS process
NoInternalFlatField
Returns 1 if the instrument does not support internal
flat-fields.
SetupKeys [<filterList>]
Return all INS keywords except keywords present in <filterList>
SetupMode [<mode>]
Set and return INS.MODE
SetupLamp
Setup and return the FITS keyword indicating the lamp on.
6.4 tplTCS
tplTCS <tcsDbAlias> <osDbAlias> <osSubsysName> <focusId> <insId>
tcsDbAlias alias of the TCS point in the Instrument Environment
osDbAlias alias of the OS point in the Instrument Environment
osSubsysName name of TCS subsystem as known to OS
focusId ID of focus used (e.g. "CA", "NA", "NB")
insId ID of the instrument as known to TCS
IsUsed
Returns 1 if TCS is available, 0 otherwise.
EnvName
Returns the TCS environment, e.g. 'wt1tcs'.
ProcName
Returns the TIF process, e.g. 'tifCA'.
GetFocus
Returns the focus ID
GetAdapterPos
Returns the current adapter position
GetRotatorPos
Returns the current rotator position
GetTurnTablePos
Returns the current turntable position
GetInsRotAngle
Returns the instrument rotator angle
SendFocusOffset <insMode> <detName> <offset>
Send focus offset to TCS (command OFFSFM2).
It returns as soon the command to TCS is sent.
It returns the ID of the command sent to TCS
Method Wait must be called to wait for the last reply from TCS.
SendOffsad <raOffset> <decOffset>
Send command OFFSAD to TCS.
It returns as soon the command to TCS is sent.
It returns the ID of the command sent to TCS
Method Wait must be called to wait for the last reply from TCS.
SendOffsadg <raOffset> <decOffset>
Send command OFFSADG to TCS.
It returns as soon the command to TCS is sent.
It returns the ID of the command sent to TCS
Method Wait must be called to wait for the last reply from TCS.
SendOffsfm2 <how> <offset>
Send command OFFSFM2 to TCS.
It returns as soon the command to TCS is sent.
It returns the ID of the command sent to TCS
Method Wait must be called to wait for the last reply from TCS.
SendProbeFocusOffset <how> <offset>
Send command SETFOFF to TCS.
It returns as soon the command to TCS is sent.
It returns the ID of the command sent to TCS
Method Wait must be called to wait for the last reply from TCS.
SendSeqAO <flag>
Send command SEQAO to TCS.
It returns as soon the command to TCS is sent.
It returns the ID of the command sent to TCS
Method Wait must be called to wait for the last reply from TCS.
SendStopag
Send command STOPAG to TCS.
It returns as soon the command to TCS is sent.
It returns the ID of the command sent to TCS
Method Wait must be called to wait for the last reply from TCS.
Wait [<cmdId>]
Wait the reply of command (default cmdId = -1 = last command)
SendPark
Park the calibration unit and guide probes
It returns as soon the command to TCS is sent.
It returns the ID of the command sent to TCS
Method WaitPark must be called to wait for the last reply from TCS.
WaitPark
Wait until everything is parked.
IsAgActive [-wait]
Returns 1 if the autoguider is active, 0 otherwise.
If the -wait option is used, then ask to start
autoguiding and wait.
IsAoActive [-wait|-waitRunning]
Returns 1 if active optics is active, 0 otherwise.
If the -wait option is used, then ask to start
active optics and wait until the first analysis
has been completed.
WaitforAO
Wait for Active Optics active
Parallatic
Return parallatic.
RotOnSky
Return rotOnSky.
SetRotOffset <insMode> <detName> <offset>
Send the rotator offset to TCS
It returns as soon the command to TCS is sent.
It returns the ID of the command sent to TCS
Method Wait must be called to wait for the last reply from TCS.
6.5 tplUIF
Confirm <title> [<labelYes>] [<labelNo>]
Pop ups a confirmation dialog.
Returns 0 or 1.
ConfirmOrRetry <title>
Pop ups a confirmation dialog with three buttons:
Yes, No, Retry. Returns 0, 1 or 2.
GetExpTimeAndContinue <title> <raOffset> <decOffset> <expTime>
Display a dialog window to modify the exptime
and ask to quit or continue interactive pointing.
Returns a list with the continue flag and with
the new exposure time.
GetValue <title> <value>
Display a dialog window to request a value to the user.
Returns the value entered by the user.
Sleep <time> [<doLog>]
Sleep for <time> seconds, while updating the UIFs.
If doLog = 1 (default) a tplLog call is done.
6.6 tplDR
tplDR [<unit>] [<startFlag>]
unit MIDAS unit to be used. Default 11
start a session, if not running yet. Default: 1 (yes)
Start
Start DR session, if not running yet
Stop
Stop DR session, if not running yet
MeanLevel <file> [<procedure>]
Return the average value of the last exposure from file <file>
<procedure> indicates which procedure is used (default tplMeanLevel)
LoadImage <file> [<scale>] [<procedure>]
Load an image, contained in <file>, in MIDAS.
<scale> = image scale (default -2)
<procedure> indicates which procedure is used (default tplLoadImage)
TFocus <file> [<procedure>]
Run the focus batch and return the best focus value.
<procedure> indicates which procedure is used (default tplTFocus)
IsSimulated
Return flag indicating if DR is simulated or not (see DEBUG_MIDAS)
6.7 tpltooTsfKeySort
tpltooTsfKeySort <name1>.tsf [... <nameN>.tsf] [<name>.isf] [-o <dest_dir>]
<nameN>.tsf
Template signature files to be processed.
<name>.isf
Instrument signature file
(it may be used to specify the keyword order, see below).
-o <dest_dir>
Destination directory for the ordered *.tsf files.
If option -o is not used, then the input files are
overwritten.
This utility orders the template signature file parameters
as follows (by default):
- DET1.*
- INS1.*
...
- DETn.*
- INSn.*
- DET.*
- SEQ.*
- TEL.*
- INS.*
The instrument signature file may specify a different order
with the keyword: TPL.SORT.CATEGORY, e.g.:
TPL.SORT.CATEGORY "DET2 DET1 SEQ TEL INS"
The DET.* and TEL.* keywords are by default ordered
according an internal predefined sort order;
the INS.* keywords are by default ordered alphabetically.
The instrument signature file may use the TPL.SORT.PARAMS
keyword to specify a different order, e.g.:
TPL.SORT.PARAMS "INS.ADC.MODE INS.DROT.MODE INS.FILT1.NAME
INS.SLIT1.WID INS.SLIT1.LEN INS.FILT2.NAME
INS.SLIT2.WID INS.SLIT2.LEN INS.FILT3.NAME"
It is recommended to order the INS.* keywords according
to their position within the instrument lightpath.
6.8 tpltooObdBuild
tpltoobObdBuild <name1>.tsf [... <nameN>.tsf] [<name>.isf] [-a] [-o <dest>]
<nameN>.tsf
Template signature files to be processed.
If no directory is specified, then the file is searched in:
$INS_ROOT/SYSTEM/COMMON/TEMPLATES/TSF
$INTROOT/config/INS_ROOT/SYSTEM/COMMON/TEMPLATES/TSF
If file <nameN>.obdv exists, then it is also loaded
(to retrieve specific OB keyword values, see below).
<name>.isf
Instrument signature file used to obtain parameter values
for the test observation blocks.
If no directory is specified, then the file is searched in:
$INS_ROOT/SYSTEM/COMMON/CONFIGFILES
$INTROOT/config/INS_ROOT/SYSTEM/COMMON/CONFIGFILES
-a Produce a test observation block that contains an observation
for each template signature file supplied.
-o <dest>
Destination directory for the produced *.obd files, or
if option -a is used, then the destination *.obd file.
Default directory: $INS_ROOT/SYSTEM/COMMON/TEMPLATES/OBD
For each template signature file received as input, tpltooObdBuild
creates one observation block file (*.obd) to allow to test the
template.
If option -a is used, then an observation block to test all
templates is created.
The observation parameters are obtained from the keywords present
in the *.tsf, *.obdv or *.isf files, according to the following
precedence:
- <keyword> (searched only in the *.obdv file)
- <keyword>.TEST.VALUE
- <keyword>.VALUE
- <keyword>.DEFAULT
- If non of the above keywords are present, then the value
"NODEFAULT" is used.
 Quadralay Corporation http://www.webworks.com Voice: (512) 719-3399 Fax: (512) 719-3606 sales@webworks.com |
| |
|
|
|