Metadata-Version: 2.1
Name: hera-pspec
Version: 0.4.0
Summary: HERA Power Spectrum Estimator Code
Home-page: https://github.com/HERA-Team/hera_pspec
Author: HERA Team
License: BSD
Project-URL: Documentation, https://hera-pspec.readthedocs.io/en/latest/
Platform: OSX
Platform: Linux
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved
Classifier: Natural Language :: English
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Astronomy
Description-Content-Type: text/x-rst; charset=UTF-8
Provides-Extra: docs
Provides-Extra: tests
Provides-Extra: dev
License-File: LICENSE

# ``hera_pspec``: HERA delay spectrum estimation

![Run Tests](https://github.com/HERA-Team/hera_pspec/workflows/Run%20Tests/badge.svg)
[![codecov](https://codecov.io/gh/HERA-Team/hera_pspec/branch/master/graph/badge.svg)](https://codecov.io/gh/HERA-Team/hera_pspec)
[![Documentation](https://readthedocs.org/projects/hera-pspec/badge/?version=latest)](https://readthedocs.org/projects/hera-pspec/badge/?version=latest)

The ``hera_pspec`` library provides all of the tools and data structures needed to perform a delay 
spectrum analysis on interferometric data. The input data can be in any format supported by ``pyuvdata``, 
and the output data are stored in HDF5 containers.

For usage examples and documentation, see http://hera-pspec.readthedocs.io/en/latest/.

## Installation
Preferred method of installation for users is simply `pip install .`
(or `pip install git+https://github.com/HERA-Team/hera_pspec`). This will install 
required dependencies. See below for manual dependency management.
 
### Dependencies
If you are using `conda`, you may wish to install the following dependencies manually
to avoid them being installed automatically by `pip`::

    $ conda install -c conda-forge "numpy>=1.15" "astropy>=2.0" h5py pyuvdata scipy matplotlib pyyaml
    
### Developing
If you are developing `hera_pspec`, it is preferred that you do so in a fresh `conda`
environment. The following commands will install all relevant development packages::

    $ git clone https://github.com/HERA-Team/hera_pspec.git
    $ cd hera_pspec
    $ conda create -n hera_pspec python=3
    $ conda activate hera_pspec
    $ conda env update -n hera_pspec -f ci/hera_pspec_tests.yml
    $ pip install -e . 

This will install extra dependencies required for testing/development as well as the 
standard ones.

### Running Tests
Uses the `pytest` package to execute test suite.
From the source `hera_pspec` directory run: `pytest`.


## Running `hera_pspec`

See the documentation for an 
[overview and examples](http://hera-pspec.readthedocs.io/en/latest/pspec.html) 
of how to run `hera_pspec`. There are also some example Jupyter notebooks, 
including [`examples/PS_estimation_examples.ipynb`](examples/PS_estimation_example.ipynb) 
(a brief tutorial on how to create delay spectra), and 
[`examples/PSpecBeam_tutorial.ipynb`](examples/PSpecBeam_tutorial.ipynb) (a brief 
tutorial on handling beam objects).
