Introduction Relationship between RUMP and GENPLOT Source Code and Modifications Algorithm and Data References Distribution Notes Starting RUMP Initialization RUMP Data Files
RUMP version 2.0, an ANSI C based program ported from an earlier FORTRAN version, is specifically designed for the analysis and simulation of Rutherford Backscattering Spectrometry (RBS) data. The original FORTRAN code was developed at Cornell university in Dr. J.W. Mayer's research group by then graduate students L.R. Doolittle and M.O. Thompson with assistance from R.C. Cochran. The development of efficient simulation algorithms and semi-automatic search algorithms formed a major part of L.R. Doolittle's thesis. Numerous graduate students and researchers at Cornell and other sites have since contributed. We wish to especially acknowledge Dr. E.J. Kramer's group at Cornell for introducing equations to SIM as well as being the impetus for the forward scattering support. Dr. P. Revesz is also acknowledged for numerous improvements in both the code and user interface including most recently the smoothing algorithms. Finally, we most gratefully acknowledge all of the past and current graduate students at Cornell and users elsewhere who have used the program for real analysis and data reduction. We firmly believe that the value of RUMP stems directly from the fact that it is used by the same people who are responsible for its development.
The specific meaning of the acronym RUMP (other than the obvious) is a question often raised. Let us set the record straight; the name was invented solely to avoid trademark infringement - the earliest name of this package was based on the specific MCA in use at Cornell. However, for those who demand full accounting and explanations, we offer the following relatively accurate expansions for term RUMP:
RUMP is always distributed with a related package, GENPLOT. Although similar, RUMP is designed specifically for the analysis and simulation of Rutherford Backscattering Spectrometry (RBS) data. GENPLOT is a much more general scientific data analysis and plotting package. Both packages were initially written around the same graphics and token processing libraries to provide a consistent (but not identical) user interface. Although they diverged in the FORTRAN versions because of memory limitations, they have again merged and are closely linked in these versions.
On one level, RUMP and GENPLOT are designed as equivalent software levels - both are the upper shell of a kernal data analysis and graphics package. Strictly speaking, RUMP is neither a subset of GENPLOT nor is GENPLOT a subset of RUMP. They are equivalent programs utilizing a common set of graphics and system support libraries. Indeed, spectra may be transferred transparently from RUMP to GENPLOT (for analysis that is beyond the capabilities or imagination of RUMP). Commands available in either packages can be divided into two classes; upper level commands implemented within the main program itself and lower level commands implemented in the underlying library. PLOT is an upper level command and hence operates in a slightly different manner in each package. However, SCRIPT and ANNOTE are support library commands and are identical in both RUMP and GENPLOT. The number of distint commands is relatively small, but it is important to bear in mind the differences if working with both packages.
The algorithms and subroutines comprising RUMP version 1.0 (FORTRAN) are in the public domain. However, the specific C code implemented in version 2.0 remain copyrighted although it is freely available to the scientific community. The code, if not included in your distribution, may be requested through CGS. Modification is permitted as needed, and may be distributed to others for use with RUMP as long as the copyright notices are retained. Commercial exploitation without the explicit permission of the copyright holder, however, is not permitted. CGS will act as a general repository for code corrections and enhancements and will attempt to disseminate modifications in an orderly manner.
.ADTfile as described in the appendix.
.RBSfiles has changed only slightly from the DOS version. The new format is necessary only for multiple spectra stored in a single data file and is written only when necessary. This should eliminate the need for any new translation programs. The file format is described in an appendix.
RUMP and PERT may be started directly from the
.EXE files distributed in
RUMP directory. RUMP and PERT differ only in that RUMP has all
routines associated with the PERT commands nulled out to save space. Hence,
RUMP is a complete subset of PERT. Both RUMP and PERT require a full 640 kB
configuration and will not run if a substantial number of terminate and stay
resident routines have been loaded (TSR's).
Because of the large memory requirements of RUMP and PERT, they are normally
executed from the batch files
PERT.BAT. These batch
files define an environment variable
HDATA.CHR which causes only 4
character sets to be loaded into the graphic plotting routines. The batch
files point RUMP initialization to
RUMP.INI and PERT initialization to
PERT.INI or as specified on the calling command line.
The default directory for RUMP internal data files and the initialization file is c:\rump. RUMP will search for atomic stopping power data files, resonance cross section tables and the initialization files in this directory if not found elsewhere. The search order is (1) check for an environment variable with the same name as the requested file and use the value of the environment variable as the actual filename, (2) check for file in the current directory and (3) check for file in the default directory.
RUMP automatically loads the ATOM3.DAT file during initialization. This file must contain the atomic stoppping power data. Next, RUMP searches for the default initialization file RUMP.INI or the initialization file specified on the command line. If an initialization file is found, it will be executed as a macro file after other initialization. The file is always executed with ECHO OFF. Initialization files should configure RUMP with the appropriate facility dependent parameters.
Many other data files are part of the underlying subsystem and are loaded from the c:\genplot directory. RUMP only files which are located in c:\genplot are include RUMP_RDR.OVL and RUMP_DYN.OVL. These files contain additional executable code for RUMP.EXE and PERT.EXE.