Oklahoma State University

cmls94_readme.htm

                             CMLS94

                 INSTALLATION AND EXTRA INFORMATION


CMLS94 and associated files are distributed in a self-exploding file called
CMLSINST.EXE.  The following steps will install the software on your computer.

1. Create a subdirectory CMLS94 on your hard disk. (Another directory name can
   be used if you prefer.)  The CMLS94 subdirectory can be created using the
   command

       mkdir \CMLS94 

   NOTE: A minimum of 10 MB of disk space should be available.


2. Change directories so this new directory is the default using the command

       cd \CMLS94 


3. Copy the files included with CMLS94 to this subdirectory.

   If the software was obtained on disk mounted in drive a: use the command

       copy a:*.*  

   If the software was obtained via Internet, use ftp to copy the files to
   this directory.


4. Execute the installation software using the command

      CMLSINST -d 

   This will expand the compressed files and store them on the disk. It will
   also create subdirectories within the current directory so CMLS94 will be
   able to operate immediately.  NOTE: IF THE -d IS NOT USED IN THE ABOVE
   COMMAND, FILES WILL BE PLACED IN THE CURRENT DIRECTORY AND CMLS94 WILL NOT
   BE ABLE TO FIND THEM.

   When the above installation is completed your directory should contain the
   following:

    CMLSINST EXE      Installation program
    README   DOC      This document
    CMLS94   EXE      Executable CMLS94 program
    HELP     DAT      File of help messages
    MANUAL   HP       CMLS94 user's manual formatted for HP lasers
    MANUAL   WP       CMLS94 user's manual as Word Perfect file
    CMLS_OPT DAT      File used for default options
    BGI          Subdirectory containing graphics device drivers
    DATA         Subdirectory of databases used
    SIM          Subdirectory of output files created by CMLS94
    WEATHER      Subdirectory of sample weather files
    WGEN         Subdirectory of weather generating files from WGEN manual
    UTILITY      Subdirectory of programs for converting files
                      from CMLS form to CMLS94 form

5. If you have obtained CMLS94 via Internet, we recommend that you print
   the manual for instructions on using the software and an explanation
   of the processes and assumptions incorporated into it. The manual is 76
   pages in length.  Two forms of the manual are included with the software.

     File MANUAL.WP is a copy of the manual in Word Perfect 5.1/5.2 format;
                    Word Perfect 5.2 or later can be used to process this
                    file.

     File MANUAL.HP is a printer file which can be used with an HP
                    Series II (or a later model) laser printer to produce
                    the manual without using Word Perfect.  To print this
                    file simply copy the file to the printer using the DOS
                    command

                    COPY MANUAL.HP PRN /b 

                    Note: Be sure to use the /b option when copying
                          the binary file.


6. You are now ready to run CMLS94 using the command

      CMLS94 


7. When CMLS94 has been installed and is working and the manual has been
   printed, you may remove CMLSINST.EXE, MANUAL.HP, and MANUAL.WP from the
   disk.  This will free about 7 MB of disk space.


8. Soil databases: Sample soil databases are included with CMLS94 to enable
   new users to use the program before they must enter data for soil of
   interest to them. The databases are small. We expect users to enter
   soil properties for soils of interest to them. CMLS94 includes editing
   options for entering data for new soils. The required properties are
   easily obtained. Your local SCS office can likely provide help in this
   effort.


9. Chemical databases: Chemical properties used in CMLS94 and included in
   CHEMICAL.DB were taken from the publication of Wauchope et al. (1992).
   Those values can be modified with the built-in editor. New chemicals
   can also be added. See the manual for details.


10. Weather databases: The software is distributed with historical weather
   and weather generating parameters for three locations. Those ASCII files
   are stored in the WEATHER subdirectory. The weather database WEATHER.DB
   in the DATA subdirectory contains information needed by CMLS94 to access
   these data. You can add weather databases for your area as explained in
   the manual.

   A second weather database, WEATHRWG.DB, is also in the DATA subdirectory.
   That database can be used (instead of WEATHER.DB) to access weather
   generating parameters for more than 130 sites across the U.S.A. The
   parameters in those files were taken from the WGEN manual of Richardson
   and Wright. To access those data you will need to do the following:

     A. Run CMLS94 and select "Options" from the main menu
     B. Select "Files and Directories" from the sub-menu
     C. Change the name of the weather database from
        DATA\WEATHER.DB to DATA\WEATHRWG.DB
     D. Change the directory name for weather data from
        WEATHER\ to WGEN\
     E. Press F10
     F. If you want these files and directories to be the defaults,
        use the Save option to write the current settings to file
        CMLS_OPT.DAT

   See the manual for more details on Options.


12. WGEN weather generator: The weather generator incorporated into CMLS
   is WGEN, developed by C.W. Richardson and D.A. Wright(1984). Although the
   WGEN manual is out of print, the authors have given us permission to
   distribute copies of the manual. That is available in WGENMAN.EXE.
   That manual includes a FORTRAN program for calculating weather generating
   parameters from daily weather data for a site of interest to you.  Twenty
   or more years of historical data are recommended for generating these
   parameters.

Document Actions