Summary
- Consult
the on-line
Keck observing schedule. Note that the dates are HST, not UT
dates.
- The third column of the table indicates the account you
have been assigned. For example, if it reads nirc5, use
this account name (all lowercase) when launching VNCs.
Available NIRC2 user accounts are nirc1, and nirc3
to nirc9. There is NO user account named nirc2 to
prevent confusion with the instrument name.
Whether observing from Waimea, from an official remote observing
site, or from home, NIRC2 observers should run all instrument
software within VNC desktops. Generally, VNC servers for your run
should be up and running when you arrive to observe. Please follow
the appropriate set of steps below to launch your VNC viewers.
Remote startup procedure from home
The procedure to launch VNC viewers from home requires
previous installation of
the Keck
remote observing software. Once the software has been installed:
-
Open a terminal on your local computer.
-
Navigate to the directory where the remote observing software was
installed.
-
Launch VNCs with the following command:
./start_keck_viewers nircN
Remote startup procedure from official remote observing sites
The procedure to launch VNC viewers from official remote observing
sites varies from site to site. Most remote observing sites have the
Keck remote observing software installed in their computers and the
startup procedure should be similar to what you would do if you were
observing from home.
In any case, please, check the VNC startup instructions at your
remote observing site and contact the Site Manager if you have
any questions.
Waimea startup procedure
Computers in the Waimea remote observing rooms have the Keck remote
observing software installed. There are two computers with 4
monitors each available for visiting observing teams. There is an
additional computer for Observing Assistants when they operate the
telescope from Waimea instead of on the summit.
Please, contact your SA if it is not clear to you which
computer to use for observing. Your SA will also help you with the
login information to the observing computers.
The procedure to launch the VNCs is:
- Login to one of the observing computers.
- User: observer
- Password: See your Staff Astronomer (SA)
- Launch primary VNC desktops.
- Open a terminal
- Type: start_keck_viewers nirc5 (assuming that
your assigned account for the night is nirc5.)
- Start Firefox. (This can be started on any of the VNCs,
but due to the final arrangement of the NIRC2 GUIs, it is
convenient to start Firefox on the telstatus VNC.
- Right-click in the background
- Select Firefox: NIRC2 Home Page
- Read the NIRC2 News.
- Click on the link labeled NEWS
from left-side menu
- Check instrument availability.
- Click on the link
labeled Instrument
Ready? from left-side menu to check for instrument release.
- Possible Messages:
- NIRC2 READY = continue with this checklist
- NIRC2 NOT READY = please wait
Electronic logsheets
Paper logsheets
- Select your preferred logsheet format on
the NIRC2 logsheets
webpage
- Print logsheets to the nearest available printer
- Start up the NIRC2 software
- Right click on the VNC background to access the NIRC2 menu.
- Select NIRC2 Control → Start NIRC2 Software
- Verify windows.
Check that the following windows are present:
| Window |
Function |
| Control0
desktop |
| waikoko-new terminal |
Control interface with the instrument |
| Control1
desktop |
| waikoko-new terminal |
Control interface with the instrument |
| NIRC2 Status GUI |
Non-interactive GUI that shows the status of the NIRC2
detector, mechanisms, output data directory and other useful
information.
|
| Quicklook GUI: NIRC2 |
Displays NIRC2 images in real time |
| Compas Rose (i) |
Shows the NIRC2 detector orientation with respect to
the (RA,DEC) and (Alt,Az) reference systems |
| watch_alad iconified terminal |
Pops up a warning message if one of the alad
processes dies |
| watch_pmr iconified terminal |
Automatically restarts the pupil mask rotator software
on waikoko (old Solaris host) if the process dies
or hungs |
| watch_quicklook iconified terminal |
Automatically restarts the NIRC2 quicklook GUI if it
dies |
| LUI status GUI |
Shows status of the different AO loops |
| Control2
desktop |
| waikoko-new terminal |
Control interface with the instrument |
| Facility Summary (FACSUM) GUI |
Show overall telescope status |
| MET GUI |
Show information from the Keck weather station |
| MAGIQ Observer UI |
Visualize and manage target list during observations |
| Nirc2 eventsounds GUI |
Control of instrument sounds |
| Program Identification GUI (PIG) |
Handles program ID, observer list and output data directory |
| telstatus
desktop |
| waikoko-new terminal |
Control interface with the instrument |
In addition to bringing up the GUIs and control terminals, the NIRC2
startup script also creates the directory structure adequate for the
night.
Select your program on
the PIG
Click on the radio button next to your program code on the
Program Identification GUI (PIG). This will automatically set
the following fields:
-
Output data directory where the NIRC2 FITS files will be
saved.
-
Program ID on the Program information area of
the NIRC2 Status GUI. This value is
automatically grabbed from the telescope schedule.
-
Observers list on the Program information area
of the NIRC2 Status GUI. This value
is automatically grabbed from the telescope schedule.
If you would like to update the observers list, simply edit the
corresponding field on the PIG and press the Set button.
IMPORTANT NOTE for ToO triggers and NIRC2/NIRC2 split
nights: If this is a NIRC2/NIRC2 split night or
there is a ToO trigger, make sure to select the correct
program on the PIG before taking data. This will ensure that the
images are saved in the correct data directory, and that the
correct ownership is assigned to the data in the Keck
Observatory Archive (KOA).
Select sounds
The NIRC2 eventsounds
utility will make user-selectable noises when:
- ExposureComplete: Image is done exposing
- SequenceComplete: Sequence within a script is done
- ScriptComplete: Script execution is completed
Click on the available menus to select the sounds of your choice
for your late-night entertainment.
Play samples
You can play a sample of the currently-selected sound by clicking
the right mouse button on the label for the sound. If you do
not hear the sound immediately, verify that your computer sounds are
not muted. If you are using a computer with external speakers, make
sure the speakers are powered on and that volume is turned up.
-
Close NIRC2 shutter:
If
the NIRC2 status GUI
indicates that the shutter open, then close it by
typing shutter close on a waikoko-new
terminal. The shutter value in the Motor status of
the NIRC2 status GUI should change to closed once the
stage has finished moving.
- Set exposure parameters:
Type the following
commands on a waikoko-new terminal:
object dark [Set object name]
subc 1024 [Set detector array size to maximum 1024x1024 pix]
sampmode 2 [Set readout mode to CDS - Correlated Double Sampling]
coadd 1 [Set number of coadditions to 1]
itime 1 [Set exposure time to 1 second]
You should shee the exposure parameters updated in
the Detector status section of
the NIRC2 status GUI as you
type the commands on the waikoko-new terminal.
- Start dark exposure:
Type goi to start the dark exposure.
- Wait for image to be saved on disk:
The dark image
should be displayed in
the NIRC2 quicklook GUI
once the exposure is completed.
Use the NIRC2 quicklook GUI to
make a vector cut across your image, graphing pixel values as a
function of position.
-
Select the Raw channel and click the Operations
button (below the main display area) and select Analysis →
Cuts.
-
Right-click at the point on the displayed image where you would
like to start the projection cut.
-
Release the mouse button once you are happy with the selected
region.
-
Inspect the Cuts plot on the Dialogs tab (upper
right area of the GUI.)
The nominal 1-second dark frame should have about 4 counts on
average, and a peak-to-peak variation of less than 10 counts. Ask
your SA in case of doubt when assessing the quality of the dark
frame.
Automated method
To acquire arcs and flats automatically (preferred method) use the
Slitmask Calibration Tool (Widget):
- DEIMOS Utilities -→
Slitmask Calibration Tool from the background menu to
launch the gui.
- Click the checkbox next to the desired masks
- Confirm number of exposures and exposure times. Note that
exposure times are set for 1 arcsec slits.
- Click GO to initiate the sequence of
exposures.
For more information please see the
Slitmask Calibration Tool (Widget)
Manual method
To acquire arcs and flats manually:
-
Close the DEIMOS hatch to block dome light.
-
Set the grating, central wavelength, filter, and dewar
focus appropriately.
-
Start FCS tracking (if desired) and wait for it to
lock.
-
If needed, take a test 1 second Qz internal flat (use the
goibuf command) and determine
the appropriate exposure time for your flats (goal is about
30,000 DN maximum).
-
Launch the widget from the DEIMOS background menu via
DEIMOS Utilities → Slitmask Calibration Tool.
-
Select the masks to be calibrated using the current
grating/wavelength/filter combination, the number of arcs
and flats to acquire, the exposure times to use, and the
arcs lamps to use.
-
Click GO to begin data acquisition.
The normal set of 1 NeArKrXe arc and 3 internal flats will take
about 8 minutes per mask to complete. Selecting the Cd or Zn
lamps will require additional time.
You will need to create a “starlist” file listing your
target names and coordinates. You can do this in either of two ways:
Automated starlist (strongly recommended)
Create a starlist based on the output files
from DSIMULATOR:
- Download the
file deimos_startlist.tar
-
Extract the Python script:
tar -xvf deimos_starlist.tar
-
Run the script using Python 3:
python deimos_starlist.py *.out
where "*.out" are the DSIMULATOR output files
-
The resultant file is called starlist_YYYMMDD.dat
-
Upload your resultant list to Keck using
the Keck
observer page as follows:
-
Enter your username and password to log in.
- Click on the link reading Manage your target lists
here to access the Target List Management
page.
-
Click on Upload followed by Browse... and select
the starlist on your local computer.
-
Click on the Upload Now button. This uploads the starlist
to the Keck system.
- Confirm that file contents shown on the File Preview
window look okay.
Once uploaded through the web interface, your starfile can be
found in the directory
/kroot/starlists/web/username, where
username generally includes your first initial and
last name.
Hand-crafted starlist
We strongly discourage using this method because it is prone
to human error when typing the mask coordinates and position
angle. A typo in the starlist can lead to confusion during mask
alignment at night and incur lost observing time.
Use a text editor to create and format your starlist as described
here. If you have done this
on your laptop, you can then upload the starlist file via our web
interface:
- In a browser window, load the
Keck
Observer Login page.
- Enter your username and password to log in.
- Click on the link reading Manage your target lists
here to access the Target List Management
page.
-
Click on Upload followed by Browse... and select
the starlist on your local computer.
-
Click on the Upload Now button. This uploads the starlist
to the Keck system.
- Confirm that file contents shown on the File Preview
window look okay.
Once uploaded through the web interface, your starfile can be
found in the directory
/kroot/starlists/web/username, where
username generally includes your first initial and
last name.
Observing Assistants customarily arrive at the summit (or HQ,
if remote controlling) around 5:30pm. Once they arrive, you
can do the following:
-
Greet the OA. Introduce yourself to the OA and alert them
to any immediate needs that you will have, such as wanting to
take dome flats if your program requires direct imaging data.
-
Wait for the OA to get settled. Setting up computers
and bringing up all of the telescope control systems
requires some time, and things go wrong much more often than
we would prefer. Be patient while the OA prepares the
telescope for operation.
-
Take dome flats if needed. When the OA gives you
permission to proceed, begin taking dome flats.
-
Inform the OA about your starlist. Now would be a good
time to let the OA know where your starlist is, so they can
verify that they have access to it.
You're tired and hungry and there's a long night ahead. If you
happen to be observing from Waimea, better get out the folder
labeled Restaurant Dining Guide and select one of our fine
local eateries to provide you with sustenance.
Sunset is getting close; continue with the procedures listed on
the Evening Startup Checklist.