The same as User:PeterWilliams. For some reason that account doesn't seem to work anymore.
The MIRIAD Installation Instructions Mess
There are too many sets of instructions for how to install MIRIAD. Here's my attempt to list them all:
- On the CARMA wiki:
- My MIRIAD MacPort page
- Ramprasad Rao's Mac OSX page
- Peter Teuben's site:
- ATNF installation instructions
- SMA user guide notes
- Notes on Columbia wiki
Tentative updated instructions for installing MIRIAD with the autotools:
Miriad can be compiled and installed using a standard system known as the "GNU autotools". We refer to this as the "new" build style in the context of Miriad. These standard tools are maintained by the broader open-source community and so are almost universally available and provide maximum portability and correctness.
Note that it is usually easiest to install miriad via Miriad binary releases. You may, however, wish to compile Miriad from the source yourself if:
- There aren't any binary releases for your system architecture.
- You want to modify Miriad tasks yourself.
- You want to have the most up-to-date version of Miriad possible by tracking and building the CVS source tree.
- You want an installation built via the GNU autotools, for which there are no binary releases, instead of the classic build system.
Easiest Installation Instructions
- Decide on your installation prefix, an absolute directory name which we will call
PREFIX. The Miriad files will be installed underneath
PREFIXin directories named
lib, etc., using the same structure as seen in
/usron Unix systems. Good choices might be
/swon Fink-using Mac machines. If
PREFIXis in a system-wide location, you will probably need access to superuser privileges (via
su) to run the installation.
- Decide which telescope's data you want to customize your Miriad build for. Supported options are
wrst. We will call this choice
- Download and unpack the Miriad source code.
cdto the top Miriad source code directory.
- Optionally you can issue
cvs updatehere to update the tree with the latest updates.
./configure --prefix=PREFIX --with-telescope=TELESCOPE, substituting the capitalized words with the choices you made above. This program will perform a bunch of checks to make sure that your system is capable of compiling Miriad.
configurereports an error, you have to resolve it. Unfortunately, the messages returned by
configureare not always easy to decipher. Your local system administrator may be able to help you understand the output of
configureeven if he or she is not familiar with Miriad in particular.
configurecompletes successfully, run
maketo compile all of Miriad.
makeshould as well. However, if your system has an unusual setup then the
configuretests may miss something that results in the
makefailing. You should contact the Miriad developers (see below) to help them understand and fix the issue.
makecompletes successfully, run
make installto install Miriad into the prefix you chose. If you need superuser permissions to run the installation, you may need to run
sudo make installor
su -c "make install". If
make installfails, it's extremely likely that there is a permissions problem, which your local system administrator should be able to help you understand.
- The Miriad files are now in place. To set up your shell login to work with Miriad, you need to configure various environment variables. This can be accomplished by sourcing the file
MYPREFIX/lib/miriad/automiriad.cshif you use a C shell or
MYPREFIX/lib/miriad/automiriad.sh(note the different extension) if you use a Bourne shell. You could put the necessary
sourceshell command in your shell initialization scripts or in an alias to automate this step.