Changes between Version 17 and Version 18 of PublicPages/MayallZbandLegacy/NotesforObservers/MosBot


Ignore:
Timestamp:
Mar 14, 2016 8:51:42 AM (9 years ago)
Author:
Dustin Lang
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • PublicPages/MayallZbandLegacy/NotesforObservers/MosBot

    v17 v18  
    1 = MosBot =
     1= Mosbot =
    22
    33Mosbot is a python program that tries to adjust our observing scripts
     
    1919the code is under development and some bugs remain.
    2020
    21 = MosBot Options =
     21= Mosbot Description =
     22
     23Mosbot does two things:
     24
     25- On startup:
     26  * reads the `pass{1,2,3}.json` files given on the command line
     27  * drops exposures that are meant to be taken before the current time
     28  * writes an "overall" script for the night, `~/exec/mosbot/tonight.sh`
     29  * writes "default" mini scripts for each exposure
     30
     31- Then:
     32  * waits for new images to appear in the `$MOS3_DATA` directory
     33  * when a new image appears:
     34    * measures sky, seeing, and transparency from the image
     35    * decides which pass number to observe in the upcoming exposures
     36    * computes exposure times for the upcoming exposures
     37    * overwrites the mini scripts for these upcoming exposures
     38
     39= Mosbot Options =
    2240
    2341* --rawdata=RAWDATA Directory to monitor for new images; $MOS3_DATA by default
     
    3149* -h, --help - show this list
    3250
    33 = MosBot Description =
    34 
    35 Mosbot does two things:
    36 
    37 - On startup, it reads the `pass[123].json` files, drops exposures
    38   that are meant to be taken before the current time, for each exposure writes
    39   two little shell scripts in `~/exec/mosbot/`, and also writes a top-level script
    40   `~/exec/mosbot/tonight.sh`.
    41   It will write default exposure scripts for the whole night.  By default these will be pass 2, using the exposure
    42   times given in the JSON files -- usually 80 seconds.  You can change the default pass number with `--pass`, and
    43   the default exposure time with `--exptime`.  For example, if you are restarting in the middle of the night and
    44   you know the conditions are pass 3, you might want to do this.  These default exposures are what will run, at
    45   least until the first image is taken and appears on disk.  After that, MosBot will be choosing the pass and
    46   exposure time.
    47 
    48 - It then starts waiting for new images to appear in the $MOS3_DATA
    49   directory.  Whenever an image appears, it analyzes it and, based on
    50   the measured conditions (seeing, sky brightness, transparency), it
    51   decides which pass we should be running, and what our exposure times
    52   should be, and it overwrites the little shell scripts in `~/exec/mosbot/` to adjust the next few exposures.
    5351
    5452'''To Stop observing with mosbot (./tonight.sh)'''[[BR]]
     
    7169  touch ~/exec/mosbot/forcepass1
    7270
    73 OR, if you want to forbid pass 1, but allow MosBot to choose between pass 2 or 3, you can create the file:
     71OR, if you want to forbid pass 1, but allow Mosbot to choose between pass 2 or 3, you can create the file:
    7472  touch ~/exec/mosbot/nopass1
    7573
     
    7775After each exposure, the `tonight.sh` script checks for the existence
    7876of the files `~/exec/mosbot/forcepass1`, `~/exec/mosbot/forcepass2`, `~/exec/mosbot/forcepass3`, in that order.
    79 If one of these files exists, MosBot will choose that pass for the upcoming tiles.
     77If one of these files exists, Mosbot will choose that pass for the upcoming tiles.
    8078'''Delete these files if you don't
    8179want to force a certain pass. They will not be deleted automatically
     
    8482== Comments:==
    8583
    86 - MosBot by default starts with PASS 2 observations.  And by default,
     84- Mosbot by default starts with PASS 2 observations.  And by default,
    8785  we set all the exposure times to our minimum exposure time of 80
    8886  seconds.
     87
    8988
    9089- THEREFORE, if you kill mosbot after it has written out the
    9190  `tonight.sh` script, you will run pass 2 with short exposures all
    9291  night long.  This is almost certainly not what we want to happen!!
     92
     93  It will write default exposure scripts for the whole night.  By default these will be pass 2, using the exposure
     94  times given in the JSON files -- usually 80 seconds.  You can change the default pass number with `--pass`, and
     95  the default exposure time with `--exptime`.  For example, if you are restarting in the middle of the night and
     96  you know the conditions are pass 3, you might want to do this.  These default exposures are what will run, at
     97  least until the first image is taken and appears on disk.  After that, Mosbot will be choosing the pass and
     98  exposure time.
     99
     100
    93101
    94102- On the other hand, if you need to run a focus sequence, restart the
     
    103111  `tonight.sh` script.
    104112
    105    **Verify that the quit file has been removed before restarting `tonight.sh`.**
     113   **Verify that the quit file has been removed before restarting `tonight
     114.sh`.**
    106115
    107116- The `tonight.sh` script writes to a file