********************************************************************************
                               File READCOX.TXT 
         Downloading and installing ROBCOX and its interface to Splus
********************************************************************************

ROBCOX is a program for the computation of the robust Cox test. ROBCOX requires 
ROBETH, ROBGAM, ROBWBL and ROBNRM. ROBCOX is available at the URL:

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

Downloading
-----------
(a) For Splus 3.2/Windows (and more recent versions), copy the following files:

    coxwin.exe     (object files, self extracting zip-file;     september 2002)
    coxwin_v6.exe  (object files, self extracting zip-file;     september 2002)
    coxman.exe     (manual, self extracting ps and pdf files;   september 2002)
    dcompar.o      (object file compiled for Splus 3.x/Windows; september 2002)


(b) For Splus 3.1/UNIX (and more recent versions) copy the following files:

    coxsrc.tar.Z   (program sources, compressed;          september 2002)
    coxman.tar.Z   (manual, compressed ps and pdf files;  september 2002)

Installation
------------
Under Windows:

1. Execute the self-extracting file 

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

             c:\spluswin\library   
   or   
             c:\Program Files\sp2000\library
   or
             c:\Program Files\splus6\library
   
   Same procedure for the file coxman.exe.

   For Splus 3.x, copy the object file dcompar.o to the robcox library directory and rename
   it dcompar.obj, thus overwriting the file used by Splus 4.x.    
 
2. To invoke the library under Splus, use the Splus commands:

   > library(robeth,T)
   > library(robgam,T);library(robwbl,T);library(robnrm,T)
   > library(robcox,T)

Under UNIX:

The installation of ROBCOX 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 ROBCOX 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 robcox. Type:

   mkdir robcox

3. Decompress the tar file:

   cd robcox
   zcat <your.path>/coxsrc.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 robcox)
   Splus
   > data.restore("<your.path>/robcox.dmp")
   > q()

   If your Splus version is 5.x or higher, step 4 and 5 (compilation) are
   achieved by typing:
   
    Splus CHAPTER
    Splus make

5. Compile  and link (ld command) dcompar.f to a file called dcompar. 
   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);library(robwbl,T);library(robnrm,T)
   > library(robcox,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);library(robwbl,T);library(robnrm,T)
   > library(robcox,T)

[End of file]