|Build Status| |Coverage Status| |Documentation Status|
HENDRICS - High ENergy Data Reduction Interface from the Command Shell
======================================================================
Description
-----------
This set of command-line scripts based on
`Stingray <https://github.com/StingraySoftware/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 <https://arxiv.org/abs/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 <https://github.com/StingraySoftware/stingray>`__. The
analysis done in HENDRICS will be compatible with the graphical user
interface `DAVE <https://github.com/StingraySoftware/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 <https://hendrics.readthedocs.io>`__.
A **tutorial** is also available
`here <https://hendrics.readthedocs.io/en/main/tutorials/index.html>`__.
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. 2018, HENDRICS: High ENergy Data Reduction Interface from the Command Shell, record `ascl:1805.019 <https://ascl.net/1805.019>`__.
and please also cite `stingray <https://stingray.science/stingray/citing.html>`
In particular, **if you use the cospectrum**, please also refer to:
2. Bachetti et al. 2015, `ApJ <https://iopscience.iop.org/0004-637X/800/2/109/>`__ , **800**, 109.
If you have found a bug please report it by creating a
new issue on the `HENDRICS GitHub issue tracker. <https://github.com/StingraySoftware/HENDRICS/issues>`_
Development guidelines
----------------------
Please follow the development workflow for
`the Astropy project <https://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.
.. |Build Status| image:: https://github.com/StingraySoftware/HENDRICS/workflows/CI%20Tests/badge.svg
:target: https://github.com/StingraySoftware/HENDRICS/actions/
.. |Coverage Status| image:: https://codecov.io/gh/StingraySoftware/HENDRICS/branch/main/graph/badge.svg
:target: https://app.codecov.io/gh/StingraySoftware/HENDRICS
.. |Documentation Status| image:: https://readthedocs.org/projects/hendrics/badge/?version=main
:target: https://hendrics.readthedocs.io/en/main/?badge=main
Raw data
{
"_id": null,
"home_page": "https://hendrics.readthedocs.io",
"name": "hendrics",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "astronomy, astrophysics, space, science, timeseries, timing",
"author": "Matteo Bachetti",
"author_email": "matteo@matteobachetti.it",
"download_url": "https://files.pythonhosted.org/packages/61/a8/62374a22900a8c570e0720b55cd58cfa0795dd191bcb3a67aee836175caf/hendrics-8.0.1.tar.gz",
"platform": null,
"description": "|Build Status| |Coverage Status| |Documentation Status|\n\nHENDRICS - High ENergy Data Reduction Interface from the Command Shell\n======================================================================\n\nDescription\n-----------\n\nThis set of command-line scripts based on\n`Stingray <https://github.com/StingraySoftware/stingray>`__ is designed\nto do correctly and fairly easily a **quick-look (spectral-)timing\nanalysis** of X-ray data, treating properly the gaps in the data due,\ne.g., to occultation from the Earth or passages through the SAA.\nOriginally, its development as MaLTPyNT - Matteo's Libraries and Tools\nin Python for NuSTAR Timing - was driven by the need of performing\naperiodic timing analysis on NuSTAR data, whose long dead time made it\ndifficult to treat power density spectra with the usual tools. By\nexploiting the presence of two independent detectors, one could use the\n**cospectrum** as a proxy for the power density spectrum (for an\nexplanation of why this is important, look at Bachetti et al., *ApJ*,\n800, 109 -`arXiv:1409.3248 <https://arxiv.org/abs/1409.3248>`__).\n\nToday, this set of command line scripts is much more complete and it is\ncapable of working with the data of many more satellites. Among the\nfeatures already implemented are power density and cross spectra, time\nlags, pulsar searches with the Epoch folding and the Z\\_n^2 statistics,\ncolor-color and color-intensity diagrams. More is in preparation:\nrms-energy, lag-energy, covariance-energy spectra, Lomb-Scargle\nperiodograms and in general all that is available in\n`Stingray <https://github.com/StingraySoftware/stingray>`__. The\nanalysis done in HENDRICS will be compatible with the graphical user\ninterface `DAVE <https://github.com/StingraySoftware/dave>`__, so that\nusers will have the choice to analyze single datasets with an easy\ninteractive interface, and continue the analysis in batch mode with\nHENDRICS. The periodograms produced by HENDRICS (like a power density\nspectrum or a cospectrum), can be saved in a format compatible with\n``XSpec`` or ``ISIS``, for\nthose who are familiar with those fitting packages. Despite its original\nmain focus on NuSTAR, the software can be used to make standard\naperiodic timing analysis on X-ray data from, in principle, any other\nsatellite (for sure XMM-Newton and RXTE).\n\nThe **documentation** can be found\n`here <https://hendrics.readthedocs.io>`__.\n\nA **tutorial** is also available\n`here <https://hendrics.readthedocs.io/en/main/tutorials/index.html>`__.\n\nInstallation instructions\n-------------------------\n\nTo install stable or beta releases:\n\n::\n\n $ pip install hendrics\n\nFor development versions:\n\n::\n\n $ git clone git@github.com/StingraySoftware/HENDRICS\n $ cd HENDRICS\n $ python setup.py install\n\n\nLicense and notes for the users\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nThis software is released with a 3-clause BSD license. You can find\nlicense information in the ``LICENSE.rst`` file.\n\n**If you use this software in a publication**, please refer to its\nAstrophysics Source Code Library identifier:\n\n1. Bachetti, M. 2018, HENDRICS: High ENergy Data Reduction Interface from the Command Shell, record `ascl:1805.019 <https://ascl.net/1805.019>`__.\n\nand please also cite `stingray <https://stingray.science/stingray/citing.html>`\n\nIn particular, **if you use the cospectrum**, please also refer to:\n\n2. Bachetti et al. 2015, `ApJ <https://iopscience.iop.org/0004-637X/800/2/109/>`__ , **800**, 109.\n\nIf you have found a bug please report it by creating a\nnew issue on the `HENDRICS GitHub issue tracker. <https://github.com/StingraySoftware/HENDRICS/issues>`_\n\nDevelopment guidelines\n----------------------\n\nPlease follow the development workflow for\n`the Astropy project <https://docs.astropy.org/en/stable/development/workflow/development_workflow.html>`__.\nIn the hendrics/tests\ndirectory, there is a test suite called ``test_fullrun.py``. These tests\nuse the actual command line scripts, and should always pass (albeit with\nsome adaptations). The other test suites, e.g. ``test_unit.py``, tests\nthe API.\n\n.. |Build Status| image:: https://github.com/StingraySoftware/HENDRICS/workflows/CI%20Tests/badge.svg\n :target: https://github.com/StingraySoftware/HENDRICS/actions/\n.. |Coverage Status| image:: https://codecov.io/gh/StingraySoftware/HENDRICS/branch/main/graph/badge.svg\n :target: https://app.codecov.io/gh/StingraySoftware/HENDRICS\n.. |Documentation Status| image:: https://readthedocs.org/projects/hendrics/badge/?version=main\n :target: https://hendrics.readthedocs.io/en/main/?badge=main\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "\"High ENergy Data Reduction Interface from the Command Shell\"",
"version": "8.0.1",
"project_urls": {
"Homepage": "https://hendrics.readthedocs.io"
},
"split_keywords": [
"astronomy",
" astrophysics",
" space",
" science",
" timeseries",
" timing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0f8d72dcd7872035d93e35d011066c33dbc5d740ed53ba8003b1f223243c8023",
"md5": "9b8f2f04a7d343de36f66b3cedbf3bce",
"sha256": "14815ee4232d74bec1e91613c9f0508e8ef5009a411b9abf79e67d2dbbc25703"
},
"downloads": -1,
"filename": "hendrics-8.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9b8f2f04a7d343de36f66b3cedbf3bce",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 25788359,
"upload_time": "2024-04-05T11:26:28",
"upload_time_iso_8601": "2024-04-05T11:26:28.796188Z",
"url": "https://files.pythonhosted.org/packages/0f/8d/72dcd7872035d93e35d011066c33dbc5d740ed53ba8003b1f223243c8023/hendrics-8.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "61a862374a22900a8c570e0720b55cd58cfa0795dd191bcb3a67aee836175caf",
"md5": "18c73fa7f43f815c5944268474a83f97",
"sha256": "9e42d167f57c10d3178555e3f42b35ec7b431741034c76134752f17aa7b22c11"
},
"downloads": -1,
"filename": "hendrics-8.0.1.tar.gz",
"has_sig": false,
"md5_digest": "18c73fa7f43f815c5944268474a83f97",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 31379074,
"upload_time": "2024-04-05T11:26:40",
"upload_time_iso_8601": "2024-04-05T11:26:40.249117Z",
"url": "https://files.pythonhosted.org/packages/61/a8/62374a22900a8c570e0720b55cd58cfa0795dd191bcb3a67aee836175caf/hendrics-8.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-05 11:26:40",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "hendrics"
}
JSON