Metadata-Version: 2.4
Name: PyFHD
Version: 1.0.1
Summary: Python Fast Holograhic Deconvolution: A Python package that does fast-mode Epoch of Reionization analysis.
Project-URL: Repository, https://github.com/EoRImaging/PyFHD
Project-URL: Documentation, https://pyfhd.readthedocs.io/en/latest/
Project-URL: Bug Tracker, https://github.com/EoRImaging/PyFHD/issues
Project-URL: Changelog, https://pyfhd.readthedocs.io/en/latest/changelog/changelog.html
Author-email: "Joel Dunstan (SkyWa7ch3r)" <joel.g.w.dunstan@gmail.com>, "Jack Line (JLBLine)" <jack.line@curtin.edu.au>, "Nichole Barry (nicholebarry)" <nichole.barry@unsw.edu.au>
License: MIT License
        
        Copyright (c) 2022 Astronomy Data and Computing Services
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Astronomy
Requires-Python: >=3.10
Requires-Dist: astropy>=6.1.7
Requires-Dist: colorama>=0.4.6
Requires-Dist: configargparse>=1.7
Requires-Dist: h5py>=3.13.0
Requires-Dist: healpy>=1.18.1
Requires-Dist: importlib-resources>=6.5.2
Requires-Dist: matplotlib>=3.10.3
Requires-Dist: numba>=0.61.2
Requires-Dist: numpy>=2.2.5
Requires-Dist: pyuvdata>=3.2.1
Requires-Dist: scipy>=1.15.3
Description-Content-Type: text/markdown

# PyFHD
**Py**thon **F**ast **H**olographic **D**econvolution

[![Python](https://img.shields.io/badge/Python-3.10--3.13-%231475b3?logo=python&logoColor=%23fff)](https://www.python.org/)
![GitHub last commit](https://img.shields.io/github/last-commit/EoRImaging/PyFHD?logo=github&color=blue&link=https%3A%2F%2Fgithub.com%2FEoRImaging%2FPyFHD%2Fcommits%2Fmain%2F)
![GitHub License](https://img.shields.io/github/license/EoRImaging/PyFHD)

![GitHub branch check runs](https://img.shields.io/github/check-runs/EoRImaging/PyFHD/main)
[![Documentation Status](https://readthedocs.org/projects/pyfhd/badge/?version=latest)](https://pyfhd.readthedocs.io/en/latest/?badge=latest)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

![PyPI - Version](https://img.shields.io/pypi/v/pyfhd)


[![Static Badge](https://img.shields.io/badge/Test%20Data%20DOI-10.5281%2Fzenodo.15687722-grey?labelColor=blue)](https://doi.org/10.5281/zenodo.15687722)



TODO: Add Testing Results and Testing coverage

## FHD
FHD is an open-source imaging algorithm for radio interferometers, specifically tested on MWA Phase I, MWA Phase II, PAPER, and HERA. There are three main use-cases for FHD: efficient image deconvolution for general radio astronomy, fast-mode Epoch of Reionization analysis, and simulation.

PyFHD is the translated library of FHD from IDL to Python, it aims to get close to the same results as the original FHD project. Do expect some minor differences compared to the original FHD project due to the many differences between IDL and Python. These differences are often due to the difference in precision between IDL and Python with IDL being single-precision (accurate upto 1e-8) and Python being double-precision (1e-16). Some of the IDL functions are double-precision but most default to single-precision.

## Quick Start
```
pip install pyfhd
```

For full installation notes, including dependencies on PyFHD, check out the [ReadTheDocs installation page](https://pyfhd.readthedocs.io/en/latest/installation/installation.html).

To check if PyFHD is available on your path, run the following command:

```
pyfhd -v
```

You should see output that resembles something like this:

```
    ________________________________________________________________________
    |    ooooooooo.               oooooooooooo ooooo   ooooo oooooooooo.    |
    |    8888   `Y88.             8888       8 8888    888   888     Y8b    |
    |    888   .d88' oooo    ooo  888          888     888   888      888   |
    |    888ooo88P'   `88.  .8'   888oooo8     888ooooo888   888      888   |
    |    888           `88..8'    888          888     888   888      888   |
    |    888            `888'     888          888     888   888     d88'   |
    |    o888o            .8'     o888o        o888o   o888o o888bood8P'    |
    |                 .o..P'                                                |
    |                `Y8P'                                                  |
    |_______________________________________________________________________|
    
    Python Fast Holographic Deconvolution 

    Translated from IDL to Python as a collaboration between Astronomy Data and Computing Services (ADACS) and the Epoch of Reionisation (EoR) Team.

    Repository: https://github.com/EoRImaging/PyFHD

    Documentation: https://pyfhd.readthedocs.io/en/latest/

    Version: 1.0.1

    Git Commit Hash: aa3cddb69cb617d88cb95d8b3d177d934f1c5d01 (tutorial_adjustments)
```

To run the examples built into the repository and beyond, please find them here: [PyFHD Examples](https://pyfhd.readthedocs.io/en/latest/examples/examples.html)

## Useful Documentation Resources
 - [PyFHD documentation](https://pyfhd.readthedocs.io/en/latest/)
 - [MWA ASVO](https://asvo.mwatelescope.org/) - service to obtain MWA data
 - [FHD repository](https://github.com/EoRImaging/FHD) - the original IDL code
 - [FHD examples](https://github.com/EoRImaging/FHD/blob/master/examples.md) - examples on how to use the original IDL code
 - [FHD pipeline scripts](https://github.com/EoRImaging/pipeline_scripts) - pipeline scripts using the original IDL code

## Community Guidelines
We are an open-source community that interacts and discusses issues via GitHub. We encourage collaborative development. New users are encouraged to submit issues and pull requests and to create branches for new development and exploration. Comments and suggestions are welcome.

If you wish to contribute to PyFHD, first of all thank you, second please read the contribution guide which can be found here, [Contribution Guide](https://pyfhd.readthedocs.io/en/latest/develop/contribution_guide.html). The contribution will cover all you need to know for developing in PyFHD from adding features, formatting adding tests and some advice in translating IDL to Python.

TODO: Add citation details for PyFHD

## Maintainers
FHD was built by Ian Sullivan and the University of Washington radio astronomy team. Maintainance is a group effort split across University of Washington and Brown University, with contributions from University of Melbourne and Arizona State University. 

PyFHD is currently being created by Nichole Barry and Astronomy Data and Computing Services (ADACS) member Joel Dunstan. ADACS is a collaboration between the University of Swinburne and Curtin Institute for Data Science (CIDS) located in Curtin University.

Thank you to the previous maintainers:
Jack Line - Astronomy Data and Computing Services (ADACS)

Acknowledgements to Bryna Hazelton and Paul Hancock for their advice and knowledge.

