Installation

For users

The package is installable, along with its dependencies, with PyPi. We recommend using Anaconda and creating a new conda environment before installing the package. You may wish to install some of the dependencies directly with conda instead of pip before installing the package. This is especially important for jax on MacOS:

$ conda create -n hera_pspec python=3
$ conda activate hera_pspec
$ conda install jax
$ python3 -m pip install hera_pspec

New versions are frequently released on PyPi.

For developers

If you are developing and/or want to use the latest working version of hera_pspec, you can directly install from the GitHub repository.

Preferred method of installation for users is simply pip install -e . (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 jax

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.