The Radxfer Package

For lack of a Better Name

Requirements

You must download and install a java developer kit (version 1.4.0 or higher). I suggest the SUN jdk for Linux, Solaris, and Windows as I have found a couple of bugs in serialization with the IBM development kit. You must also install Apache Ant, an open source build tool for java.

Note: Debian users can use apt-get to install the "ant" package, however the jdk can not be distributed via debian's servers due to restrictive license policies.

Steps to install radxfer-package:

  1. Download the latest version.
  2. gunzip and untar the radxfer-package-xxx.tar.gz file (where xxx is the version number).
  3. Change into the radxfer-package-xxx directory and run ant. (Be sure that the JAVA_HOME and ANT_HOME environment variables are correctly set.) You will be asked to specify the directory in which the radxfer package is to be deployed, this directory will be created if it does not exist. All the compiled java class files, shell or bat scripts (depending on if you use a unix operating system or windows), molecular data files, and documentation will be placed in subdirectories of this deployment directory.
  4. Near the end of the output for the ant build process, the script will indicate two environment variable which you must set in order to run the radxfer programs. The first, MOLDATA, indicates the directory where the molecular parameter files are stored. The second, CLASSPATH, is a java specific variable indicating where compiled class files are found. More information about the CLASSPATH environment variable is available here for linux and solaris and here for Windows.
  5. Additional help is now available in the "doc" subdirectory of the deployment directory.

Notes

The source code I have written is covered by the Artistic License 2.0beta4, the text of which is in the file LICENSE. This is a GPL compatible license, please review it if you plan on distributing this code to other people. In addition to the code I have written, I also include three external software packages with this package. This first is the java FITS library nom.tam.fits. The second is the Java Matrix Package (JAMA). The third is BeanShell which is dual licensed under both the Sun Public License and the Gnu Lesser Public Liceense.