| 39 | | = Mosbot Options = |
| | 39 | |
| | 40 | = How to stop and restart = |
| | 41 | |
| | 42 | If you want to stop and restart observing (eg, to take a focus sequence), you need to stop both the `tonight.sh` script, and Mosbot: |
| | 43 | |
| | 44 | * to stop `tonight.sh`: [[BR]] |
| | 45 | On the mosaic3 computer where you are running the `tonight.sh` script: |
| | 46 | {{{ |
| | 47 | touch ~/exec/mosbot/quit |
| | 48 | }}} |
| | 49 | The `tonight.sh` script checks for that `quit` file after each exposure, so it can take a while before it actually exits, |
| | 50 | but you won't lose any data this way. The `tonight.sh` script deletes that `quit` file just before it exits. |
| | 51 | |
| | 52 | * to stop Mosbot, just ctrl-C it. |
| | 53 | |
| | 54 | To restart, |
| | 55 | |
| | 56 | * FIRST restart mosbot. It will write out a new `tonight.sh` |
| | 57 | * THEN run the new `tonight.sh` script |
| | 58 | |
| | 59 | |
| | 60 | = During the night = |
| | 61 | |
| | 62 | '''To Restrict to Pass 2 and/or 3'''[[BR]] |
| | 63 | |
| | 64 | If, say, the weather has worsened and is highly variable, then you can force Mosbot to always choose a given |
| | 65 | pass for upcoming exposures by creating files: |
| | 66 | {{{ |
| | 67 | touch ~/exec/mosbot/forcepass2 |
| | 68 | }}} |
| | 69 | or |
| | 70 | {{{ |
| | 71 | touch ~/exec/mosbot/forcepass3 |
| | 72 | }}} |
| | 73 | |
| | 74 | OR, if you want to forbid pass 1, but allow Mosbot to choose between pass 2 or 3, you can create the file: |
| | 75 | {{{ |
| | 76 | touch ~/exec/mosbot/nopass1 |
| | 77 | }}} |
| | 78 | |
| | 79 | These files are NOT deleted by the `tonight.sh` script or by Mosbot, and will remain in effect until you delete them! |
| | 80 | |
| | 81 | Note that it is Mosbot that pays attention to these files (not `tonight.sh`); they affect what it chooses to schedule for upcoming exposures. |
| | 82 | |
| | 83 | |
| | 84 | = Mosbot command-line options (not usually needed) = |
| 52 | | '''To Stop observing with mosbot (./tonight.sh)'''[[BR]] |
| 53 | | On the mosaic3 computer where you are running the NOCS script: |
| 54 | | {{{ |
| 55 | | touch ~/exec/mosbot/quit |
| 56 | | }}} |
| 57 | | After each exposure, the `tonight.sh` script checks for the existence of the file `~/exec/mosbot/quit`. If that file exists, |
| 58 | | the 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''''. |
| 59 | | |
| 60 | | '''To Restrict to Pass 2 and/or 3'''[[BR]] |
| 61 | | |
| 62 | | If you have started mosbot in all three passes (i.e., using python mosbot.py pass1.json pass2.json pass3.json as above) and now |
| 63 | | want to restrict the choice of passes because, say, the weather has worsened and is highly variable, '''without terminating the `tonight.sh` script''', then |
| 64 | | {{{ |
| 65 | | touch ~/exec/mosbot/forcepass2 |
| 66 | | or |
| 67 | | touch ~/exec/mosbot/forcepass3 |
| 68 | | to return to pass1, |
| 69 | | touch ~/exec/mosbot/forcepass1 |
| 70 | | |
| 71 | | OR, if you want to forbid pass 1, but allow Mosbot to choose between pass 2 or 3, you can create the file: |
| 72 | | touch ~/exec/mosbot/nopass1 |
| 73 | | |
| 74 | | |
| 75 | | After each exposure, the `tonight.sh` script checks for the existence |
| 76 | | of the files `~/exec/mosbot/forcepass1`, `~/exec/mosbot/forcepass2`, `~/exec/mosbot/forcepass3`, in that order. |
| 77 | | If one of these files exists, Mosbot will choose that pass for the upcoming tiles. |
| 78 | | '''Delete these files if you don't |
| 79 | | want to force a certain pass. They will not be deleted automatically |
| 80 | | when restarting mosbot or running `tonight.sh`.''' |
| 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. |
| | 108 | - You can change the default pass number with `--pass`, and the default exposure time with `--exptime`. For example, if you are restarting in the middle of the night and you know the conditions are pass 3, you might want to do this. These default exposures are what will run ONLY until the first image is taken and appears on disk. After that, Mosbot will be choosing the pass and exposure time. |
