The tarred source code of ZEUS-MP and related utility files can be downloaded here. On the web page, results of the test problems are provided for reference. Other related publications and information are also provided for further consultation.
Once the tarred file is obtained, copy the file to a designated location and untar the file

tar xvf zeusmp10.tar

Total four subdirectories will be created (/exe, /src, /test, /pp). The /exe is empty at this moment. All ZEUS-MP source codes are located in /src. In /test, you will find total 9 input parameter files (zmp_inp.xxx) and ZEUS-MP definition files (zeusmp.def.xxx) for 5 test problems. The procedure of running the test problems in the test suite will be described in the section "Running the Test Suite" of this guide. The utility files are located at /pp, which are for the postprocessing of the HDF dump files.

In the /src directory, a Makefile is provided which will perform the compilation of source codes and linking of appropriate libraries. This Makefile supports SGI/Cray Origin 2000 and required to be modified for other platforms. The Makefile is organized in the way that all platform dependence commands are located at the top portion of the Makefile ("macro definitions"). Users need to modify this part for their computing platform and appropriate paths for related libraries.

Modifications of the "Fortran object files" and "dependencies" in the Makefile for different problem generators are required and explained in the next section.

When the Makefile is ready, start the compilation by entering:

make -f Makefile compile

The Makefile will look for the definition file (zeusmp.def) in /src and the input parameter file (zmp_inp) in /exe for the preprocessing, compiling, and linking processes according to the required physics and geometry. Therefore, make sure the correct zeusmp.def and zmp_inp exist in the correct directories before starting the compilation.

The definition file, zeusmp.def, is very important in the preprocessing stage during the compilation. ZEUS-MP is a powerful code which can handle different physics, geometries, and boundary conditions. By modifying the definition file, users can compile the code for their specific choices of coordinate system, different algorithms for physics, and even data output format. All of the definitions are briefly explained in the individual subroutines.

When the compilation is completed without error, the executable file, zeusmp.x, will be located at /exe and ready to use. To change the problem, such as changing the size of the grid, number of processors, arrangement of processors for spatial decomposition, algorithms used, geometry, and other control parameters, the input parameter file and the definition file need to be modified accordingly. If modification of the problem is just changing some physical input quantities, such as magnetic field strength or density, no re-compilation is required. For changes like spatial decomposition or geometry, re-compilation is necessary. Before starting a new compilation, remove the existing preprocessed and compiled files in /src by entering:

make clean

and compile the source codes again as described above. A detail example of compiling the zeusmp code for a blast problem is shown in the section "Running the Test Suite".