To help you get started, we've collected the most common ways that stingray is being used within popular public projects.

StingraySoftware / dave / src / main / python / utils / dave_engine.py View on Github

as_priors = ModelHelper.get_astropy_priors(priors)
                if len(as_priors.keys()) > 0:
                    # If there are priors then is a Bayesian Parameters Estimation
                    max_post=True
                    fitmethod="BFGS"

                else:
                    as_priors=None
                    logging.warn("fit_power_density_spectrum: can't create priors from dave_priors.")

            if as_priors:
                # Creates a Posterior object with the priors
                lpost = PSDPosterior(pds.freq, pds.power, fit_model, priors=as_priors, m=pds.m)
            else:
                # Creates the Maximum Likelihood object for fitting
                lpost = PSDLogLikelihood(pds.freq, pds.power, fit_model, m=pds.m)

            # Creates the PSD Parameters Estimation object and runs the fitting
            parest = PSDParEst(pds, fitmethod=fitmethod, max_post=max_post)
            res = parest.fit(lpost, starting_pars, neg=True)

            sample = None
            if as_priors and sampling_params is not None:
                # If is a Bayesian Par. Est. and has sampling parameters
                # then sample the posterior distribution defined in `lpost` using MCMC
                sample = parest.sample(lpost, res.p_opt, cov=res.cov,
                                         nwalkers=sampling_params["nwalkers"],
                                         niter=sampling_params["niter"],
                                         burnin=sampling_params["burnin"],
                                         threads=sampling_params["threads"],
                                         print_results=False, plot=False)

View more ways to use stingray

Stingray

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.

Documentation

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.

Related Packages

• HENDRICS provides a set of command-line scripts which use Stingray to perform quick-look spectral timing analysis of X-ray data.
• DAVE is a graphical user interface built on top of Stingray.

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.

Copyright & Licensing

All content © 2015 The Authors. The code is distributed under the MIT license; see LICENSE.rst for details.