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.