Revision 19df723cb2c3a1a86db159b0b505d791c9c812ed authored by Bryna Hazelton on 14 December 2016, 17:53:19 UTC, committed by Zaki Ali on 05 April 2017, 22:20:34 UTC
1 parent 255c339
README.md
# pyuvdata
[![Build Status](https://travis-ci.org/HERA-Team/pyuvdata.svg?branch=master)](https://travis-ci.org/HERA-Team/pyuvdata)
[![Coverage Status](https://coveralls.io/repos/github/HERA-Team/pyuvdata/badge.svg?branch=master)](https://coveralls.io/github/HERA-Team/pyuvdata?branch=master)
pyuvdata defines a pythonic interface to interferometric data sets. Currently pyuvdata supports reading and writing of miriad and uvfits files and reading of FHD ([Fast Holographic Deconvolution](https://github.com/EoRImaging/FHD)) visibility save files.
# Motivation
The three main goals are:
1. To provide a high quality, well documented path to convert between data formats
2. Support the direct use of datasets from python with minimal software
3. Provide precise data definition via both human readable code and high quality online documentation
# Package Details
## Tested File Paths
* uvfits -> miriad (aipy)
* miriad (aipy) -> uvfits
* FHD -> uvfits
* FHD -> miriad (aipy)
## File standards
* miriad is supported for aipy-style analysis, further testing is required for use in the miriad package
* uvfits conforms to AIPS memo 117 (as of May 2015). It is tested against FHD, CASA, and AIPS. However AIPS is limited to <80 antennas and CASA imaging does not seem to support >255 antennas.
* FHD (read-only support, tested against MWA and PAPER data)
## Known Issues and Planned Improvements
* different multiple spectral windows or multiple sources are not currently supported
* testing against miriad package
* replacing AIPY and pyephem with astropy+NOVAS for time and phase calculations
* support for direct reading and writing of Measurement Sets
* support for calibration solutions: define a cal object with read/write support for FITS and other formats
For details see the [issue log](https://github.com/HERA-Team/pyuvdata/issues).
## Community Guidelines
Contributions to this package to add new file formats or address any of the
issues in the [issue log](https://github.com/HERA-Team/pyuvdata/issues) are very welcome.
Please submit improvements as pull requests against the repo after verifying that
the existing tests pass and any new code is well covered by unit tests.
Bug reports or feature requests are also very welcome, please add them to the
issue log after verifying that the issue does not already exist.
Comments on existing issues are also welcome.
# History
pyuvdata was originally developed in the low frequency 21cm community to support the development of calibration and foreground subtraction pipelines. Particular focus has been paid to supporting drift and phased array modes.
# Installation
## Dependencies
First install dependencies. The numpy and astropy versions are important, so be sure to make sure these are up to date before you install.
* numpy >= 1.10
* scipy
* astropy >= 1.2
* pyephem
* aipy
## Install pyuvdata
For simple installation, the latest stable version is available via pip using ```pip install pyuvdata```
### Optionally install the development version
For the development version, clone the repository using
```git clone https://github.com/HERA-Team/pyuvdata.git```
Navigate into the directory and run ```python setup.py install```.
Note that this will automatically install all dependencies. If you use anaconda or another package manager you might prefer not to do this.
To install without dependencies, run
```python setup.py install --no-dependencies```
## Tests
Requires installation of `nose` package.
From the source pyuvdata directory run ```nosetests pyuvdata```.
# API
The primary interface to data from python is via the UVData object. It provides
import and export functionality to all supported file formats (UVFITS, Miriad, FHD)
and can be interacted with directly. The attributes of the UVData object are
described in the parameters description at https://pyuvdata.readthedocs.io or [here](https://github.com/HERA-Team/pyuvdata/blob/master/docs/parameters.rst).
![swh spinner](/static/img/swh-spinner.gif)
Computing file changes ...