____________________________________________________________________________

Weighted-Multiple-Linear Regression Program (WREG)
____________________________________________________________________________


The WREG program is documented in 

     Eng, Ken, Chen, Yin-Yu, and Kiang, Julie, 2009, User’s
          guide to the weighted-multiple-linear-regression
          program (WREG version 1.0): U.S. Geological Survey
          Techniques and Methods, book 4, chapter A8, 21 p.
          (http://pubs.usgs.gov/tm/4A8)

The report provides details on how to use the Weighted-Multiple-Linear 
Regression Program (WREG).  It can be used to set up, run, and evaluate 
a multiple-linear regression.  The methods used by the program have been 
customized for use in the regionalization of streamflow characteristics, 
many of the default methods may not be suitable for other regression 
problems.

The program is driven by a graphical user interface that leads the user 
through the process of setting up a regression.  A number of input files 
are required, and detailed output is available in text files generated 
by WREG.

____________________________________________________________________________

PROGRAM REQUIREMENTS
____________________________________________________________________________

To run WREG, you need:

   - Windows operating system.
   - Approximately 400 Mb of free disk space. 


____________________________________________________________________________

INSTALLING and LAUNCHING WREG
____________________________________________________________________________

1.  Unzip the distribution file (WREGv1.zip) and extract it to the 
    directory of your choosing.  There should be 3 fileS:

           MCRInstaller.exe, 
           WREGv1.exe, and 
           WREGv1.ctf 

    and 2 folders

          WREG_Source_Code and 
          Sample_Files.

2.  Run the program MCRInstaller.exe.  This program installs MATLAB 
    Component Runtime, software that allows the WREG executable program 
    to run. The installation program leads you through the process with 
    multiple GUI windows and may take several minutes to complete. 
    Administrator privileges are required.  

3.  WREGv1.exe and WREGv1.ctf should be copied to another folder that 
    contains input files and the program can be executed from that 
    location.  For example, copying the files into the folder 
    Sample_Files will allow execution of the program using the sample 
    input files.  Alternatively, input files can be copied to the 
    directory in which WREGv1.exe and WREGv1.ctf were installed.   

4.  WREGv1.exe is the program executable file and it is now ready to 
    run.  WREGv1.ctf is a required file that must be located in the 
    same working directory as WREGv1.exe.  After WREG is run for the 
    first time, another folder, WREGv1_mcr, will be created in the 
    working directory.  It contains additional files for running WREG.  
    These files should not be changed.  (If a new version of WREG is 
    provided, the files WREGv1.exe and WREGv1.ctf and the folder 
    WREGv1_mcr should all be deleted from the working directory. The 
    new WREG.exe and WREG.ctf should be placed in the directory.  
    A new WREG_mcr folder will be created the first time WREG is 
    executed.)  

5.  Double click on WREGv1.exe to start WREG.