next up previous contents
Next: 3 All in one Up: AstroAsciiData 1.1 User Manual Previous: 1 Introduction   Contents

Subsections


2 Installation

The AstroAsciiData module requires Python 2.4 or later. It was developed on linux (SUSE, fedora), Solaris 5.8 and MacOSX, however there should be no problems installing it on any machine hosting Python.

Individual functions, such as the transformation to numarray, numpy or the FITS format, obviously require the python modules for the formats they convert to. But there is no general need to install them.

The current version 1.1 of AstroAsciiData is distributed as the source archive asciidata-1.1.tar.gz from the AstroAsciiData webpage at
http://www.stecf.org/software/PYTHONtools/astroasciidata/. Installing the module is not difficult. Unpack the tarball with:

> gunzip asciidata-1.1.tar.gz
> tar -xvf asciidata-1.1.tar

Then enter the the unpacked directory and do the usual:

> cd asciidata-1.1
> python setup.py install

After installation, some Unit Tests can be executed with:

> python setup.py test
If there are no errors reported in the Unit Tests, the proper working of the module is assured. Failed tests may happen due to missing pyhon modules (numpy, PyFITS or numarray) and can be neglected if you do not intend to convert into these formats.

In all classes and sub-modules the epydoc-conventions have been used in the inline documentation. In case that epydoc (http://epydoc.sourceforge.net/) is installed, the command

> epydoc Lib/
creates webpages from the inline documenatation, which are written to the the directory './html'. This would be certainly a very good start for users who really want to find out what is behind the module or intend to subclass it to e.g. support their own, custom made ASCII table format with column names. In case that you just want to use the AstroAsciiData module, there is no need to look at its inline documentation.

2.1 Lemma for version 1.1.1

This newest version is rather a patch release. The advent of numpy-1.1 require some small changes not even to the code itself, but to the unit tests. Since these are integral part of the software release, we decided to upgrade and call the new bundle version 1.1.1.

2.2 Release notes for version 1.1

Except for minor bug fixes, version 1.1 contains the following improvements:
next up previous contents
Next: 3 All in one Up: AstroAsciiData 1.1 User Manual Previous: 1 Introduction   Contents
mkuemmel@eso.org