Installation

The current version of pDynamo has been tested on machines running the Linux, MAC OS-X 10 and Windows operating systems.

Linux and MAC OS-X

1. If older versions of pDynamo are installed, the environment variables and Python path definitions corresponding to these versions should be removed. This can be done by undefining the appropriate variables or by overwriting them with the definitions appropriate to the new version (see Step 8 below).
2. At a minimum, installation of pDynamo requires an up-to-date version of Python (2.5 or higher) and a C compiler. pDynamo employs some third-party libraries, notably BLAS and LAPACK, but basic versions of these come in the source distribution and so need not be provided separately.
3. Download the current version of the library, pdynamo-x.y.tgz.
4. Put the downloaded file, pdynamo-x.y.tgz, in the directory where the library is to be installed.
5. Type tar -xvzf pdynamo-x.y.tgz to unpack the downloaded file and create the directory pDynamo-x.y.
6. Go to the pDynamo installation directory by typing cd pDynamo-x.y/installation.
7. Type python Install.py to install the library. This command can take a little while and will produce a lot of output.
8. Set up the environment variables that are needed by the library. These are described in the file 00readme.txt in the installation directory and are most conveniently placed in a shell configuration file, such as .bash_profile or .cshrc. As an aid to users, the installation procedure creates files in the installation directory that contain the necessary definitions for certain Unix shells. These are entitled environment_shell.com and can be adapted as appropriate.
9. To test the library, type cd ../book/examples and then python RunExamples.py --all to run the full suite of examples or python RunExamples.py to run a selection of the shorter cases. The full set of tests take several hours to run and require about a gigabyte of disk space whereas the shorter examples take only a few minutes. Once the jobs are finished type python DifferenceOutputs.py to see the differences between the generated outputs and the reference outputs provided with the installation.
10. Test cases come with some of pDynamo's packages. If desired, these can be run after the environment variables have been set up (see Step 8). To do so, go back to the installation directory and type python RunPackageTests.py.

By default, installation does not process the Pyrex files that link the Python and C parts of pDynamo together. Instead, the preprocessed files that are included in the distribution are employed. This may cause problems, such as compilation errors or segmentation faults, on some machines. If this is the case, download and install the current version of Pyrex and then repeat the installation using the command python Install.py -f.