miriad-python

This is the homepage of the miriad-python package, which provides a bridge between the Python programming language and the MIRIAD radio astronomy package. It provides facilities for:

You might be interested in:

Downloading: You have two choices for source code download. For the easiest possible installation, use the latest official release archive. For the latest code and development infrastructure, clone the miriad-python GitHub repository. The main inconvenience of the latter method is that you must prepare the build system using the GNU “autotools”, which can be quite fragile.

Installation Instructions: Detailed instructions are included with the source code. The latest instructions (including a list of prerequisites) may be viewed on GitHub.

Documentation: Check out the Miriad-Python Manual, which is a work in progress. Documentation is included in the source code and built if you have the necessary tools.

Bug Reports & Other Contributions: We aspire for miriad-python to have an open and welcoming development model. Report issues to the GitHub issue tracker. Email patches to the author, or fork us on GitHub and hack away!

License Terms: miriad-python is almost entirely Free Software, licensed under the GPL version 3 or later. Small portions of it are licensed under a BSD license with an advertising clause that limits your ability to make advertising claims using the names of the authors of those portions. With that exception, miriad-python is available for inspection and use by anyone for any purpose. Your contributions to the software are encouraged and welcomed.

If you use miriad-python in your research, please cite Williams et al., 2012 PASP 124 624 in any resulting publications.

News

2013 July 28: Version 1.2.4 is out. It adds experimental support for building against a CARMA binary distribution of MIRIAD, which is often how Mac users install MIRIAD on their computers. I’m unable to test this support extensively, so feedback would be greatly appreciated.

2012 October 15: Version 1.2.3 is out. There are a few build system improvements, but the main fix is including the README file in the tarballs! Sorry, folks.

2012 June 28: Version 1.2.2 is out. The main difference is that the released tarball contains the full reference to the official miriad-python paper in the README. There are also various changes related to more robust image and WCS loading.

2012 March 27: Version 1.2.1 is out, with some important documentation improvements. Notably, we've started using the GitHub issue tracker to keep track of bug reports and feature requests. The tips for installing MIRIAD itself have also been clarified.

2012 March 04: The miriad-python paper is out on astro-ph, and version 1.2 is out here! The paper doesn't talk about the details of miriad-python so much, but goes into the context in which it was written and the larger ecosystem in which it operates. The new release contains a steady drumbeat of new features, API improvements, bugfixes, and documentation improvements. Enjoy!

Releases

Releases are source-code only for now. Binary releases are hard.

The latest release is miriad-python 1.2.4 (2013 July 28), SHA1 checksum a4173f5d­307dd955­13c44122­6d0c8a57­4aea3e9c, git commit 6589fb8b­bbedcd98­703f32b8­9062e186­2c781d82.

The previous release is miriad-python 1.2.3 (2012 October 15), SHA1 checksum a7f92942­2b6ab0a1­ec50ad3e­a47c6590­686233c7, git commit c40b9706­a0f170fc­59c49bda­32fbac1b­6d706eb4.

The developers usually use the Git code directly and so formal releases are rare. But they're easy to make, so feel free to request one.

Contact

For more information, contact Peter Williams at pwilliams@cfa.harvard.edu. For bug reports, feature requests, and other issues, use the GitHub issue tracker.