********************************************************************************
                               File READWTM.TXT
         Downloading and installing TWMEAN and its interface to Splus
********************************************************************************

TWMEAN is a library of S functions for the computation of the truncated and the weighted
mean of asymmetric distributions. TWMEAN requires ROBETH to be loaded into S-Plus. 
TWMEAN 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:

    twmwin.exe    (object files, self extracting zip-file;   may 2005)
    twmwin_v6.exe (the same file but for Splus 6.x;          oct. 2001)
    twmman.exe    (manual, self extracting ps and pdf-files; july 2003)

(b) For R (version >= 1.5.1) / Windows, copy the following file in a temporary 
    directory
    twmR_win.exe  (DLL+source, self extracting zip file;     may 2005)
    twmman.exe    (manual, self extracting ps and pdf-files; july 2003)

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

    twmsrc.tar.Z  (program sources, compressed; may 2005).
    twmman.ps.Z   (manual, compressed ps-file;  august 1999)

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

1. Execute the self-extracting file 

   twmwin.exe (or twmwin_v6.exe for Splus 6.x or twmR_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 self-extracting file twmman.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(robwbl,T)

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

II) Installation under UNIX:

The installation of TWMEAN 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 TWMEAN 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 twmean. Type:

   mkdir twmean

3. Decompress the tar file:

   cd twmean 
   zcat <your.path>/twmsrc.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 wtmean)
   Splus
   > data.restore("<your.path>/twmean.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("atmean.q")
#   > source("auxav.q")
#   > source("auxint.q")
#   > source("avtmean.q")
#   > source("tcmean.q")
#   > source("wgmean.q")
#   > source("auxifp.q")
#   > source("pfun.q")
#   > source("newacov.q")
#   > source("tsmean.q")
#   > q()
    Goto step 6.

5. Compile and link (ld command) tcmean.f and wgtmean.f to a file called twmean. 
   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(twmean,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(twmean,T)

[End of file]