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.