SuperGEM(tm) 1.0 with S/Splus

SuperGEM(tm) is an implementation of the patient rule induction method (PRIM) for optimizing noisy functions of many variables described in Bump Hunting in High-Dimensional Data (compressed PostScript).

SuperGEM(tm) 1.0 provides a rudimentary interface for using PRIM with S [Becker, Chambers and Wilks(1988)] or Splus(r) [ Statistical Sciences, Inc., Seattle, WA].

Installation Instructions

It is assumed that S or Splus has already been installed on the computer. Details of the SuperGEM installation procedure depend upon the host platform upon which S/Splus in running. The two possibilities are UNIX, and a PC compatible computer running a Microsoft operating system (WINTEL). The first step for both is to choose a directory in which to store the files associated with SuperGEM. The full path name of this directory will be referred to as dir. Examples might be /home/your_name/gem (UNIX), or c:\gem (WINTEL).

UNIX

• Transfer all of the following files to dir:
• Shell script
• S-procedures
• Procedure help files: gemhelp, supgem , traj , sens , relfreq , rules, see, and vnames .
• One of the following, depending on the host computer: SGI or SUN .
• Execute the following commands in dir:
• mv SuperGEM.unx SuperGEM
• chmod u+x SuperGEM
• mv supgem.SGI supgem.exe (or mv supgem.SUN supgem.exe)
• chmod u+x SuperGEM.exe
• Change to the directory in which S/Splus is to be executed. This can be the dir directory, but it is not recommended.
• Enter the (UNIX) command to execute S/Splus. At the S/Splus command line enter the following commands:
• >gemhome _ "dir"
• >gemhost _ "unix"
• >source("dir/supgem.s")
• Here dir is the directory where the SuperGEM files have been stored.

WINTEL

• Transfer all of the following files to dir:
• Shell script
• S-procedures
• Procedure help files: gemhelp , supgem , traj , sens , relfreq , rules, see, and vnames .
• Executable.
• Execute Splus (double-click icon, or Start > Programs > Splus).
• Enter the following commands at the Splus command line:
• >gemhome _ "dir"
• >gemhost _ "wintel"
• >source("dir/supgem.s")

  Here dir is the directory where the SuperGEM files have been stored.

  For these commands substitute / for each \ in the definition of dir.

Documentation

After installation enter

>gemhelp()

at the S/Splus command line for information concerning documentation of the SuperGEM / S interface.

The PRIM procedure is described in Friedman and Fisher (1997) (compressed PostScript).

References

Becker, R. A., Chambers, J.M., and Wilks, A. R. (1988). The New S Language. Wadsworth & Brooks/Cole.

Friedman, J. H. and Fisher, N. I. (1997). Bump hunting in high dimensional data (compressed PostScript).