Shell scripts for spectral-timing analysis of X-ray astronomical data.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
astropy_helpers @ 231c409
docs
hendrics
notebooks
.gitignore
.gitmodules
.rtd-environment.yml
.travis.yml
CITATION
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE.rst
MANIFEST.in
README.rst
TODO.md
ah_bootstrap.py
appveyor.yml
readthedocs.yml
requirements.txt
setup.cfg
setup.py
tox.ini

README.rst

Build Status Build status Coverage Status Documentation Status

HENDRICS - High ENergy Data Reduction Interface from the Command Shell

Note

This repository contains an evolution of MaLTPyNT. This software is being heavily rewritten in order to use Stingray's classes and functions whenever possible. To use the original MaLTPyNT, please go to matteobachetti/MaLTPyNT.

Description

This set of command-line scripts based on Stingray is designed to do correctly and fairly easily a quick-look (spectral-)timing analysis of X-ray data, treating properly the gaps in the data due, e.g., to occultation from the Earth or passages through the SAA. Originally, its development as MaLTPyNT - Matteo's Libraries and Tools in Python for NuSTAR Timing - was driven by the need of performing aperiodic timing analysis on NuSTAR data, whose long dead time made it difficult to treat power density spectra with the usual tools. By exploiting the presence of two independent detectors, one could use the cospectrum as a proxy for the power density spectrum (for an explanation of why this is important, look at Bachetti et al., ApJ, 800, 109 -arXiv:1409.3248).

Today, this set of command line scripts is much more complete and it is capable of working with the data of many more satellites. Among the features already implemented are power density and cross spectra, time lags, pulsar searches with the Epoch folding and the Z_n^2 statistics, color-color and color-intensity diagrams. More is in preparation: rms-energy, lag-energy, covariance-energy spectra, Lomb-Scargle periodograms and in general all that is available in Stingray. The analysis done in HENDRICS will be compatible with the graphical user interface DAVE, so that users will have the choice to analyze single datasets with an easy interactive interface, and continue the analysis in batch mode with HENDRICS. The periodograms produced by HENDRICS (like a power density spectrum or a cospectrum), can be saved in a format compatible with Xspec or Isis, for those who are familiar with those fitting packages. Despite its original main focus on NuSTAR, the software can be used to make standard aperiodic timing analysis on X-ray data from, in principle, any other satellite (for sure XMM-Newton and RXTE).

The documentation can be found here.

A tutorial is also available here.

Installation instructions

To install stable or beta releases:

$ pip install hendrics

For development versions:

$ git clone git@github.com/StingraySoftware/HENDRICS
$ cd HENDRICS
$ python setup.py install

License and notes for the users

This software is released with a 3-clause BSD license. You can find license information in the LICENSE.rst file.

If you use this software in a publication, please refer to its Astrophysics Source Code Library identifier:

  1. Bachetti, M. 2015, MaLTPyNT, Astrophysics Source Code Library, record ascl:1502.021.

In particular, if you use the cospectrum, please also refer to:

  1. Bachetti et al. 2015, ApJ , 800, 109.

If you have found a bug please report it by creating a new issue on the HENDRICS GitHub issue tracker.

Development guidelines

Please follow the development workflow for `the Astropy project<http://docs.astropy.org/en/stable/development/workflow/development_workflow.html>`__. In the hendrics/tests directory, there is a test suite called test_fullrun.py. These tests use the actual command line scripts, and should always pass (albeit with some adaptations). The other test suites, e.g. test_unit.py, tests the API.