MUD Data Format - Installation Guide

Platforms supported

The MUD library of routines has been written so that data files may be used on all supported platforms. All non-portable issues (byte ordering, floating-point representation) are handled by the library. The library has been ported to the following platforms:

• VAX/VMS (OpenVMS V6.1, VAXC)
• Alpha/VMS (OpenVMS V6.2)
• Alpha/Digital UNIX (Digital UNIX V3.2D-1)
• DECstations (ULTRIX V4.4)
• SGI (IRIX Release 5.3)
• Sun (SunOS Release 4.1.4)
• IBM PC/Linux (no FORTRAN routines)
• IBM PC/DOS (DOS 5.0, Borland C++ 3.1 - 16 bit) (no FORTRAN routines)

Getting the package

The latest version of the MUD Library and File Conversion Utility can be attained via DECnet. This will eventually be moved to an anonymous FTP site for increased availability. This is a ZIPped file that must be decompressed using unzip (or PKUNZIP). It will create subdirectories "lib" and "util".

Building the Library

The MUD Library consists of all of the routines necessary to read and write the format from applications written in either C or FORTRAN.

Change directory to the "lib" subdirectory. Then, type the make command appropriate to your operating system:

• VMS> mms
• Linux> make -f makefile.linux
• Unix> make
• DOS> make -f makefile.dos
  Note that the DOS port was done using Borland C++ (16 bit). Other environments (i.e., Microsoft C) have not been tested.

A library file will result from this step. Applications will also need the include file "mud.h" (for C) or "mud.finc" (for FORTRAN). Under DOS, "mud.finc" will be named "mud.fin".

Building the File Conversion Utility

The MUD File Conversion Utility is used to convert to and from a selection of old MuSR data formats and the MUD format. It also provides a diagnostic dump of the contents of a MUD format file, and a method of writing the histograms of a MUD format file to an ASCII text file. The program may be run in either batch or interactive modes. Using the "help" command within the program displays a usage summary.

Change directory to the "util" subdirectory. Then, execute the command(s) appropriate to your operating system:

• VAX/VMS> mms
• Alpha/VMS> mms/macro=(AXP=1)
• Unix> make
• DOS> make -f makefile.dos

You will then want to move the resulting executable to an appropriate location, or define paths (or symbols) to reference the executable in the current location.