RUMP: Welcome and Introduction


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:


Relationship between RUMP and GENPLOT

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.


Source Code and Modifications

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.


Algorithm and Data References

  1. Algorithms for the Rapid Simulation of Rutherford Backscattering Spectra, L.R. Doolittle, Nucl. Inst. Meth. B9, 344 (1985).
  2. A Semiautomatic Algorithm for Rutherford Backscattering Analysis, L.R. Doolittle, Nucl. Inst. Meth. B15, 227 (1986).
  3. Empirical Stopping Powers for Ions in Solids, J.F. Ziegler, J.P. Biersack, and U. Littmark, IBM Research Report RC9250 (1982).
  4. Numerical Recipes, Press, Flannery, Teukolsky and Vetterling, (Cambridge University Press, 1986).
  5. Backscattering Spectrometry, W.K. Chu, J.W. Mayer and M.-A. Nicolet, (Academic Press, NY, 1978).
  6. Ion Beam Handbook for Material Analysis, J.W. Mayer and E. Rimini, (Academic Press, NY, 1977).
  7. L.R. Doolittle, Ph.D Thesis, (Cornell University, Ithaca, NY 1987).

Distribution Notes


Starting RUMP

\syntax{RUMP [ini_file]}{Start RUMP with optional initialization file} \syntax{PERT [ini_file]}{Start RUMP and PERT with optional initialization file}

RUMP and PERT may be started directly from the .EXE files distributed in the 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 RUMP.BAT or 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.


Initialization

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.


RUMP Data Files

RUMP requires only a single data file, the atomic stopping power and isotope information file. The stopping power tables are initially loaded from atom3.dat in the default directory. These tables, as distributed, are configured for alpha particle energies between 0.35 and 3.5 MeV. See the LOAD command and the QSTOPP and STOPP programs for generating alternate stopping power tables. Resonance cross section files are also, by default, located in the c:\rump} directory and loaded as requested by the LOAD command.

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.


Last modified: November 21, 1996
Michael O. Thompson (mot1@cornell.edu)