********************************************************************************
                               File READGAM.TXT
         Downloading and installing ROBGAM and its interface to Splus
********************************************************************************

ROBGAM is a set of programs for the computation of M-estimates of the parameters of the Gamma
distribution. As ROBGAM requires ROBETH, before installing ROBGAM you need to install ROBETH. 
ROBGAM is available at the URL:

          http://www.iumsp.ch/Unites/us/msp_us.htm (=> software)

Downloading
-----------
(a) For Splus 4.x, Splus 2000 or Splus 6.x/Windows, copy the following files
    in a temporary directory:

    gamwin.exe    (object files, self extracting zip file;  july 2003)
    gamwin_v6.exe (the same file but for Splus 6.x;         july 2003)
    gamman.exe    (manual, self extracting ps and pdf-file; july 2003)

(b) For R (version >= 1.5.1) / Windows, copy the following file in a temporary 
    directory

    gamR_win.exe  (DLL+source, self extracting zip file;    july 2003)
    gamman.exe    (manual, self extracting ps and pdf-file; july 2003)

(c) For Splus 3.1/UNIX (and more recent versions), copy the following files in
    a temporary directory (noted <your.path> below):

    gamsrc.tar.Z  (program sources, compressed; july 2003)
    gamman.ps.Z   (manual, compressed ps-file; april 1997)


I) Installation for Splus or R under Windows:
---------------------------------------------

1. Execute the self-extracting file 

   gamwin.exe (or gamwin_v6.exe for Splus 6.x or gamR_win.exe for R)
   
   The name of the directory where the file will be "unzipped" must 
   be entered. For a standard installation, it is:

             c:\Program Files\sp2000\library 
   or      
             c:\Program Files\splus6\library
   or
             c:\Program Files\R\rwNNN\library

   
   Same procedure for the file gamman.exe (S-Plus only).

   Remark: Installation for Splus 3.x/Windows is no more available.  

2. To invoke the library 
   a) under Splus, use the Splus commands:

   > library(robeth,T)
   > library(robgam,T)

   b) under R, use the R commands:
   > library(robeth)
   > library(robgam) 

II) Installation under UNIX:

The installation of ROBGAM follows the general ROBETH installation procedure described
in the ROBETH file README/genral.txt. If you have write access to the Splus HOME directory,
the most convenient way to install ROBGAM is the creation of a public library. Otherwise,
create your private library and skip step 1 below.

1. Change to the Splus HOME directory:

   cd <your Splus HOME dir>/library

2. Create the new directory robgam. Type:

   mkdir robgam

3. Decompress the tar file:

   cd robgam 
   zcat <your.path>/gamsrc.tar.Z | tar xvf -


4. Create the Splus objects. If your Splus version is 4.x or lower, type:

   mkdir .Data      (as a sub-directory of robgam)
   Splus
   > data.restore("<your.path>/robgam.dmp")
   > q()
   If your Splus version is 5.0 or higher, step 4 and 5 (compilation) are
   achieved by typing:
   
    Splus CHAPTER
    Splus make
#   If not yet done type: 
#   Splus
#   > source("robgam.q")
    > q()
    Goto step 6.

5. Compile and link (ld command) robgam.f to a file called robgam. 
   For more details, follow the hints in genral.txt. See also the
   file loadobj.com. 

6. To invoke the public library, open Splus and type:

   > library(robeth,T)   
   > library(robgam,T)
   
7. For a private library, create a file "mylib.q" for example, containing
   the following line:
   assign("lib.loc","<the path to the library>",frame=0)
   In my case, I have: assign("lib.loc", "/users/arandria", frame=0)
   Then after opening Splus, type:

   > source("mylib.q")
   > library(robeth,T)
   > library(robgam,T)

[End of file]