File: doc/ReadMe.htm
Software: Century version 5

This file contains last-minute updated information about any issues concerning the Century model and the Century Model Interface.

Contents

1. Files and utilities
2. Requirements for Microsoft Windows^TM systems
3. Uninstalling this software on Microsoft Windows^TM systems
4. Running the command-line version of the Century model
5. Using the ncfilelist utility
6. Using the ef2csv utility
7. Using ncgen and ncdump
8. Contacting the Natural Resource Ecology Laboratory
9. Copyright and Disclaimer
10. Revision history of this document

1. Files and utilities

In the installation directory you will find the following files which run the Century files and associated utilities (Note: on UNIX systems, the file name extension, ".exe", is not present.):

2. Requirements for Microsoft Windows^TM systems

Required system features:

• Hardware: Pentium-class CPU or better.
• Operating System: Microsoft Windows 98, ME, NT, 2000, XP.
• Display: 800x600 pixel resolution or higher.
• Disk space: 10 MB for installation; more for simulation files.

Recommended system features:

• Memory: The minimum physical memory requirements for the version of Microsoft Windows™ which you are running.
• Spreadsheet software to view and graph simulation results.

3. Uninstalling this software on Microsoft Windows™ systems

1. From the Control Panel, select "Add/Remove Programs" by double-clicking on the icon with the left mouse button.
2. In the list of programs, select "Century Model".
3. Press the "Add/Remove" button.

Note: This procedure will NOT remove files you have created after installing this software, including preferences, site, management, and simulation results files. You must remove these files manually.

4. Running the command-line version of the Century model

To run a Century simulation using the command-line version, enter the following command in an MS-DOS window:

century [options]

where options (do not enter the brackets) are:

Example command line:

 century -s mySite -m myManagement -o myOutput -ts -ar
-da

If the file century.exe is not a directory specified in your PATH variable (both on Microsoft Windows and UNIX systems), you should supply the path in the command name. On Microsoft Windows systems, if there are spaces in the directory names in the path, enclose the entire name in double-quotes, e.g.,

 "C:\Program Files\Century Model\century.exe
[options]" 

On Microsoft Windows systems, you can create a batch file to store this command for you. The batch file would then be kept in a directory in your search path. For example, the batch file may be called century.bat and contain only the following line:

 "C:\Program Files\Century Model\century.exe" %1 %2
%3 %4 %5 %6 %7 %8 %9 

5. Using the ncfilelist utility

Displays names and descriptions of Century netCDF files located in the directory from which it is executed. To run ncfilelist, enter the following command:

 ncfilelist [options] 

where options (do not enter the brackets) are:

The command-line items in brackets indicate optional items.

Note: The ncfilelist utility is copyrighted as shown below, and may only be distributed with the Century installation package. This utility may not be altered without explicit written permission from the copyright owner.

Copyright Notice

ncfilelist: Copyright (c) 1999 Thomas E. Hilinski. All rights reserved.

6. Using the ef2csv utility

Translates a Century erosion output file (in netCDF format) into a comma-separated values text format for import into spreadsheets. To run ef2csv, enter the following command:

 ef2csv [options] [erosion file name] 

where options (do not enter the brackets) are:

The command-line items in brackets indicate optional items.

If no erosion file name is specified, then no translations will occur. The erosion file name you specify should contain either no file name extension, or the extension "nc" (e.g., erosion-output.nc). Any other extension will generate an error message. Remember, the name generated by Century for the erosion output file will always contain the "nc" extension.

Copyright Notice

ef2csv: Copyright (c) 1999 Thomas E. Hilinski. All rights reserved.

7. Using ncgen and ncdump

For information about the NetCDF utilities ncgen and ncdump, see the online documentation at the NetCDF web site:

http://www.unidata.ucar.edu/packages/netcdf/

8. Contacting the Natural Resource Ecology Laboratory

You can contact the Natural Resource Ecology Laboratory at Colorado State University online through the Internet using a World-Wide Web (WWW) browser. The addresses for the web site is:

www.nrel.colostate.edu

The Century model WWW homepage contains additional information on the model, including online documentation. You can access the Century 5 model homepage at:

www.nrel.colostate.edu/projects/century5/century5.html

You can email for information on the Century model to:

Century@nrel.colostate.edu

9. Copyright and Disclaimer

See the file doc/Copyright.txt for the copyright and disclaimer for this software package.

Microsoft Windows, Microsoft Windows 98, and Microsoft Windows NT, Microsoft Windows ME, Microsoft Windows 2000, Microsoft Windows XP are trademarks of the Microsoft Corporation.

The ncfilelist and ef2csv utilities are copyrighted as follows: Copyright (c) 1999 Thomas E. Hilinski. All rights reserved.

10. Revision history of this document