/ NCAR / CGD / CMS / CCM3 / [ CCM3 ] [ Processor ] [ LSM ] [ CSM ]


Welcome to the CRM Homepage

What is the CRM?
CRM News
Download CRM software
FAQ
README
INSTALL
ChangeLog
Version Info
Known Problems

What is the CRM?

The Column Radiation Model, or CRM, is a standalone version of the radiation model used in the NCAR Community Climate Model (CCM). The CRM is composed of the actual subroutines from the CCM which have been modified as little as possible in order to run in a standalone mode. The CRM is freely available (see below) and is a useful tool for scientific studies of the Earth's solar and infrared energy budgets, greenhouse gas and aerosol radiative forcing, and column closure experiments. We would like to begin assembling a list of references to papers which employed the CRM. Please send us your references!


CRM News

2000/02/25: CRM 2.1.2 is released. This fixes inconsistencies in mls_clr.out and mls_cld.out accidentally introduced in CRM 2.1.1. 2000/01/04: CRM 2.1.1 is released. CRM 2.1.1 is a bugfix release. This version fixes a bug introduced in 2.1.0 in which the diagnostic arrays containing the vertical profile of the LW fluxes (variables flx_LW_dwn, flx_LW_up and flx_LW_net) were not always initialized correctly. On some machine/compiler combinations, this bug caused incorrect answers in these arrays (especially if the CRM was compiled with PLON > 1). Single level fields (e.g., flnt, flntc, flns, flds, flus) were not affected by this bug. Thanks to Mike Iacono for reporting the bug and supplying the patch. Users of Solaris f90 and Solaris f77 should read the Known Problems before deciding whether to upgrade.

There is now a WWW front end to the CRM available on the Web. Professor Brian Fiedler of the School of Meteorology at the University of Oklahoma has created a simple point and click interface to the CRM called CRM Online. CRM Online allows interactive setting of tropospheric and stratospheric temperatures, CO2 mixing ratio, and specific humidity.

1999/09/07: CRM 2.1 is released. Version 2.1 includes archival of many more diagnostic quatities. New quantities which are now automatically archived include spectral optical depths, spectral fluxes, vertical profiles of SW and LW fluxes, and spectral albedos. In addition, the build mechanism has been simplified and generalized. There are no new physics and answers do not change so upgrading is not necessary. CRM 2.1 requires a decent Fortran 90 compiler to advantage of these new features.

Who should upgrade? User who would like access to vertical and spectral information previously unavailable in the CRM diagnostics should upgrade. Download sample text and netCDF output files from the CRM version 2.1 to see if you would benefit from upgrading. Users of Solaris f90 and Solaris f77 should read the Known Problems before deciding whether to upgrade.

1999/07/02: CRM 2.0.2 is released. Version 2.0.2 is a maintenance release. Changes include improved FAQ, build features, and more diagnostices in crm.nc. There are no new physics and answers do not change so upgrading is not necessary.

1998/08/28: CRM 2.0 is released. Version 2.0 is based on the newly released CCM 3.6, and implements all applicable CCM namelist parameters. Run-time specification of for these parameters (e.g., trace gas concentrations, orbital parameters, aerosol optical depth) is implemented via additional lines in the input files. The new input files are backwards compatible with older CRM input files. Many more diagnostics (e.g., optical depths, spectral albedos) are implemented. All users are urged to upgrade to CRM 2.0

1998/07/22: CRM 1.16 is released. Version 1.16 uses a new directory structure more similar to the CCM directory structure. There are no physics changes in CRM 1.16. The new directory structure is now under CVS control and this should facilitate maintainance of the CRM.

1998/07/10: CRM 1.15 is released. Version 1.15 fixes a bug introduced in the surface radiation budget (SRB) diagnostics of CRM 1.13 (released March, 1998). The direct/diffuse partitioning of fluxes in versions 1.13--1.14 of the CRM was incorrect. The total and spectral fluxes were not affected by this bug. See the ChangeLog for details. All users are urged to upgrade to CRM 1.15.


Download CCM3 CRM software source distribution (115 Kb).

The distribution includes the complete CRM source code necessary to build and run the CRM on your own machine.


See the FAQ file.

`FAQ' is a list of Frequently Asked Questions about the CRM. Please read this file before sending questions to the CRM maintainers.


See the README file.

`README' briefly describes the CCM3 CRM, links to further documentation, and contact information for further questions.


See the INSTALL file.

`INSTALL' contains the CCM3 CRM installation instructions.


See the ChangeLog file.

`ChangeLog' contains the most up-to-date information on the latest CRM improvements. There is no need to install minor, unannounced upgrades to CRM unless a problem you are having with CRM is listed in `ChangeLog' as having been fixed in the latest revision.


Current release of CRM is

You can easily tell whether you have the most recent version, and whether you should upgrade by reading the ChangeLog.


Known Problems with CRM:

20000211: CRM compiled in single precision Solaris f90 dumps core

Symptoms: After printing the Heating Rates, CRM dies in the netCDF output routine. Some versions of Solaris f90 will produce garbage in the netCDF output file, but some will core dump.

Cause: Input data to netCDF output routines is single precision not double precision. Related to 19990907 problem below.

Solution: Either convert all CRM code to double precision, or convert netcdf.F file to expect single precision, or live without netCDF output.

20000113: Solaris f90 fails to compile code

Symptoms: radcsw.F, radclw.F, radded.F fail to compile because of CDIR IVDEP directives

Cause: Unknown, probably dependent on compiler version

Solution: Comment out CDIR IVDEP directives in these files

19990907: GNU make version 3.77 has a bug in wildcard function on Solaris causing make to fail

Symptoms: make command fails because source file list is empty. This can be verified by typing make debug

Cause: Bug in GNU make

Solution: Use GNU make version 3.76 or 3.78 on Solaris

19990907: Solaris f90 does not support -r8 -i4

Symptoms: CRM produces single precision results and netCDF output file crm.nc is full of garbage (or dumps core as in 20000211 problem)

Cause: Compiler limitation, use of non-standard Fortran by CRM

Workaround: Use f77 on Solaris and #undef CRM_SRB in misc.h to remove Fortran90 code. See INSTALL file for example compile command. Note that most diagnostic fields require the Fortran90 code, so a CRM compiled with f77 will produce much smaller output files.

Alternate workaround: Do not use CRM version 2.1 or later on Solaris



/ NCAR / CGD / CMS / CCM3 / [ CCM3 ] [ Processor ] [ LSM ] [ CSM ]


Address questions and comments about the CRM to Charlie Zender,
zender@uci.edu