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


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

--

Legend:

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

    v16 v17  
    44to adapt to changing conditions through the night.
    55
    6 Run it by logging in to the *mzls@mayall-idl* machine and then running:
     6Run it by logging in to the `mzls@mayall-idl` machine and then running:
    77{{{
    88cd ~/obsbot
     
    2121= MosBot Options =
    2222
    23 * --rawdata=RAWDATA Directory to monitor for new images
    24 * --script=SCRIPTFN  Write top-level shell script, default is /mosaic3/exec/mosbot/tonight.sh
     23* --rawdata=RAWDATA Directory to monitor for new images; $MOS3_DATA by default
     24* --script=SCRIPTFN  Write top-level shell script, default is ~/exec/mosbot/tonight.sh
    2525* --no-write-script 
    2626* --ext=EXT  Extension to read for computing observing conditions, default im4
    2727* --tiles=TILES      Observation status file, default obstatus/mosaic-tiles_obstatus.fits
    2828* --pass=PASSNUM     Set default pass number (1/2/3), default 2
    29 * --exptime=EXPTIME  Set default exposure time, default whatever is in the JSON files, usually 80 sec
     29* --exptime=EXPTIME  Set default exposure time, default is to use whatever exposure time is in the JSON files, usually 80 sec
    3030* --no-cut-past      Do not cut tiles that were supposed to be observed in the past
    3131* -h, --help - show this list
     
    3737- On startup, it reads the `pass[123].json` files, drops exposures
    3838  that are meant to be taken before the current time, for each exposure writes
    39   two little shell scripts in `/mosaic3/exec/mosbot/`, and also writes a top-level script
    40   `/mosaic3/exec/mosbot/tonight.sh`
     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.
    4147
    4248- It then starts waiting for new images to appear in the $MOS3_DATA
     
    4450  the measured conditions (seeing, sky brightness, transparency), it
    4551  decides which pass we should be running, and what our exposure times
    46   should be, and it overwrites the little shell scripts in `/mosaic3/exec/mosbot/` to adjust the next few exposures.
     52  should be, and it overwrites the little shell scripts in `~/exec/mosbot/` to adjust the next few exposures.
    4753
    4854'''To Stop observing with mosbot (./tonight.sh)'''[[BR]]
     
    5157   touch ~/exec/mosbot/quit
    5258}}}
    53 After each exposure, the `tonight.sh` script checks for the existence of the file `/mosaic3/exec/mosbot/quit`.  If that file exists,
     59After each exposure, the `tonight.sh` script checks for the existence of the file `~/exec/mosbot/quit`.  If that file exists,
    5460the script will quit after a readout (without slewing).  This should ensure that we don't lose any data, and is the way the `tonight.sh` script should be stopped.  (It will delete the `quit` file just before it quits.) ''''This doesn't stop mosbot on mayall-idl''''.
    5561
     
    6571  touch ~/exec/mosbot/forcepass1
    6672
    67 Alternately,
    68   touch ~/exec/mosbot/quit
    69   cd ~/obsbot (on mayall-idl)
    70   python mosbot.py --pass=PASSNUM pass1.json pass2.json pass3.json
    71 }}}
    72 After each exposure, the `tonight.sh` script checks for the existence of the files `/mosaic3/exec/mosbot/forcepass2`, etc. If any of
    73 these files exist, the pass is forced in tonight.sh in priority order forcepass1, forcepass2, forcepass3. '''Delete these files if you don't want to force certain passes. They will not be deleted automatically when restarting mosbot or running `tonight.sh`.'''
     73OR, if you want to forbid pass 1, but allow MosBot to choose between pass 2 or 3, you can create the file:
     74  touch ~/exec/mosbot/nopass1
     75
     76
     77After each exposure, the `tonight.sh` script checks for the existence
     78of the files `~/exec/mosbot/forcepass1`, `~/exec/mosbot/forcepass2`, `~/exec/mosbot/forcepass3`, in that order.
     79If one of these files exists, MosBot will choose that pass for the upcoming tiles.
     80'''Delete these files if you don't
     81want to force a certain pass. They will not be deleted automatically
     82when restarting mosbot or running `tonight.sh`.'''
    7483
    7584== Comments:==
    7685
    77 - mosbot by default starts with PASS 2 observations.  And by default,
     86- MosBot by default starts with PASS 2 observations.  And by default,
    7887  we set all the exposure times to our minimum exposure time of 80
    7988  seconds.
     
    8897  script to generate a new `tonight.sh` script before you re-start observing.
    8998
    90 - **The `tonight.sh` script is not smart.  Each exposure is written to a
    91   script, and the scripts are numbered.  If you kill and re-start
     99- **The `tonight.sh` script is not smart.  If you kill and re-start
    92100  `tonight.sh`, you will start from the beginning of the night (or the
    93101  last time mosbot was run).  If you have to stop the `tonight.sh`
     
    98106
    99107- The `tonight.sh` script writes to a file
    100   `/mosaic3/exec/mosbot/seqnum.txt` to indicate which exposure it is
     108  `~/exec/mosbot/seqnum.txt` to indicate which exposure it is
    101109  currently running.  The `mosbot.py` script reads that file to figure
    102110  out which upcoming exposures it should update.  Mosbot by default
    103   writes 1, 2, and 3 exposures ahead of the current sequence number.
     111  writes exposures 1 through 10 ahead of the current sequence number.
    104112
    105113- Each exposure is split into two scripts.  For example, exposure 3