Standard Star Instructions » History » Version 84

Douglas Tucker, 08/22/2016 05:31 PM

1 14 Douglas Tucker
h1. Standard Star Instructions
2 14 Douglas Tucker
3 78 Douglas Tucker
_(Author:  Douglas Tucker; Created: 29 Aug 2013; Updated: 28 Sep 2013; Updated 5 Aug 2014; Updated 21 Aug 2015; Updated 11 Aug 2016 by DLT and James Lasker; Updated 12 Aug 2016; Updated 22 Aug 2016)_
4 1 Douglas Tucker
5 71 Douglas Tucker
h2. _*Special Instructions for DES Year 4*_
6 1 Douglas Tucker
7 84 Douglas Tucker
During DES Year 4, to help with the absolute calibration of the DES photometric system, we will be inter-mixing special HST CalSpec spectrophotometric standards in with the usual complement of nightly standards.  Not every night will have a CalSpec standard, but many of them will.  The CalSpec standards will be observed as part of the evening/morning twilight standard star observations.  To make things more transparent to the observer, a new standard star picker script has been built that outputs a triad of standards, one of which will be a CalSpec standard (if one is available).   The output for the CalSpec standard will be the name of a json file (e.g., "WD0308-565_CCD_52.json") to be used for that night (not only are there different stars, but, for the CalSpec program, we want to place the CalSpec standard on various CCDs on different nights and use different exposure times -- e.g., the json file "WD0308-565_CCD_52.json" is for placing CalSpec standard WD0308-565 on the DECam CCD 52 -- hence the multiple json files per CalSpec standard).  The json files for the CalSpec standards _*should*_ appear in the SISPI Exposure console menu, just like the json files for the normal nightly standards, but, just in case they don't, you can find them in the CalSpec subdirectory of either of these two directories on observer1/observer2/observer3: 
8 84 Douglas Tucker
9 71 Douglas Tucker
10 84 Douglas Tucker
11 84 Douglas Tucker
(The json scripts for the "normal" nightly standards are also these two main directories, in the "grizY", "Yzirg", "ugrizY", and "Yzirgu" subdirectories.  The names of the subdirectories for the "normal" nightly standards decribe which filters are used -- in particular, whether the u-band filter is used -- and whether one starts with the reddest filter (Y-band) or with the bluest ("u" or "g").) 
12 71 Douglas Tucker
13 82 Douglas Tucker
_*To identify the appropriate triads of standard fields to observe, it is simplest just to run the kentools commands "ephem" and "calspec"  described in the [[Introduction to kentools]].  ("calspec" is the DES Year 4 equivalent of the kentools command "standards" used in previous years.)  Don't bother with standards if the sky is obviously cloudy, though.  ("Obviously cloudy" == any clouds seen by eye outside higher than 20 degrees above the horizon, or moderate to heavy clouds seen on the RASICAM or TASCA displays.  If in doubt, take a full complement of standards.)*_  
14 80 Douglas Tucker
15 1 Douglas Tucker
In additional, a lookup table, with entries in 15-minute increments, can be found here:  "NightlyAndCalSpecStandards.txt": (Currently, it covers nights from August 14-September 5, 2016.)
16 1 Douglas Tucker
17 1 Douglas Tucker
On full DES nights, observe standards during both evening and morning twilight (if sky is clear); on DES half-nights, observe standards during twilight and at the middle-of-the-night switchover.
18 82 Douglas Tucker
19 84 Douglas Tucker
* For evening/morning twilight, observe all 3 standards output by the "calspec" command
20 84 Douglas Tucker
** For the "normal" nightly standards, use the "Yzirg" scripts for evening twilight and the "grizY" scripts
21 84 Douglas Tucker
   for morning twilight and middle-of-the-night switchover observations (but, if you accidentally get this 
22 84 Douglas Tucker
   switched around, it is not a big deal). 
23 71 Douglas Tucker
24 74 Douglas Tucker
* For the middle-of-the-night switchover, observe _*only one_* of the 3 standards output by the "calspec" command -- preferably the high-airmass standard.
25 71 Douglas Tucker
26 83 Douglas Tucker
For reference, here is a table of all standard star fields ("normal" nightly and "calspec") that the observer might expect to see: [[The DES Year 4 Standard Fields]].
27 75 Douglas Tucker
28 71 Douglas Tucker
h2. General Instructions (Primarily for DES Years 1, 2, 3, and likely 5)
29 23 Douglas Tucker
30 68 Douglas Tucker
_*To cut to the chase, it is simplest just to run the kentools commands "ephem" and "standards"  described in the [[Introduction to kentools]] to find the appropriate triads of standard fields to observe.  If, however, you prefer tabulated lists, read the following and see the standard star look-up tables for each month below.  Don't bother with standards if the sky is obviously cloudy, though.  ("Obviously cloudy" == any clouds seen by eye outside higher than 20 degrees above the horizon, or moderate to heavy clouds seen on the RASICAM or TASCA displays.  If in doubt, take a full complement of standards.)*_
31 58 Douglas Tucker
32 69 Douglas Tucker
* Standard star fields are to be observed every evening and morning twilight (and, for half nights,  at switchover) that appear to be clear, where "clear" is determined by a quick visual inspection of the RASICAM image, of the TASCA image, or of the sky itself.  If in doubt, assume the sky is clear and take a full complement of standards.
33 1 Douglas Tucker
34 69 Douglas Tucker
* For evening twilight, the standards can begin about 45 minutes before the end of Astronomical (18-deg) Twilight.  If there is a late start, standards can continue until the end of Astronomical Twilight; after the end of Astronomical Twilight twilight, survey science observations must begin.
35 37 Douglas Tucker
36 1 Douglas Tucker
* For morning twilight, the standards should start 25 minutes after the start of Astronomical (18-deg) Twilight.
37 14 Douglas Tucker
38 69 Douglas Tucker
* If possible, for each twilight period, 3 standard star fields should be observed:  one at low airmass (X<1.25), on at medium airmass (X=1.25-1.65), and one at high airmass (X=1.65-2.10).  It is generally better to observe the high-airmass field first, since its airmass will be changing the most rapidly. _[Added 16 Dec 2013:]_ If you are comfortable doing so, you can try to arrange the observing sequence of the intermediate- and low-airmass fields so as to reduce slew time.
39 20 Douglas Tucker
40 69 Douglas Tucker
* For half-nights, 1 or 2 fields -- preferably a low-airmass field and a high-airmass field -- should be observed just before switchover.  (If only one field, a high-airmass field is preferred.)
41 1 Douglas Tucker
42 1 Douglas Tucker
* The list of DES standard star fields can be found here:  [[The Standard Fields]].  Note that they 
43 69 Douglas Tucker
are broken into 3 types:  a "Golden" sample, a "Silver" sample, and a "Bronze" sample.  The "Golden"
44 69 Douglas Tucker
sample fields, which have photometrically calibrated standards in all 5 DES filters (grizY) over the full DECam focal plane, take precedence.  The "Silver" and "Bronze" either are missing calibrated Y-band data or do not have calibrated standards just yet over the full DECam focal plane.  *Always make sure that at least one "Golden" (SDSS) standard star field is observed each clear night.*
45 51 Kevin Reil
46 69 Douglas Tucker
* For evening twilight, use the *DES/standard/Yzirg* scripts (which start with Y-band and end with g-band); for morning twilight or pre-switchover, use the *DES/standard/grizY* scripts (which start with g-band and end with Y-band).   (For those rare nights when we also observe in u-band, please use the corresponding "DES/standard/Yzirgu" and "DES/standard/ugrizY" scripts.)
47 63 Thomas Diehl
48 69 Douglas Tucker
* The script *DES/defocus_nightly.json* should be appended to the last evening standard. No "break" is needed.  The script stays on the last standard field, defocuses, takes a single r-band image and refocuses. Obstac can continue on from this point without trouble. If this script *fails* and the camera is out of focus press the z-trim button on the ICS screen. This nightly defocus script should be run about once a week. Keep track in elog and announce at the 4 o'clock meeting.
49 14 Douglas Tucker
50 69 Douglas Tucker
* There are several useful scripts in the StdStarPicker package in the DECamObserver account on observer2, including and
51 14 Douglas Tucker
52 54 Douglas Tucker
* To get a full list of standard star fields that are in a good position to observe (airmass < 2.10, 
53 69 Douglas Tucker
moon separation > 15 deg, within Blanco horizon limits), use
54 14 Douglas Tucker
55 14 Douglas Tucker
56 14 Douglas Tucker
  source ~/dtucker/bin/setup_StdStarFieldPicker.csh      (or .bash if you are using bash shell)
57 14 Douglas Tucker
58 14 Douglas Tucker --help                       (for detailed help)
59 17 Douglas Tucker --UT=now                     (for a list accessible right now)
60 1 Douglas Tucker --UT='2013/09/17 00:43'      (for a list accessible at 00:43UT on Sept 17, 2013)
61 16 Douglas Tucker
62 54 Douglas Tucker
63 54 Douglas Tucker
64 55 Douglas Tucker
* To get a preferred triad of standard fields -- a low-airmass field, a medium-airmass field, and a
65 69 Douglas Tucker
high-airmass field -- for a given time and date, use *(Note:  the kentools command "standards" is a wrapper for this python script)*:
66 1 Douglas Tucker
67 17 Douglas Tucker
68 73 Douglas Tucker
  source ~/dtucker/bin/setup_StdStarFieldPicker.csh        (or .bash if you are using bash shell)
69 14 Douglas Tucker
70 73 Douglas Tucker --help                     (for detailed help)
71 73 Douglas Tucker --UT=now -v                (for a triad accessible right now)
72 73 Douglas Tucker --UT='2013/09/17 00:43' -v (for a triad accessible at 00:43UT on Sept 17, 2013)
73 1 Douglas Tucker
74 1 Douglas Tucker
  (Warning: will output a default json file, "stdstar.json".  Just ignore it.)
75 1 Douglas Tucker
76 1 Douglas Tucker
77 1 Douglas Tucker
78 66 Douglas Tucker
* *For simplicity, look-up tables -- one for each month of DES Year 2 Operations -- listing the preferred triad for each 15-min interval throughout each night, can be found here:*
79 41 Douglas Tucker
80 65 Douglas Tucker
> * "*listOfStdsByUT.Aug2015.txt*": 
81 57 Douglas Tucker
82 65 Douglas Tucker
> * "*listOfStdsByUT.Sep2015.txt*":
83 57 Douglas Tucker
84 65 Douglas Tucker
> * "*listOfStdsByUT.Oct2015.txt*":
85 57 Douglas Tucker
86 65 Douglas Tucker
> * "*listOfStdsByUT.Nov2015.txt*":
87 57 Douglas Tucker
88 65 Douglas Tucker
> * "*listOfStdsByUT.Dec2015.txt*":
89 57 Douglas Tucker
90 65 Douglas Tucker
> * "*listOfStdsByUT.Jan2016.txt*":
91 57 Douglas Tucker
92 65 Douglas Tucker
> * "*listOfStdsByUT.Feb2015.txt*":
93 60 Douglas Tucker
94 64 Douglas Tucker
(Old Year 1 and Year 2 versions can be found in the attached files below.  Note that the tables vary year-to-year, since Moon-avoidance is built into these tables and the Standard Star Picker tool from which these tables were derived.)
95 61 Douglas Tucker
96 21 Douglas Tucker
* _*You can also just run the the kentools commands "ephem" and "standards" described in the [[Introduction to kentools]] to find the appropriate triads of standard fields to observe.  This is usually the simplest option.*_
97 21 Douglas Tucker
98 1 Douglas Tucker
h2. Attachments