Skip to main content

Create beautiful quicklook movies from the pixel data observed by NASA's Kepler spacecraft.

Project description

*Create beautiful quicklook movies from the pixel data observed by NASA’s Kepler spacecraft.*

It is good practice to inspect scientific measurements by eye before applying sophisticated data analysis algorithms. K2flix makes it easy to convert the CCD pixel data obtained by NASA’s Kepler space telescope into beautiful movies for human inspection. K2flix takes Kepler’s Target Pixel Files (TPF) as input and turns them into contrast-stretched animated gifs or MPEG-4 movies. These TPF files are publically available from the Kepler archive and the K2 archive.

Example

Asteroids commonly pass in front of Kepler/K2 targets. How many can you spot in this example 2-day animation?

$ k2flix --start 545 --stop 680 --step 1 --fps 12 http://archive.stsci.edu\
/missions/k2/target_pixel_files/c1/201500000/72000/ktwo201572338-c01_lpd-targ.fits.gz

Installation

If you have a working installation of Python on your system, you can install k2flix using pip:

$ pip install git+https://github.com/barentsen/k2flix

Alternatively, you can clone the repository and install from source:

$ git clone https://github.com/barentsen/k2flix.git
$ cd k2flix
$ python setup.py install

K2flix has only been tested under Linux at present. Get in touch if you encounter issues on OS X or Windows.

Using k2flix

Converting a Kepler pixel file to an animated gif:

$ k2flix tpf-file.fits.gz

Converting a Kepler pixel file to an MPEG-4 movie:

$ k2flix -o movie.mp4 tpf-file.fits.gz

K2flix supports reading from web URLs, so you can generate a movie directly from the data archive:

$ k2flix https://archive.stsci.edu/missions/k2/target_pixel_files/c1/201400000/00000/ktwo201400022-c01_lpd-targ.fits.gz

To see all the options, use the --help argument to see the full usage information:

$ k2flix --help
usage: k2flix [-h] [-o filename] [--start IDX] [--stop IDX] [--step STEP]
              [--fps FPS] [--dpi DPI] [--min_percent MIN_PERCENT]
              [--max_percent MAX_PERCENT] [--cmap colormap_name]
              filename [filename ...]

Converts a Target Pixel File (TPF) from NASA's Kepler/K2 spacecraft into a
movie or animated gif.

positional arguments:
  filename              path to one or more Kepler Target Pixel Files (TPF)

optional arguments:
  -h, --help            show this help message and exit
  -o filename           output filename (default: gif with the same name as
                        the input file)
  --start IDX           first frame to show (default: 0)
  --stop IDX            last frame to show (default: -1)
  --step STEP           spacing between frames (default: output 100 frames)
  --fps FPS             frames per second (default: 5)
  --dpi DPI             resolution of the output in dots per K2 pixel
  --min_percent MIN_PERCENT
                        percentile value used to determine the minimum cut
                        level (default: 1.0)
  --max_percent MAX_PERCENT
                        percentile value used to determine the maximum cut
                        level (default: 95.0)
  --cmap colormap_name  matplotlib color map name (default: gray)

Contributing

To report bugs and request features, please use the issue tracker. Code contributions are very welcome.

License

Copyright 2015 Geert Barentsen.

K2flix is free software made available under the MIT License. For details see the LICENSE file.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for k2flix, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size k2flix-1.0.0-py2.py3-none-any.whl (11.4 kB) File type Wheel Python version 3.4 Upload date Hashes View
Filename, size k2flix-1.0.0-py3.4.egg (17.3 kB) File type Egg Python version 3.4 Upload date Hashes View
Filename, size k2flix-1.0.0.tar.gz (8.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page