next up previous contents
Next: 5 Offline Mode Namelist Up: UsersGuide Previous: 3 Namelist or Resource   Contents

4 History File Fields

In the following table we list the different fields that are currently output to CLM2.0 history files. The dimensions of each field may include time (days ince the beginning of the simulation, lat (number of latitude points, e.g., lat = 64 for a T42 simulation), lon (number of longitude points, e.g., lon = 128 for a T42 simulation), or levsoi (number of soil layers, levsoi = 10). If a field's default state is inactive, it will not appear on a history file unless its state is modified via the namelist variable FLDADD.

CLM2.0 History file fields
Soil time-invariant properties
WATSAT
description saturated soil water content (porosity)
units mm3/mm3
dimensions time,levsoi,lat,lon
default averaging constant (lakes, wetlands, glaciers excluded)
default active/inactive active
SUCSAT
description saturated soil matric potential
units mm
dimensions time,levsoi,lat,lon
default averaging constant (lakes, wetlands, glaciers excluded)
default active/inactive active
BSW
description slope of soil water retention curve
units unitless
dimensions time,levsoi,lat,lon
default averaging constant (lakes, wetlands, glaciers excluded)
default active/inactive active
ZSOI
description "node" depth of soil layer (depth of soil layer at which hydraulic/thermal properties are defined)
units m
dimensions time,levsoi,lat,lon
default averaging constant (lakes excluded)
default active/inactive active
DZSOI
description soil layer thickness
units m
dimensions time,levsoi,lat,lon
default averaging constant (lakes excluded)
default active/inactive active
Temperatures
TSA
description 2 m air temperature
units K
dimensions time,lat,lon
default averaging average
default active/inactive active
TV
description vegetation temperature
units K
dimensions time,lat,lon
default averaging average
default active/inactive active
TG
description ground temperature
units K
dimensions time,lat,lon
default averaging average
default active/inactive active
TSOI
description soil temperature
units K
dimensions time,levsoi,lat,lon
default averaging average (lakes excluded)
default active/inactive active
TLAKE
description lake temperature
units K
dimensions time,levsoi,lat,lon
default averaging average (averaging done only for valid (lake) subgrid patches)
default active/inactive active
TSNOW
description snow temperature
units K
dimensions time,lat,lon
default averaging average (horizontal averaging done only for valid subgrid patches (those which have snow, lakes excluded), vertical averaging is done over all valid snow layers)
default active/inactive active
Surface radiation
FSA
description absorbed solar radiation
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
FSR
description reflected solar radiation
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
NDVI
description surface normalized difference vegetation index
units unitless
dimensions time,lat,lon
default averaging average
default active/inactive active
FIRA
description net infrared (longwave) radiation
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
FIRE
description emitted infrared (longwave) radiation
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
Surface energy fluxes
FCTR
description canopy transpiration
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
FCEV
description canopy (intercepted) evaporation
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
FGEV
description ground evaporation
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
FSH
description sensible heat
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
FGR
description heat flux into snow/soil (includes snow melt)
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
FSM
description snow melt heat flux
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
TAUX
description zonal surface stress
units kg/m/s2
dimensions time,lat,lon
default averaging average
default active/inactive active
TAUY
description meridional surface stress
units kg/m/s2
dimensions time,lat,lon
default averaging average
default active/inactive active
Vegetation phenology
ELAI
description exposed one-sided leaf area index
units m2/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
ESAI
description exposed one-sided stem area index
units m2/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
Canopy physiology
RSSUN
description sunlit leaf stomatal resistance
units s/m
dimensions time,lat,lon
default averaging minimum (lakes excluded)
default active/inactive active
RSSHA
description shaded leaf stomatal resistance
units s/m
dimensions time,lat,lon
default averaging minimum (lakes excluded)
default active/inactive active
BTRAN
description transpiration beta factor (soil moisture limitation)
units unitless
dimensions time,lat,lon
default averaging average (lakes excluded)
default active/inactive active
FPSN
description photosynthesis
units unitless
dimensions time,lat,lon
default averaging average (lakes excluded)
default active/inactive active
Hydrology
H2OSOI
description volumetric soil water
units mm3/mm3
dimensions time,levsoi,lat,lon
default averaging average (lakes excluded)
default active/inactive active
H2OSNO
description snow depth (liquid water equivalent)
units mm
dimensions time,lat,lon
default averaging average
default active/inactive active
H2OCAN
description intercepted water
units mm
dimensions time,lat,lon
default averaging average
default active/inactive active
SOILLIQ
description soil liquid water
units kg/m2
dimensions time,levsoi,lat,lon
default averaging average (lakes excluded)
default active/inactive active
SOILICE
description soil ice
units kg/m2
dimensions time,levsoi,lat,lon
default averaging average (lakes excluded)
default active/inactive active
SNOWLIQ
description snow liquid water
units kg/m2
dimensions time,lat,lon
default averaging average (horizontal averaging done only for valid subgrid patches (those which have snow, lakes excluded), vertical averaging done by summing over all valid snow layers)
default active/inactive active
SNOWICE
description snow ice
units kg/m2
dimensions time,lat,lon
default averaging average (horizontal averaging done only for valid subgrid patches (those which have snow, lakes excluded), vertical averaging done by summing over all valid snow layers)
default active/inactive active
SNOWDP
description snow height
units m
dimensions time,lat,lon
default averaging average
default active/inactive active
SNOWAGE
description snow age
units unitless
dimensions time,lat,lon
default averaging average
default active/inactive active
QINFL
description infiltration
units mm/s
dimensions time,lat,lon
default averaging average
default active/inactive active
QOVER
description surface runoff
units mm/s
dimensions time,lat,lon
default averaging average
default active/inactive active
QRGWL
description surface runoff at glaciers, wetlands, lakes
units mm/s
dimensions time,lat,lon
default averaging average
default active/inactive active
QDRAI
description sub-surface drainage
units mm/s
dimensions time,lat,lon
default averaging average
default active/inactive active
QINTR
description interception
units mm/s
dimensions time,lat,lon
default averaging average
default active/inactive active
QDRIP
description throughfall
units mm/s
dimensions time,lat,lon
default averaging average
default active/inactive active
QMELT
description snow melt
units mm/s
dimensions time,lat,lon
default averaging average
default active/inactive active
QSOIL
description ground evaporation
units mm/s
dimensions time,lat,lon
default averaging average
default active/inactive active
QVEGE
description canopy (intercepted) evaporation
units mm/s
dimensions time,lat,lon
default averaging average
default active/inactive active
QVEGT
description canopy transpiration
units mm/s
dimensions time,lat,lon
default averaging average
default active/inactive active
QCHOCNR
description RTM river discharge into ocean
units m3/s
dimensions time,lat,lon
default averaging average
default active/inactive active (if RTM defined)
QCHANR
description RTM river flow (maximum subgrid flow)
units m3/s
dimensions time,lat,lon
default averaging average
default active/inactive active (if RTM defined)
Water and energy balance checks
ERRSOI
description soil/lake energy conservation error
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
ERRSEB
description surface energy conservation error
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
ERRSEBMX
description maximum of surface energy conservation error
units watt/m2
dimensions time,lat,lon
default averaging maximum
default active/inactive active
ERRSOL
description solar radiation conservation error
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
ERRH2O
description total water conservation error
units mm
dimensions time,lat,lon
default averaging average
default active/inactive active
Atmospheric forcing
RAIN
description rain
units mm/s
dimensions time,lat,lon
default averaging average
default active/inactive active
SNOW
description snow
units mm/s
dimensions time,lat,lon
default averaging average
default active/inactive active
TBOT
description atmospheric air temperature
units K
dimensions time,lat,lon
default averaging average
default active/inactive active
WIND
description atmospheric wind velocity magnitude
units m/s
dimensions time,lat,lon
default averaging average
default active/inactive active
THBOT
description atmospheric air potential temperature
units K
dimensions time,lat,lon
default averaging average
default active/inactive active
QBOT
description atmospheric specific humidity
units kg/kg
dimensions time,lat,lon
default averaging average
default active/inactive active
ZBOT
description atmospheric reference height
units m
dimensions time,lat,lon
default averaging average
default active/inactive active
FLDS
description incident longwave radiation
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
FSDS
description incident solar radiation
units watt/m2
dimensions time,lat,lon
default averaging average
default active/inactive active
Time-invariant grid fields (these are defined in subroutine histcrt.F90 and should not be changed)
EDGEN
description northern edge of surface grid
units degrees north
dimensions scalar
default averaging constant
default active/inactive active (if OFFLINE defined)
EDGEE
description eastern edge of surface grid
units degrees east
dimensions scalar
default averaging constant
default active/inactive active (if OFFLINE defined)
EDGES
description southern edge of surface grid
units degrees south
dimensions scalar
default averaging constant
default active/inactive active (if OFFLINE defined)
EDGEW
description western edge of surface grid
units degrees west
dimensions scalar
default averaging constant
default active/inactive active (if OFFLINE defined)
LON
description coordinate longitude
units degrees east
dimensions lon
default averaging constant
default active/inactive active
LAT
description coordinate latitude
units degrees north
dimensions lat
default averaging constant
default active/inactive active
LEVSOI
description coordinate soil levels
units m
dimensions levsoi
default averaging constant
default active/inactive active
TIME
description time
units days since beginning of run
dimensions time
default averaging constant
default active/inactive active
LONGXY
description longitude
units degrees east
dimensions lat,lon
default averaging constant
default active/inactive active
LATIXY
description latitude
units degrees north
dimensions lat,lon
default averaging constant
default active/inactive active
AREA
description grid cell area
units km2
dimensions lat,lon
default averaging constant
default active/inactive active
LANDFRAC
description land fraction
units unitless
dimensions lat,lon
default averaging constant
default active/inactive active
NUMLON
description number of longitudes at each latitude
units unitless
dimensions lat
default averaging constant
default active/inactive active
LANDMASK
description land/ocean mask
units (0.=ocean and 1.=land)
dimensions lat,lon
default averaging constant
default active/inactive active
Time-information fields (these are defined in sub routine histcrt.F90 and should not be changed)
MCDATE
description current date as 8 digit integer
units YYYYMMDD
dimensions time
default averaging instant
default active/inactive active
MCSEC
description current seconds of current date
units s
dimensions time
default averaging instant
default active/inactive active
MDCUR
description current day (from base day)
units unitless
dimensions time
default averaging instant
default active/inactive active
NSTEP
description time step
units unitless
dimensions time
default averaging instant
default active/inactive active
TIME_COMMENT
description history interval for time slice
units character
dimensions time,string_length(80)
default averaging instant
default active/inactive active


next up previous contents
Next: 5 Offline Mode Namelist Up: UsersGuide Previous: 3 Namelist or Resource   Contents
Mariana Vertenstein 2002-05-16