Changes between Version 16 and Version 17 of PublicPages/MayallZbandLegacy/NotesforObservers/Copilot

Timestamp:

Mar 14, 2016 9:53:37 AM (8 years ago)

Author:

Dustin Lang

Comment:

--

PublicPages/MayallZbandLegacy/NotesforObservers/Copilot

@@ -2 +2 @@
 
 `copilot.py` is a script that watches for new images, measures them,
-and produces a plot, `recent.png` to help observers understand what
+and produces a plot to help observers understand what
 the conditions are doing.
 
@@ -11 +11 @@
 }}}
 
-It will monitor the $MOS3_DATA directory, and whenever a new image
+It will monitor the `$MOS3_DATA` directory, and whenever a new image
 comes it, it will measure it, update a little database, and create a
 "strip plot" showing the conditions.  The plot should be shown in a python plot window.
-The plot is also saved to the file "recent.png"; you could for example view it using
+The plot is also saved to the file `recent.png`; you could for example view it using
 {{{
 eog recent.png &
@@ -23 +23 @@
 The database is in `~/obsbot/obsdb/mosaic3.sqlite3` for MzLS.
 
+If you want to make a plot showing your whole night, you can do
+{{{
+python copilot.py --night
+}}}
+and it will save the plot `night.png`.
 
-== Copilot Options ==
+
+== Copilot Options (not usually needed) ==
 
 
@@ -51 +57 @@
 == Things to Watch For on the Copilot Plot==
 
-* Vertical red line accompanied by lack of purple points
+* Vertical red line labelled *MISSING IMAGE!*
 
-This is BAD and signifies that no images have been written out since the last purple point. When this occurs
+This can be BAD -- it signifies that no images have been written out since the last purple point. When this occurs,
 check if you have been taking data. It means that while the telescope may be offsetting and camera opening 
-and closing the shutter properly, no files are being written out! Need to stop (using "touch quit") and restart
+and closing the shutter properly, no files are being written out! Need to stop (using "touch ~/exec/mosbot/quit") and restart
 MOSAIC3 software. Sigh.
 
@@ -82 +88 @@
   stop observing.
   This problem is described [[https://desi.lbl.gov/trac/wiki/PublicPages/MayallZbandLegacy/NotesforObservers/Problems#a4.Shiftedimages here]]
-* (unlabelled bar) -- it has been a while since the last image has been seen.  Have images stopped being written?  See problem description [[https://desi.lbl.gov/trac/wiki/PublicPages/MayallZbandLegacy/NotesforObservers/Problems#a0.Noimagesbeingwritten here]]  
+* MISSING IMAGE -- it has been a while since the last image has been seen.  Have images stopped being written?  See problem description [[https://desi.lbl.gov/trac/wiki/PublicPages/MayallZbandLegacy/NotesforObservers/Problems#a0.Noimagesbeingwritten here]]  
 
 The second panel shows the Sky brightness.  The "nominal" brightness
@@ -101 +107 @@
 the "post-facto" target exposure time is below or above the bounds, it
 is shown with a triangle, and a circle will also be plotted at the
-lower or upper bound line. Obviously triangles above the upper bound indicate images that might not be as deep as desired. Triangles below the lower bound are also a concern since observing time is scarce.
+lower or upper bound line.  Triangles above the upper bound indicate
+images that might not be as deep as desired.
 
 **[depth factor has been removed from the plot. This description is useful when looking at plots created before about February 2016]** The "depth factor" plot just shows our actual exposure time divided by
@@ -111 +118 @@
 The final panel is a strip chart showing the RA and DEC offsets from tile center determined post facto. When offsets are greater than a total of 10", the telescope zero point should be updated. Pointing and tracking are currently excellent at the Mayall. **The actual telescope pointing updates should be made using output from mosstat. Thus the copilot plot may show non zero, but constant offsets.** The goal is to get the mosstat and copilot zero points to agree. 
 
-Note that zeros will not show up on the plot.  The times of focus frames will be marked with a black dot labelled "F".
+Focus frames will be marked with a dot labelled "F", and Zero frames will be marked "Z".