Downloading PyARTS ------------------ **The PyARTS CVS repository at Bremen is not in use, and is out of date!!** I have not committed any changes to the PyARTS cvs repository since the recent changes to NumPy ( a merger between the old Numeric Python and numarray) and Scipy. The new NumPy, which was also briefly known as scipy_core has tidied things up quite a bit, but I didn't want to change the PyARTS prerequisites without some feedback from the folk at Bremen and Chalmers, particularly while numpy/scipy was a bit volatile. **An up-to-date PyARTS source distribution that uses the new numpy/ scipy can be found at** http://www.met.ed.ac.uk/~cdavis/PyARTS/latest Prerequisites ------------- * Python 2.3, (you will probably have this already) * A fortran compiler * NumPy and SciPy * matplotlib The versions of the above that I am currently using are numpy-0.9.2 (NOT -0.9.4 due to a incompatibility with the scipy release) and scipy-0.4.4. Ian Adams reports that PyARTS works also with newer versions of these packages (NumPy-0.9.5 and SciPy-0.4.6). Some parts of PyARTS also require matplotlib, where I currently have matplotlib-0.86.2. Installation ------------ Once you have all of the above prerequisites installed, and checked out PyARTS from the ARTS cvs repository, run the following from the base directory. python setup.py install --home=~ This will install the package in ~/lib/python and also it will but some scripts in ~/bin. If you omit the --home argument python will try and install the modules in the standard 3rd party location (something like /usr/lib/python2.2/site-packages), which obviously wont happen unless you have superuser privileges In most cases the install command above will work, however, if like me, your Numeric package is not installed in the standard place (something like /usr/lib/python2.x/site-packages/Numeric), you need to use a slightly different command to build and install PyARTS: python setup.py build_src build_ext --include-dirs=/include/python install --home=~ Once installed you should modify your PYTHONPATH environment variable to include the installation directory (eg ~/lib/python). Testing your Installation ------------------------- There are several unit tests in the test/ folder of the distribution. These test both both the functionality and accuracy of the software. To run them all, and check that your installation is OK, type python testall.py -v If you would like to contribute to PyARTS, which is definitely encouraged, it is strongly recommended that the above command is run, and that all tests are successful, before committing your changes to CVS. Examples -------- Some example scripts are provided in the examples/ folder. These all should work as they only depend on data provided in the data/ folder. The testall.py script described above actually verifies that the examples run without error. At the time of writing the examples are: get_atm_fields.py A demonstration of the artsGetAtmFields function MCwith3Dboxcloud.py Creates a simple cloudy-sky scenario and performs a single radiative transfer calculation using the ARTS-MC module. mc_incoming_gen.py demonstrates the use of the create_incoming_lookup function which creates a sequential linear interpolation lookup table of incoming radiances that can be used by the ARTS Monte Carlo radiative transfer algorithm. geometry.py uses the plotting module to show ARTS RT simulation geometry. plot_refr_ind.py Uses the arts_scat module, and the plotting module to show the refractive index of ice at several EOS-MLS frequencies Documentation ------------- Most modules in the package have reasonably complete docstring documentation. This means that in an interactive python session, online help on a given PyARTS class or function can be obtained by typing ``help(PyARTS_function_or_class)``. The docstring documentation can also be viewed in easily navigatable html documents by doing the following: ``/pydoc.py -p 1234`` and open ``http://localhost:1234`` in your web browser. There is a user guide in the doc/ folder of the distribution. A recent version of this document can be found at http://www.met.ed.ac.uk/~cdavis/PyARTS/userguide.pdf