P.O. Box 1597 Kamuela, Hawaii USA Telephone (808) FAX (808) M E M O R A N D U M CONTENTS

Size: px

Start display at page:

Download "P.O. Box 1597 Kamuela, Hawaii USA Telephone (808) FAX (808) M E M O R A N D U M CONTENTS"

Darlene Preston
5 years ago
Views:

1 Canada - France - Hawaii Telescope Corporation Société du Télescope Canada - France - Hawaii P.O. Box 1597 Kamuela, Hawaii USA Telephone (808) FAX (808) M E M O R A N D U M TO: FROM: NEO, Elixir, QSO R. Savalle, S. Isani, P. Martin DATE: September 4, 2000 SUBJECT: Communications interface between QSO and NEO QSO-004/Version 2.2/DRAFT CONTENTS 1 History Context Conventions of this document Big picture FITS Keywords New keywords Meaning of existing keywords General comments for all the commands Specifications of the parameters sent by QSO Pointing parameters Exposure parameters Special scripts Example: An Observing Scenario Error recovery Issues History Version Date Comments V1.3 Feb 25, 2000 Released to NEO,Elixir,QSO for comments V1.4 Mar 9, 2000 Added parameters OBSERVER, OBJECT - New open issues about calibration Misc. corrections - Added big picture figure V1.5 April 11, 2000 Many corrections after meeting V1.6 August 13, 2000 Preparation of common document with NEO V2.0 August 24, 2000 Redesign without scripts V2.1 August 30, 2000 Corrections before QSO/NEO interface meeting V2.2 September 4, 2000 Corrections after QSO/NEO interface meeting and misc. discussions

2 2 Context This memo describes how QSO will communicate with the observation environment NEO and details the specifications of the executable scripts that will be needed to run the observations in queue mode. It was compiled using our current knowledge of the TCS commands and the CFH12K observing scenarios. 3 Conventions of this document (A B) means exclusive or: A or B but not A and B [] means optional underline means a mandatory argument MP = for MegaPrime only 12K= for CFH12K only Varchar(10) : a string with a maximum length of 10 characters Numeric(4,1): a number on 4 digits with 1 digit of precision (ex: 100.5) 4 Big picture In the following picture, once the Queue Scheduler has created the queue, the Observation tool communicates with NEO by sending the director commands with arguments NEO sends back a result for each command (PASS or FAIL). NEO also notifies QSO whenever a new exposure has been done. PH2 Phase 2 Web Tool QSO NEO Ph2 DB Queue Scheduler Queue OB1 OBSERVATION TOOL OB2 OB3 DATA Command Generator COMMANDS List of director commands with arguments OB4 One command + arguments CB1 PASS or FAIL Exposures INSERT exposure FITS headers Insert Script NOTIFICATION

3 5 FITS Keywords 5.1 New keywords As described before, the feedback from the observation system (NEO) to the Q system is minimal (a return status for each script called). Therefore, the Q system will use FITS headers of all exposures taken in QSO mode in order to keep track of what has been observed. Thus we need to introduce new FITS keywords described below. Name Format Example Comment QRUNID String 01AQ01 Uniquely identifies the Q run QOBID Numeric(20) NB: only 10 digits used in this document Identify the Observing Block in the program QRUNID is the name of a Q run. It uniquely identifies a period of time during which the camera is operated in Q mode. The format is the same as the RUNID, (the 1 st three characters identify the semester (like 01A), the letter Q is used to indicate queue observing/service observing) and the last two digits indicate the number of the Q run within the semester (01 for the 1 st run, 02 for the 2 nd, etc) QRUNID is crucial in the database to be able to group all exposures taken during the same run (for instance, for calibration purposes) QOBID is a reference to the phase 2 observing block to which the exposure belongs. At the time of writing it is coded on 20 digits in the PH2 database, but we could actually use less (8 or 10). (This comes from a database constraint because of the replication of the database at CDS). QOBID allows to link an executed exposure to an OB in the database. The values for these 2 new headers will be sent by commands, which set the values of the FITS headers. 5.2 Meaning of existing keywords As with classical observations, the RUNID keyword carries the name of the program to which the exposure belongs (Example: 01AC10 for semester 01A, C, F, H, K for agencies, D for discretionary and E for engineering, and a number on 2 digits). Note that programs and runs are different concepts in Q mode, since a program may now span several runs, but we keep the keyword for compatibility, even if now it really means observation program A special case: Exposures belonging to the calibration plan (detrending and other calibration frames like FOCUS, astrometric and photometric calibrations) do not belong to an agency program but will be shared for several of them. We propose to use the letter Q for the RUNID for these calibrations done in Q mode. Several different RUNID per QRUNID will be needed for calibration purpose Ex: RUNID=01AQ01Q: Darks for 1 st run, 01AQ02Q= Flats for 1 st run, 01AQ03Q=Photometric calib for 1 st run, etc. (see Observing Scenario below for an example). 5.3 Inserting the keywords into the images RUNID, QRUNID, QOBID, OBSERVER, OBJECT, and PI_NAME are passed to NEO as arguments of all

4 scripts which will generate FITS images, to be included in the FITS headers of those images. 6 General comments for all the commands In order to take advantage of the knowledge of next observations allowed by the QSO system, the observation tool will have the ability to send several commands in advance. Because this interrupts the observations, failure status should be returned only in case of a serious error condition which prevents the al of the command to be achieved.

5 7 Specifications of the parameters sent by QSO 7.1 Pointing parameters Arguments Arguments Arguments Description Argument Example Name Format TMODE string Type of target requested SIDERAL = fix, sideral target TRACK = non sideral target requiring differential tracking TMODE= SIDERAL If TMODE=SIDERAL these arguments are used to describe a static object (with proper motion): (TRA TDEC TEQ numeric(5.1) TRAPM TDECPM TCAT TCID) float float string string RA of center field Dec of center of field Equinox for TRA and TDEC Special value: 0.0=APPARENT Proper motion RA in sec/year Proper motion Dec in arcsec/y Catalog name Catalog ID in TCAT TRA= 12:30:15.22 TDEC= 45:40:12.3 TEQ= TEQ=0.0 TRAPM=0.10 TDECPM=1.2 TCAT= SAO TCID= If TMODE=TRACK these arguments describe a moving object: 2 positions are given which for times which are within a few hours of the actual observation time NB: No equinox is needed since the date of the positions are given as accurate Modified Julian dates TRA1 TDEC1 TMJD1 numeric(12,7) RA of center field at TMJD1 Dec of center field at TMJD1 MJD for TRA1 and TDEC1 TRA1= 12:30:15.10 TDEC1= 45:40:12.2 TMJD1= TRA2 TDEC2 TMJD2 numeric(12,7) RA of center field at TMJD2 Dec of center field at TMJD2 MJD for TRA2 and TDEC2 TRA2= 12:35:45.30 TDEC2= 46:10:30.2 TMJD2= GMODE String Type of guiding requested NO = no guiding requested AUTO= guiding required, no GS given, OA chooses the star(s) 1GS = 1 GS given, follows (12K) 2GS = 2 GS given, follow (MC) If GMODE = 1GS (12K) the following arguments are also sent: (GRA GDEC GEQ GCAT GCID) numeric(5,1) RA of GS Decl of GS Equinox of GRA and GDEC Catalog name Catalog ID in GCAT GMODE= AUTO (will be the most frequent mode with CFH12K) GMODE= 2GS (will be used with Megacam) GRA= 12:31:45.10 GDEC= 45:41:30.4 GEQ= GCAT= GSC GCID= 1234 If GMODE=2GS (MP) the following arguments are also sent:

6 (GRAN GDECN GEQN GCATN GCIDN) numeric(5,1) RA of GS North of field Dec of GS North of field Equinox of GS North of field Catalog name for GCIDN Catalog ID of North GS in GCATN (GRAS GDECS GEQS GCATS GCIDS) numeric(5,1) RA of GS South of field Dec of GS South of field Equinox of GS South of field Catalog name for GCIDS Catalog ID of South GS in GCATS AUTOFOC Varchar(10) (to plan other modes) Performs autofocus after slewing (MP) AUTOFOC= Y 7.2 Exposure parameters

7 ETYPE 1 Varchar(10) Exposure Type to put in FITS header O = object F = flat D = dark B = bias X = focus ETYPE= O QRUNID varchar(10) Q Run ID to put in FITS header QRUNID= 01AQ01 RUNID varchar(10) Program ID to put in FITS header RUNID= 01AF23Q QOBID numeric(20) Observing Block ID to put in FITS QOBID= header OBSERVER Name of observer to put in FITS OBSERVER= Q Observer header PI_NAME Name of PI for the RUNID PI_NAME= P Martin OBJECT varchar(20) Name of target to put in FITS header OBJECT= M33 FILTER varchar(10) Name of the filter to use for exposure(s) B V R I Z TiO2 Halpha HalphaOFF Cn PATTERN varchar(10) Pattern to use for exposure SINGLE means one exposure DP2 to DP8 are the predefined dithering patterns USER: the pattern is defined in a subsequent list of offsets PRADIUS numeric(3) Pattern radius: radius in arcsecs of dithering pattern if PATTERN=DPx OFFSETS varchar(255) Description of the offsets if PATTERN=USER Offsets are in format [-]mm:ss where mm is in arcmin and ss in arcsecs The list of offsets is as follow: offset:= N=[-]mm:ss,[-]mm:ss list:=offset [offset] [offset] RASTER Readout and binning mode for all the chips(s) FULL binx biny xc yc xs ys binx biny CENTER xs ys binx biny where: xc,yc = center of raster xs,ys = size of raster FILTER= R PATTERN= SINGLE PATTERN= DP3 PRADIUS=15.0 OFFSETS= 1=00:00,00:04 2=-00:16,00:03 RASTER= FULL 1 1 The most likely in Q mode RASTER= CENTER

8 ETIME numeric(5,1) Common integration time in seconds for the exposure (if PATTERN = SINGLE) or for all the exposures (else) ETIME= Special scripts FLAT Make a set of flat field exposures. Called when the time is suitable for sky flats 2, for a given duration (DURATION) Binning for FLATs will always be 1 and RASTER will always be full Return: PASS FAIL SEQ varchar(10) Flat sequence/scenario to perform Z_NOTRACK = A sequence at zenith position Z_TRACK = same with tracking to avoid star trails, and unguided offsets between each exposure DOME = a sequence of dome flats SPLIT Proportion of flats to do for each filters, in percentage SEQ= Z_NOTRACK SEQ= Z_TRACK SEQ= DOME SPLIT= R=70,B=20,I=10 NEO signals whenever a new image is readout Ret DURATION numeric(4,0) Maximum time permitted for the script to run in seconds. The script will end after this duration, or sooner. DURATION= 600 Script is allowed to take flat fields for no more than 10 minutes FOCUS Make a focus image at position currently pointed. NEO chooses focus parameters (focus for center value, number of steps, focus step) according to estimated value of focus NEO Returns PASS FAIL Seeing NEO compute best focus and update focus accordingly for filter

9 8 Example: An Observing Scenario The following observing scenario describes the first Q run of the semester 01A (QRUNID=01AQ01). The scenario show how observing blocks are divided into commands, and how the QRUNID, RUNIDs and QOBID identifier are used. The leftmost column gives the QRUNID, RUNID and QOBID number for the current OB. Each OB contains one or more calls to scripts with arguments. During this example night the following science programs are observed: 01AC12Q (PI: PM) - 1 OB observed 01AF10Q (PI: CV) - 1 OB observed In addition the calibration program 01AQ01 is used for all the detrending and calibration exposures done during this night (4 OBs) RUNID QOB # Action Commands sent to NEO Comments At dawn, a series of flat fields are taken 1 OB of 01AQ01Q (flats) ID FLAT header QRUNID "01AQ01" header RUNID "01AQ01Q" header QOBID header OBSERVER "Q observer" header OBJECT "twilight flat" header PI_NAME "CFHT" tflat split R=70 B=20 I=10 tflat duration 1200 etype tflat At dawn starts a flat sequence. The flat script will run for a maximum of 1200 seconds Beginning of the night: evaluation of sky quality The OA points to a random field containing stars, he also reports about clouds 1 OB of 01AQ01Q (calib) ID FOCUS header QRUNID "01AQ01" header RUNID "01AQ01Q" header QOBID header OBSERVER "Q observer" header OBJECT "focus" header PI_NAME "CFHT" etype focus nexp 7 filter "R" raster FULL 1 1 etime 15 Science Observations begin We are observing one OB of program 01AC12 The night always starts with a focus exposure. This allows NEO to set the optimal focus for the instrument and QSO to know about the seeing This focus belongs to the calibration runid for the night/run

10 1 OB of 01AC12Q ID POINT EXPOSE header QRUNID "01AQ01" header RUNID 01AC12Q" header QOBID header OBSERVER "Q observer" header OBJECT "M33" header PI_NAME "PM" tcoords... gselect auto etype object nexp 1 filter V raster FULL BIN1 etime 60.0 Send coordinates of OB target. Ask for guiding, but do not provide a GS. The OA will be asked to select one. Make one exposure of 60.0 in V EXPOSE etype dither nexp 8 filter R raster FULL BIN1 etime 30.0 Make 8 exposures of 30 seconds in red, with a dithered pattern, and the full raster of the mosaic. We are now observing one OB of program 01AF10Q ID POINT header QRUNID "01AQ01" header RUNID "01AF01Q" header QOBID header OBSERVER "Q observer" header OBJECT "TNO" header PI_NAME "CV" tcoords... gselect auto Set headers Send coordinates of OB target 1 OB of 01AF10Q FOCUS etype focus nexp 7 filter "R" raster FULL BIN1 etime 15 Make a focus exposure at the target position. EXPOSE etype object nexp 1 filter B raster FULL BIN1 etime Make one exposure of 900 secs in blue At the end of the night, at the time optimal for flats: 1 OB of 01AQ01Q FLAT (calib) At dawn starts a flat sequence. The flat script will run for a maximum of 1500 seconds

11 cf infra During the day (dark and biases can be done by day) 1 OB of 01AQ02Q (calib) ID DARK header QRUNID "01AQ01" header RUNID "01AQ02Q" header QOBID header OBSERVER "Q observer" header OBJECT "dark" header PI_NAME "CFHT" etype dark nexp 10 raster FULL 1 1 etime 60 Make 10 darks of 60 seconds each 9 Error recovery Notes from meeting 30 August, 2000 returns after last shutter close and before readout if returns FAIL use the sync command to be sure all FITS files are notified The ObsTool should handle signals ABORT, STOP and BREAK 10 Issues pattern radius when etype=dither (dither radius 15.0)

The CFH12K Queued Service Observations (QSO) Project: Mission Statement, Scope and Resources

The CFH12K Queued Service Observations (QSO) Project: Mission Statement, Scope and Resources Canada - France - Hawaii Telescope Corporation Société du Télescope Canada - France - Hawaii P.O. Box 1597 Kamuela, Hawaii 96743 USA Telephone (808) 885-7944 FAX (808) 885-7288 The CFH12K Queued Service