| |
|
|
|
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 INS keywords except keywords present in <filterList>
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.
Expose <tplId> <dcsList> <funcSetup> <fileSetup> [<nrep>] [<imgFileList>] [<detIdFlag>]
Perform simple exposures (sequence SETUP+START+WAIT).
tplId: template ID (see $TPL(ID))
dcsList: list of dcs objects involved in the exposure
funcSetup: -function parameter string for SETUP
fileSetup: -file parameter string for SETUP (if "", no -file specified)
nrep: how many times the exposure must be repeated (default 1)
imgFileList: list of image file names to be used (default $TPL(ID).fits)
detIdFlag: if 1, add option -detId to the START command. Default 0
ExposeDark <tplId> <dcsList> <fileSetup> [<nrep>] [<imgFileList>] [<detIdFlag>]
Perform dark exposures (sequence SETUP+START+WAIT).
tplId: template ID (see $TPL(ID))
dcsList: list of dcs objects involved in the exposure
funcSetup: -function parameter string for SETUP
fileSetup: -file parameter string for SETUP (if "", no -file specified)
nrep: how many times the exposure must be repeated (default 1)
imgFileList: list of image file names to be used (default $TPL(ID).fits)
detIdFlag: 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: "-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).
SendOffsad <raOffset> <decOffset>
Send command OFFSAD to TCS.
SendOffsadg <raOffset> <decOffset>
Send command OFFSADG to TCS.
SendOffsfm2 <how> <offset>
Send command OFFSFM2 to TCS.
SendProbeFocusOffset <how> <offset>
Send command SETFOFF to TCS.
SendSeqAO <flag>
Send command SEQAO to TCS.
SendStopag
Send command STOPAG to TCS.
Wait [<cmdId>]
Wait the reply of command (default cmdId = -1 = last command)
SendPark
Park the calibration unit and guide probes
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
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>
Sleep for <time> seconds, while updating the UIFs.
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)
 Quadralay Corporation http://www.webworks.com Voice: (512) 719-3399 Fax: (512) 719-3606 sales@webworks.com |
| |
|
|
|