Skip to main content

Time Series Methods For Astronomical X-ray Data

Project description

Build Status Master Docs Slack joss doi Coverage Status Master GitHub release

X-Ray Spectral Timing Made Easy

Stingray is a spectral-timing software package for astrophysical X-ray (and other) data. Stingray merges existing efforts for a (spectral-)timing package in Python, and is structured with the best guidelines for modern open-source programming, following the example of Astropy.

It provides:

  • a library of time series methods, including power spectra, cross spectra, covariance spectra, lags, and so on;
  • a set of scripts to load FITS data files from different missions;
  • a light curve and event list simulator, with the ability to simulate different kinds of variability and more complicated phenomena based on the impulse response of given physical events (e.g. reverberation).

There are a number of official software packages for X-ray spectral fitting (Xspec, ISIS, Sherpa, …). However, an equivalent widely-used package does not exist for X-ray timing: to date, that has generally been done with custom software. Stingray aims not only to fill that gap, but also to provide implementations of the most advanced spectral timing techniques available in the literature. The ultimate goal of this project is to provide the community with a package that eases the learning curve for the advanced spectral timing techniques with a correct statistical framework.

More details of current and planned capabilities are available in the Stingray documentation.

Installation and Testing

Stingray can be installed via conda, pip, or directly from the source repository itself. Our documentation provides comprehensive installation instructions.

After installation, it’s a good idea to run the test suite. We use py.test and tox for testing, and, again, our documentation provides step-by-step instructions.


Stingray’s documentation can be found at

Getting In Touch, and Getting Involved

We welcome contributions and feedback, and we need your help! The best way to get in touch is via the issues_ page. We’re especially interested in hearing from you:

  • If something breaks;
  • If you spot missing functionality, find the API unintuitive, or have suggestions for future development;
  • If you have your own code implementing any of the methods provided Stingray and it produces different answers.

Even better: if you have code you’d be willing to contribute, please send a pull request or open an issue.

Citing Stingray

If you find this package useful in your research, please provide appropriate acknowledgement and citation. Our documentation gives further guidance, including links to appropriate papers and convenient BibTeX entries.

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 stingray, version 0.3
Filename, size File type Python version Upload date Hashes
Filename, size stingray-0.3.tar.gz (29.4 MB) 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 Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page