Skip to content

PynPoint is a Python package for processing and analysis of high-contrast imaging data

License

Notifications You must be signed in to change notification settings

jasperjonker/PynPoint

 
 

Repository files navigation

PynPoint

Pipeline for processing and analysis of high-contrast imaging data

https://img.shields.io/badge/Python-2.7%2C%203.6%2C%203.7-yellow.svg?style=flat https://travis-ci.org/PynPoint/PynPoint.svg?branch=master https://readthedocs.org/projects/pynpoint/badge/?version=latest https://coveralls.io/repos/github/PynPoint/PynPoint/badge.svg?branch=master https://www.codefactor.io/repository/github/pynpoint/pynpoint/badge http://img.shields.io/badge/arXiv-1811.03336-orange.svg?style=flat

PynPoint is a generic, end-to-end pipeline for the data reduction and analysis of high-contrast imaging data of planetary and substellar companions, as well as circumstellar disks in scattered light. The package is stable, has been extensively tested, and is available on PyPI. PynPoint is under continuous development so the latest implementations can be pulled from Github repository.

The pipeline has a modular architecture with a central data storage in which all results are stored by the processing modules. These modules have specific tasks such as the subtraction of the thermal background emission, frame selection, centering, PSF subtraction, and photometric and astrometric measurements. The tags from the central data storage can be written to FITS, HDF5, and text files with the available I/O modules.

To get a first impression, there is an end-to-end example available of a SPHERE/ZIMPOL H-alpha data set of the accreting M dwarf companion of HD 142527, which can be downloaded here.

Documentation

Documentation can be found at http://pynpoint.readthedocs.io, including installation instructions, details on the architecture of PynPoint, and a description of all the pipeline modules and their input parameters.

Installation from Github.com:

  • Create a virtualenv:
python3 -m venv virtualenv
  • Clone the repository in the desired folder
git clone https://github.com/404NotFoundv2/PynPoint.git
  • Add in the config file of your virtualenv (in venv/bin/activate):
export PYTHONPATH="/path/to/the/pynpoint_folder"
  • Activate the virtualenv:
source virtualenv/bin/activate
  • Install the required packages:
python3 -m pip install --upgrade pip
python3 -m pip install -r PynPoint/requirements.txt

For me:

export PYTHONPATH="/scratch/jjonker/jasper/lib/python2.7/site-packages/PynPoint/"
export alias vim="~/vim/bin/vim"

Mailing list

Please subscribe to the mailing list if you want to be informed about new functionalities, pipeline modules, releases, and other PynPoint related news.

Attribution

If you use PynPoint in your publication then please cite Stolker et al. (2019). Please also cite Amara & Quanz (2012) as the origin of PynPoint, which focused initially on the use of principal component analysis (PCA) as a PSF subtraction method. In case you use specifically the PCA-based background subtraction module or the wavelet based speckle suppression module, please give credit to Hunziker et al. (2018) or Bonse, Quanz & Amara (2018), respectively.

Contributing

Contributions in the form of bug fixes, new or improved functionalities, and additional pipeline modules are highly appreciated. Please consider forking the repository and creating a pull request to help improve and extend the package. Instructions for writing of modules are provided in the documentation. Bug reports can be provided by creating an issue on the Github page.

License

Copyright 2014-2019 Tomas Stolker, Markus Bonse, Sascha Quanz, Adam Amara, and contributors.

PynPoint is distributed under the GNU General Public License v3. See the LICENSE file for the terms and conditions.

Acknowledgements

The PynPoint logo was designed by Atlas Infographics and is available for use in presentations.

About

PynPoint is a Python package for processing and analysis of high-contrast imaging data

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 99.6%
  • Other 0.4%