naco-ispy

Python tools for the NACO-ISPY survey

This repository contains two main functions:

The automated reduction pipeline. This consists of three submodules: a data organiser, a database tool and a module that scrapes information from the headers of files (for making summary files and checking that a sequence is consistent and ready to process).
The real-time analysis code. This is an infinite loop that you can run on the offline machine at Paranal, and it will plot important information about the data as it arrives.

Real-time analysis code:

This is intended to be run on the offline machine at Paranal, and monitors a folder for incoming data. It will detect changes in the OB name and reset the plots so that you only need to run it once. Unfortunately it will not plot anything until it finds a sky frame, since it can't find the peak or estimate the background level without a sky. For non-AGPM frames, it will wait until it has at least 2 frames. There is a set of logic that helps it to decide whether a file is a flux, sky or regular target observation. It uses the exposure time, number of exposures and detector windowing to decide.

To run it, put monitor.py somewhere on the NACO offline machine, then run

> python monitor.py

When run in this way, monitor.py will work out the current date and run the function "run_and_process" on the directory /data-ut1/raw/year-month-day/ . If this fails, you can start it manually using the following commands (in the same directory as the file)

> python
> import monitor
> monitor.run_and_process(folder='/path/to/the/data/')

When you are finished with it, press ctrl+c to exit.

You can download the monitor.py file individually using wget: > wget https://rawgit.com/AnthonyCheetham/naco_ispy/master/monitor.py

###Advanced Options:

prefix (default='NACO') + suffix (default='.fits'): To find the files, it looks for prefix+'*'+suffix. So if your files are named differently, change these.
pause_interval (default=2): The number of seconds to wait between updates.
crop_size (default=500): The number of pixels to consider. 1024x1024 images are slow to process, so this will cut the images down (around the centre) before processing.
new_only (default=True): This switch allows you to look at all files in the directory, or just those that were added after the program started.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.