K2FOV reads a list of potential target positions (J2000 celestial coordinates) and returns whether they are likely to fall within the field of view of K2 during a specified observing campaign.
The code is hosted on Github. Users will need python and numpy installed. Users who would like to produce plots like the one on the right also need to install matplotlib. Users of PyKE will already have these dependencies installed on their system. If you have pip, a python package manager, installed on your machine you can download and install the code by running:
pip install K2fov
Alternatively, users can download the code package from Github (using the button lower-right labeled Download ZIP), unzip the file in a directory, cd to the directory within a shell and run:
python setup.py install
There are a few different ways to execute the code within your shell. The simplest method is to download this file, make it executable, and run it:
./runK2onSilicon.py myTargetList.csv campaignNumber
In the example above you should replace campaignNumber with an integer, 0 for Campaign 0 or 1 for Campaign 1. The code will output two files, i) an updated ascii target list with an extra column flagging targets that land on active silicon, and ii) if matplotlib is intalled, a plot showing where the proposed targets fall on the focal plane. The format for the target list is very strict, you need three columns RA in degrees, Declination in degrees and Kepler magnitude. Headers or other additional columns will cause an execution failure. The code will output a similar file to the one input but with an extra column containing either a 0, 1 or 2, where 0 = not on silicon, 1 = near to the focal plane and worth proposing, and 2 = target is on active silicon.