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
- 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 10 below).
- Installation of pDynamo requires Python 2.7 and a C compiler. pDynamo employs some third-party libraries, notably BLAS and LAPACK, Cython and PyYAML, but basic versions of these come in the distribution and so need not be provided separately.
- Download the current version of the library,
- Put the downloaded file,
pdynamo-x.y.tgz, in the directory where the library is to be installed.
tar -xvzf pdynamo-x.y.tgzto unpack the downloaded file and create the directory
- Go to the directory containing third-party libraries by typing
- Install PyYAML and, optionally, Cython. This is done by going to the appropriate directories and typing
python setup.py install. It is possible that this requires superuser privileges, in which case contact the system administrator.
- Go to the pDynamo installation directory,
python Install.pyto install the library. This command can take a little while and will produce a lot of output.
- Set up the environment variables that are needed by the library. These are described in the file
00ReadMe.txtin the installation directory and are most conveniently placed in a shell configuration file, such as
.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.comand can be adapted as appropriate.
- To test the library, type
cd ../book/examplesand then
python RunExamples.py --allto run the full suite of examples or
python RunExamples.pyto 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.pyto see the differences between the generated outputs and the reference outputs provided with the installation.
- 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 10). To do so, go back to the installation directory and type
By default, installation does not process the Cython/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, install the version of Cython included in the source distribution (step 7) and then repeat the installation of pDynamo using the command:
python Install.py -f