This file has most recent entries first.
Entries are separated by ==========
Topics within an entry are separated by -----  or - - - -
=====================================
1/3/03
Erik Kluzek says that:
"        There isn't much written documentation besides what's
in the code. Many of the variables will correspond to data
written out in the master list of history variables, but you
would have to figure out the correspondence of variable names.
There should be a short description of most variable names in
code comments (if not in write_restart*, then somewhere else).
If you have specific questions on particular variables go ahead
and let us know."

=====================================
12/20/02
It sounds like we'll concentrate on the restart file format

I downloaded source code (~/DAI/cam2.0.1) and traced restart source code
(see cam2.0.1/trace_restart)

None of these names appear in the master list (see end of this file)
although I believe they represent quantities that do

- - - - - - - -
Fields written out from write_restart_dynamics

vort(n3m1 and n3m2) ; not in master list
div(n3m1 and n3m2) ; not in master list
dpsl ; not in master list
dpsm
dps
phis
omga
           !
           ! Write fields u3,v3,t3,q3,ps at time indices n3 and n3m1
           !
u3(1,1,begj,n3m1)
v3(1,1,begj,n3m1)
t3(1,1,begj,n3m1)
ps(1,beglat,n3m1)

u3(1,1,begj,n3m2)
v3(1,1,begj,n3m2)
t3(1,1,begj,n3m2)
ps(1,beglat,n3m2)

q3(1,1,1,begj,n3m1)
q3(1,1,1,begj,n3m2)
           !
           ! Write slt arrays (trajectory mid-point coordinates and
           ! slt forcast of moisture and constituents
           !
lammp
phimp
sigmp
qfcst
- - - - - - - -
fields written out from write_restart_physics
!
! Buffer module variables
!
pblht
tpert
qrs
qrl
qpert
loops over ptimelevels around the following
cld(1,1,begchunk,n3tmp))
qcwat(1,1,begchunk,n3tmp))
tcwat(1,1,begchunk,n3tmp))
lcwat(1,1,begchunk,n3tmp))

!
! Comsrf module variables
!
#if (! defined COUP_CSM)
fsnt
fsns
#if (! defined COUP_CSM)
flnt
flns
loops over i=begchunk,endchunk
   tmpfield(:,i) = srfflx_state2d(i)%asdir(:)
  call write_field_from_chunk(nrg,1,1,1,tmpfield)
   tmpfield(:,i) = srfflx_state2d(i)%asdif(:)
  call write_field_from_chunk(nrg,1,1,1,tmpfield)
   tmpfield(:,i) = srfflx_state2d(i)%aldir(:)
  call write_field_from_chunk(nrg,1,1,1,tmpfield)
   tmpfield(:,i) = srfflx_state2d(i)%aldif(:)
  call write_field_from_chunk(nrg,1,1,1,tmpfield)

#if (! defined COUP_CSM)
asdirice
asdifice
aldirice
aldifice
tsice
#endif

do i=begchunk,endchunk
  tmpfield(:,i) = srfflx_state2d(i)%lwup(:)
end do
tmpfield
landfrac
landm
sgh
                 tmpfield(:,i) = srfflx_state2d(i)%ts(:)
tmpfield
                 tmpfield3d(:,:,i) = surface_state2d(i)%tssub(:,:)
tmpfield3d
sicthk
snowhland
         #if (! defined COUP_CSM)
snowhice
         #else
               snowhice = 0.
         #endif
loops around indented lines
ncol = get_ncols_p(i)
 tmpfield(:ncol,i) = surface_state2d(i)%flwds(:ncol)
call write_field_from_chunk(nrg,1,1,1,tmpfield)
 tmpfield(:ncol,i) = surface_state2d(i)%sols(:ncol)
call write_field_from_chunk(nrg,1,1,1,tmpfield)
 tmpfield(:ncol,i) = surface_state2d(i)%soll(:ncol)
call write_field_from_chunk(nrg,1,1,1,tmpfield)
 tmpfield(:ncol,i) = surface_state2d(i)%solsd(:ncol)
call write_field_from_chunk(nrg,1,1,1,tmpfield)
 tmpfield(:ncol,i) = surface_state2d(i)%solld(:ncol)
call write_field_from_chunk(nrg,1,1,1,tmpfield)

trefmxav
trefmnav
icefrac
=====================================
12/10/02
www.ccsm.ucar.edu/models/atm-cam/UsersGuide/UG-20a.html
   2.3.1.1 Initial Conditions Dataset

(where does the "prognostic" list end? TS4? LANDFRAC can't really be prognostic)

prognostic variables U, V, T, Q,  PS, CWAT, TSICE, SNOWHICE
and TS1 through TS4, the surface geo-potential field PHIS,
the grid-box land fraction LANDFRAC, the land ocean transition
mask LANDM, and the standard deviation of geo-potential height SGH.
When running flux-coupled the fields: TSICE, SNOWHICE, LANDFRAC and
TS1 through TS4 are not included on the dataset.

Table of required fields
Table 2.6: Atmospheric Component Initial Dataset Fields
 History file  Variable Description
 Field Name    Name     Multi-Level Fields
Multi Level Fields
 T             T        temperature  (K)
 U             u        zonal wind component (m/sec)
 V             v        meridional wind component  (m/sec)
 Q             q        water vapor specific humidity (KgH2O/Kgair)
 CWAT          q(:,:,,ixcldw,:) cloud water mass mixing ratio (Kgcloud/Kgair)
Single Level Fields
 PHIS          phi      surface geo-potential (m2/s2)
 PS            Ps       surface pressure  (Pa)
 SGH           SGH      standard deviation of geo-potential height  (m)
 LANDM                  landm Land Ocean transition mask:
                          = 0   ocean
                          = 1   continent
                          = 0-1 transition
 TSICE         T_ice    CSIM sea-ice model snow/ice surface temperature (not stored on
                          CCSM flux-coupled simulations).
 SNOWHICE               Snow depth over ice
 LANDFRAC               Land fraction
 TS1,TS2,TS3,TS4 T_s    Four CSIM sea-ice subsurface temperature levels (not stored on
                          CCSM flux-coupled simulations) (K)
--------------------------------

www.ccsm.ucar.edu/models/atm-cam/UsersGuide/UG-45.html

2.5 Model Output Datasets

Table of all output variables w/ characteristics.
Instructions for changing output lists.


