CORHEL is a C shell script that obtains and processes photospheric magnetogram
to run the solar corona model and then processes the result to run the helio-
spheric model.


System Requirements:
1. 32-bit Intel Pentium processor.     | 32-bit PowerPC processor.
2. RedHat Linux version 2.0.           | Macintosh OS X 10.3 and 10.4.
3. 1GB of RAM.                         | 512MB of RAM.
4. 350 MB of available hard drive space.
5. Able to run 'wget' command.
6. Java compiler version 1.4 or higher.


Compilation/Installation Procedure:
1. Macintosh OS X requires IBM XL Fortran compiler (XLF).
   Linux requires Intel Fortran compiler (IFC).
2. The Fortran compiler must be in the pathname.
3. Run the corhel installation script from the terminal by typing
        "./install_corhel"


Execution Procedures:
1. Graphical User Interface Mode.
   Run the GUI executable from the terminal by typing "./run_corhel_gui"
   a. Images:
      - Left Image : Display raw input data.
      - Right Image: Display preprocessed MAS input data.

   b. Common Input Parameters:
      - Carrington Rotation
      - Resolution
      - Observatory
      - Palette
      - Max Mode
      - Image Scale Min
      - Image Scale Max
      - Polefitting:
        -- Th 0: Extrapolation Band Min.
        -- Th 1: Extrapolation Band Max.
        -- Th R: Extrapolation Point.

   c. Buttons:
      - Coronal Options     : Display a window containing all the input
                              parameters for running MAS.
      - Process Corona Input: Preprocess MAS input data.
      - Run Corona          : Run MAS.
                              In this version, this will also process ENLIL
                              input data and run ENLIL.
      - Heliospheric Options: Display a window containing all the input
                              parameters for running ENLIL. (Disabled)
      - Process Helio Input : Preprocess ENLIL input data. (Disabled)
      - Run Helio Input     : Run ENLIL. (Disabled)
      - Help                : Display a help window. (Disabled)
      - Reset               : Reset all the input parameters to default.
      - Quit                : Exit the program.

   Example: "./run_corhel_gui"
            displays a window with a Carrington rotation of 1913, resolution
            'low', and all of the optional arguments set to the default value.

2. Command Line Mode.
   Run the Batch executable from the terminal by typing
        "./run_corhel_batch -cr <int> -res <str> [dtmax <float>]
         [-dtmin <float>] [-ebmax <float>] [-ebmin <float>] [-epoint <float>]
         [-lund <float>] [-mmmax <int>] [-observ <string>] [-plotlist <str>]
         [-rho <float>] [-rl <int>] [-temp <float>] [-tmax <int>]
         [-tpltxint <int>] [-visc <float>]"

   a. Required arguments:
       -cr      : Carrington rotation.
                  Value: 1625 <= cr <= 2007 and cr > 2010.
       -res     : Resolution.
                  Value: 'low' or 'medium'.

   b. Optional arguments:
       -dtmax   : Delta time maximum.
                  Value: 0.01 <= dtmax <= 1.0 and dtmax >= dtmin.
                  Default value: 0.05.
       -dtmin   : Delta time minimum.
                  Value: 0.001 <= dtmin <= 1.0 and dtmin <= dtmax.
                  Default value: 0.005.
       -ebmax   : Extrapolation band maximum.
                  Value: 0.0 <= ebmax <= 1.57 and ebmax >= ebmin.
                  Default value: 0.45.
       -ebmin   : Extrapolation band minimum.
                  Value: 0.0 <= ebmin <= 1.57 and ebmin <= ebmax.
                  Default value: 0.25.
       -epoint  : Extrapolation point.
                  Value: 0.0 <= epoint <= 1.57 and ebmin <= epoint <= ebmax.
                  Default value: 0.35.
       -lund    : Lundquist number.
                  Value: lund > 0.0. Default value: 1.0e3.
       -mmmax   : Maximum mode.
                  Value: 0 <= mmmax <= 20. Default value: 9.
       -observ  : Observatory name.
                  Value: 'kittpeak' or 'wilcox'. Default value: 'kittpeak'.
       -plotlist: Output parameters.
                  Value must be one or more from this list, separated by
                  comma with no space in between:
                    vr,vt,vp,br,bt,bp,rho,t,p,jr,jt,jp,ar,at,ap
                  Default value: vr,vt,vp,br,bt,bp,rho,t,p.
       -rho     : Density.
                  Value: density > 0.0. Default value: 2.0.
       -rl      : Outer radial boundary.
                  Value: 1 <= rl <= 30. Default value: 30.
       -temp    : Temperature.
                  Value: temp > 0.0. Default value: 1.8e6.
       -tmax    : Maximum time.
                  Value: 0 <= tmax <= 200. Default value: 120.
       -tpltxint: Output interval.
                  Value: 1 <= tpltxint <= tmax. Default value: 20.
       -visc    : Viscosity.
                  Value: visc > 0.0. Default value: 0.01.

    Example: "./run_corhel_batch -cr 1913 -res low"
             runs CORHEL with a Carrington rotation of 1913, low resolution,
             and all of the optional arguments set to the default value.


Read the 'UserGuide.pdf' file in the 'doc' directory for more information about
CORHEL.
