Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

An interface layer for scripting the AMI-Reduce pipeline.

Project Description

A python package for scripting the AMI-reduce pipeline.

For a full description, see Staley and Anderson (2015). If you use drive-ami in work leading to a publication, we ask that you cite the paper above, and the relevant ASCL entry.


From a radio astronomy point of view:

This package makes it trivial to script reduction of raw AMI data from python. What’s more, it provides tools to group the raw files into datasets, outputting the UVFITS for each dataset under a single folder. It does this by extracting the pointing information from the raw data, resulting in fairly reliable groupings (although you can edit these manually, see later).

When processing the data, all output from reduce is saved to an accompanying log-file, retaining all information that would normally be available to the user from the interactive interface. Meanwhile, all emulated commands passed to reduce are recorded in a separate log for each file processed, so it’s easy to re-run the script manually and tinker with the reduction process.

Additionally, when running commands listed in a script the interface quietly parses key information such as flagging percentages, rain modulation, and estimated noise, from the reduce output. These are then stored to disk alongside the UVFITs in easily machine readable JSON format. (These may also be added to the UVFITS header in future.)

From a software engineering point of view:
Written in Fortran, with an interactive terminal interface, the reduce pipeline takes a little coaxing to co-operate with calling scripts, making automated processing of large numbers of files tricky. Fortunately, the python library pexpect provides an easy mechanism to emulate human interaction, upon which I’ve built an interface class. Limitations such as a maximum path length of ~32 chars are circumvented with a few careful hacks. The python logging libraries then allow us provide the user with minimal progress information, whilst retaining all possible information for debugging and scientific evaluation.


  • You will need a working installation of AMI-reduce (naturally)
  • pexpect For interfacing with AMI-reduce. (Installed automatically as part of the python setup.)
  • astropy Used for calculating co-ordinate distances, etc. (Installed automatically as part of the python setup.)

From the command line (preferably within a virtualenv):

git clone git://
cd drive-ami
pip install numpy #Workaround for buggy scipy/numpy combined install.
pip install .


Command-line scripts are installed along with the package. Their sourcefiles can be found at For full details, run e.g.: -h

Where -h is short for ‘help’.

Typical usage is to run to build a full listing of available data, followed by to extract the entries on a desired target. Finally, actually does the processing using AMI-REDUCE.

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(31.1 kB) Copy SHA256 Hash SHA256
Source None May 5, 2017

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers