Changes between Version 25 and Version 26 of PublicPages/MayallZbandLegacy/NotesforObservers/MosBot


Ignore:
Timestamp:
Jan 30, 2017 1:51:41 PM (8 years ago)
Author:
Benjamin Alan Weaver
Comment:

--

Legend:

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

    v25 v26  
    11= Mosbot =
    22
     3[[PageOutline]]
     4
     5== Introduction ==
    36Mosbot is a python program that tries to adjust our observing scripts
    47to adapt to changing conditions through the night.
     
    1922the code is under development and some bugs remain.
    2023
    21 = Mosbot Description =
     24== Mosbot Description = =
    2225
    2326Mosbot does two things:
     
    4144
    4245
    43 = How to stop and restart =
     46== How to stop and restart ==
    4447
    45 If you want to stop and restart observing (eg, to take a focus
     48If you want to stop and restart observing (''e.g.'', to take a focus
    4649sequence), you need to stop both the `tonight.sh` script, and Mosbot:
    4750
    4851* to stop `tonight.sh`: On the `mosaic3` computer where you are running the `tonight.sh` script:
    49 {{{
    50    touch ~/exec/mosbot/quit
    51 }}}
    52 The `tonight.sh` script checks for that `quit` file after each
    53 exposure, so it can take a while before it actually exits, but you
    54 won't lose any data this way.  The `tonight.sh` script deletes that
    55 `quit` file just before it exits, so you don't need to worry about deleting it.
     52  {{{
     53touch ~/exec/mosbot/quit
     54  }}}
     55  The `tonight.sh` script checks for that `quit` file after each
     56  exposure, so it can take a while before it actually exits, but you
     57  won't lose any data this way.  The `tonight.sh` script deletes that
     58  `quit` file just before it exits, so you don't need to worry about deleting it.
    5659* to stop Mosbot, just ctrl-C it.
    5760
     
    6164* THEN run the new `tonight.sh` script
    6265
    63 = During the night =
     66== During the night ==
    6467
    65 '''To Restrict to Pass 2 and/or 3'''
     68=== To Restrict to Pass 2 and/or 3 ===
    6669
    6770If, say, the weather has worsened and is highly variable, then you can force Mosbot to always choose a given
    6871pass for upcoming exposures by creating files:
    6972{{{
    70   touch ~/exec/mosbot/forcepass2
     73touch ~/exec/mosbot/forcepass2
    7174}}}
    7275or
    7376{{{
    74   touch ~/exec/mosbot/forcepass3
     77touch ~/exec/mosbot/forcepass3
    7578}}}
    7679
    7780OR, if you want to forbid pass 1, but allow Mosbot to choose between pass 2 or 3, you can create the file:
    7881{{{
    79   touch ~/exec/mosbot/nopass1
     82touch ~/exec/mosbot/nopass1
    8083}}}
    8184
     
    8891
    8992
    90 = Mosbot command-line options (not usually needed) =
     93== Mosbot command-line options (not usually needed) ==
    9194
    9295* --rawdata=RAWDATA Directory to monitor for new images; $MOS3_DATA by default
     
    102105
    103106
    104 == Comments:==
     107== Comments ==
    105108
    106109- Mosbot by default starts with PASS 2 observations.  And by default,
    107110  we set all the exposure times to our minimum exposure time of 80
    108111  seconds.
    109 
    110112- THEREFORE, if you kill mosbot after it has written out the
    111113  `tonight.sh` script and run the default `tonight.sh` script, you
    112114  will observe pass 2 with short exposures all night long.  This is
    113115  almost certainly not what we want to happen!!
    114 
    115116- You can change the default pass number with `--pass`, and the
    116117  default exposure time with `--exptime`. For example, if you are
     
    120121  disk.  After that, Mosbot will be choosing the pass and exposure
    121122  time.
    122 
    123123- **The `tonight.sh` script is not smart.  If you kill and re-start
    124124  `tonight.sh`, you will start from the beginning of the night (or the
     
    126126  script, PLEASE re-run Mosbot to regenerate an appropriate
    127127  `tonight.sh` script.**
    128 
    129128- The `tonight.sh` script writes to a file
    130129  `~/exec/mosbot/seqnum.txt` to indicate which exposure it is
     
    132131  out which upcoming exposures it should update.  Mosbot by default
    133132  writes exposures 1 through 10 ahead of the current sequence number.
    134 
    135133- Each exposure is split into two scripts.  For example, exposure 3
    136134  happens in `expose-3.sh`, which takes the exposure, and then
     
    138136  exposure 3.
    139137
    140 == About git: ==
     138== About git ==
    141139
    142140- the `~/obsbot` directory is a git checkout of the repository:
    143141  https://github.com/legacysurvey/obsbot
    144 - There is a "MzLS Observer" github account set up to log in with an
    145   ssh key, so you should be able to *git commit* and *git push* any code
     142- There is a "MzLS Observer" !GitHub account set up to log in with an
     143  ssh key, so you should be able to `git commit` and `git push` any code
    146144  changes without having to know any passwords.
    147145
    148146
     147[[BackLinks]]