8 History File Fields

The following sections discuss both the fields that may currently be output to CLM3.0 history tapes as well as code modifications that the user must make to add new fields to the history tapes.

Tables 9-18 list the fields that currently may be output to a CLM3.0 history tape. By default, these fields appear on the primary history tape. The dimensions of each field may include 'time' (days since the beginning of the simulation), 'levsoi' (number of soil layers, levsoi = 10), 'levlak' (number of lake layers, levlak=10), and 'lat' and 'lon' (number of latitude and longitude points, e.g., lat=64, lon=128 for a T42 simulation) for grid averaged two dimensional output, and 'gridcell', 'landunit', 'column' or 'pft' for one dimensional output. The dimensions of the RTM fields, QCHOCNR and QCHANR, include 'lonrof' and 'latrof', the number of latitude and longitude points on the RTM grid. The two RTM fields are always output on the 0.5 degree RTM grid regardless of the resolution of the model run. Note that the 1d dimension type appearing in the dimensions entry specifies only the default 1d output type. For example, 'TSA' will be output by default in pft 1d output. However, that default type may be changed for a given history tape via the setting of the namelist variable HIST_TYPE1D_PERTAPE. A history field may appear as single-level (SL) or multi-level (ML). Finally, unless explicitly specified in the description, all fields are time averaged over the requested history interval.

Table 9: Master Field List - Temperature and Humidity

Name	Description	Units	1d Output	Level	Spatial Validity
TSA	2-m air temperature	K	pft	SL	global
TV	vegetation temperature	K	pft	SL	global
TG	ground temperature	K	column	SL	global
TSOI	soil temperature	K	column	ML	lakes excluded
TLAKE	lake temperature	K	column	ML	only lakes included
TSNOW	snow temperature	K	column	SL	lakes excluded
TREFMNAV	daily minimum of hourly-averaged 2-m temperature	K	pft	SL	global
TREFMXAV	daily maximum of hourly-averaged 2-m temperature	K	pft	SL	global
Q2M	2-m specific humidity	kg/kg	pft	SL	global

Table 10: Master Field List - Surface Radiation

Name	Description	Units	1d Output	Level	Spatial Validity
FSA	absorbed solar radiation	W/m2	pft	SL	global
SABG	solar radiation absorbed by ground	W/m2	pft	SL	global
SABV	solar radiation absorbed by vegetation	W/m2	pft	SL	global
FSR	reflected solar radiation	W/m2	pft	SL	global
FSRVD	direct visible reflected solar radiation	W/m2	pft	SL	global
FSRND	direct near-infrared reflected solar radiation	W/m2	pft	SL	global
FSRVDLN	direct visible reflected solar radiation at local noon	W/m2	pft	SL	global
FSRNDLN	direct near-infrared reflected solar radiation at local noon	W/m2	pft	SL	global
FSRVI	diffuse visible reflected solar radiation	W/m2	pft	SL	global
FSRNI	diffuse near-infrared reflected solar radiation	W/m2	pft	SL	global
FIRA	net infrared (longwave) radiation	W/m2	pft	SL	global
FIRE	emitted infrared (longwave) radiation	W/m2	pft	SL	global

Table 11: Master Field List - Surface Energy Fluxes

Name	Description	Units	1d Output	Level	Spatial Validity
FCTR	canopy transpiration	W/m2	pft	SL	global
FCEV	evaporation of canopy-intercepted water	W/m2	pft	SL	global
FGEV	ground evaporation	W/m2	pft	SL	global
FSH	sensible heat flux	W/m2	pft	SL	global
FSH_G	sensible heat from ground	W/m2	pft	SL	global
FSH_V	sensible heat from vegetation	W/m2	pft	SL	global
FGR	heat flux into snow/soil (includes snow melt)	W/m2	pft	SL	global
FSM	snow melt heat flux	W/m2	column	SL	global
TAUX	zonal surface stress	kg/m/s2	pft	SL	global
TAUY	meridional surface stress	kg/m/s2	pft	SL	global

Table 12: Master Field List - Vegetation Phenology

Name	Description	Units	1d Output	Level	Spatial Validity
ELAI	exposed one-sided leaf area index	m2/m2	pft	SL	global
ESAI	exposed one-sided stem area index	m2/m2	pft	SL	global

Table 13: Master Field List - Canopy Physiology

Name	Description	Units	1d Output	Level	Spatial Validity
RSSUN	sunlit leaf stomatal resistance (minimum over time interval)	s/m	pft	SL	lakes excluded
RSSHA	shaded leaf stomatal resistance (minimum over time interval)	s/m	pft	SL	lakes excluded
BTRAN	transpiration beta factor (soil moisture limitation)	unitless	pft	SL	lakes excluded
FPSN	photosynthesis	unitless	pft	SL	global

Table 14: Master Field List - Hydrology

Name	Description	Units	1d Output	Level	Spatial Validity
H2OSOI	volumetric soil water (ratio of water to total soil volume)	mm3/mm3	column	ML	lakes excluded
H2OSNO	snow depth (liquid water equivalent)	mm	column	SL	global
FSNO	fraction of soil covered by snow	unitless	column	SL	global
H2OCAN	water on the canopy	mm	pft	SL	global
SOILLIQ	soil liquid water	kg/m2	column	ML	lakes excluded
SOILICE	soil ice	kg/m2	column	ML	lakes excluded
SNOWLIQ	snow liquid water	kg/m2	column	SL	lakes excluded
SNOWICE	snow ice	kg/m2	column	SL	lakes excluded
SNOWDP	snow height	m	column	SL	global
SNOWAGE	snow age	unitless	column	SL	global
QINFL	water infiltration in soil	mm/s	column	SL	global
QOVER	surface runoff	mm/s	column	SL	global
QRGWL	surface runoff at glaciers, wetlands, and lakes	mm/s	column	SL	global
QDRAI	sub-surface drainage	mm/s	column	SL	global
QINTR	canopy interception of precipitation	mm/s	pft	SL	global
QDRIP	throughfall	mm/s	pft	SL	global
QMELT	snow melt	mm/s	column	SL	global
QSOIL	ground evaporation	mm/s	pft	SL	global
QVEGE	evaporation of canopy-intercepted water	mm/s	pft	SL	global
QVEGT	canopy transpiration	mm/s	pft	SL	global
QCHOCNR	RTM river discharge into ocean (included if RTM defined)	m3/s	2-D only	SL	global
QCHANR	RTM river flow (included if RTM defined)	m3/s	2-D only	SL	global

Table 15: Master Field List - Water and Energy Balance Checks

Name	Description	Units	1d Output	Level	Spatial Validity
ERRSOI	soil/lake energy conservation error	W/m2	column	SL	global
ERRSEB	surface energy conservation error	W/m2	pft	SL	global
ERRSOL	solar radiation conservation error	W/m2	pft	SL	global
ERRH2O	total water conservation error	mm	column	SL	global

Table 16: Master Field List - Atmospheric Forcing

Name	Description	Units	1d Output	Level	Spatial Validity
RAIN	rain	mm/s	gridcell	SL	global
SNOW	snow	mm/s	gridcell	SL	global
TBOT	atmospheric air temperature	K	gridcell	SL	global
WIND	atmospheric wind velocity magnitude	m/s	gridcell	SL	global
THBOT	atmospheric air potential temperature	K	gridcell	SL	global
QBOT	atmospheric specific humidity	kg/kg	gridcell	SL	global
ZBOT	atmospheric reference height	m	gridcell	SL	global
FLDS	incident longwave radiation	W/m2	gridcell	SL	global
FSDS	incident solar radiation	W/m2	gridcell	SL	global
FSDSVD	direct visible incident solar radiation	W/m2	pft	SL	global
FSDSND	direct near-infrared incident solar radiation	W/m2	pft	SL	global
FSDSVDLN	direct visible incident solar radiation at local noon	W/m2	pft	SL	global
FSDSNDLN	direct near-infrared incident solar radiation at local noon	W/m2	pft	SL	global
FSDSVI	diffuse visible incident solar radiation	W/m2	pft	SL	global
FSDSNI	diffuse near-infrared incident solar radiation	W/m2	pft	SL	global

Table 17: Master Field List - Soil

Name	Description	Units	1d Output	Level	Spatial Validity
ZSOI	soil layer node depth	m	column	ML	lakes excluded
DZSOI	soil layer thickness	m	column	ML	lakes excluded
WATSAT	volumetric soil water at saturation (equal to the porosity)	mm3/mm3	column	ML	glaciers, wetlands, lakes excluded
SUCSAT	saturated soil matric potential	mm	column	ML	glaciers, wetlands, lakes excluded
BSW	slope of soil water retention curve	unitless	column	ML	glaciers, wetlands, lakes excluded

Table 18: Master Field List - Volatile Organic Compounds (only included if VOC defined)

Name	Description	Units	1d Output	Level	Spatial Validity
BIOGENCO	biogenic CO flux	1#1g/m2/h	pft	SL	global
ISOPRENE	isoprene flux	1#1g/m2/h	pft	SL	global
MONOTERP	monterpene flux	1#1g/m2/h	pft	SL	global
ORVOC	other reactive VOC flux	1#1g/m2/h	pft	SL	global
OVOC	other VOC flux	1#1g/m2/h	pft	SL	global
VOCFLXT	total VOC flux into atmosphere	1#1g/m2/h	pft	SL	global

Table 19: Master Field List - Dynamic Vegetation (only included if DGVM defined)

Name	Description	Units	1d Output	Level	Spatial Validity
FMICR	microbial respiration	1#1mol/m2/s	pft	SL	global
FRMS	stem maintenance respiration	1#1mol/m2/s	pft	SL	global
FRMR	root maintenance respiration	1#1mol/m2/s	pft	SL	global
FRMF	foliage maintenance respiration	1#1mol/m2/s	pft	SL	global
FRG	growth respiration	1#1mol/m2/s	pft	SL	global
FCO2	net CO2 flux	1#1mol/m2/s	pft	SL	global
DMI	net primary production	1#1mol/m2/s	pft	SL	global
HTOP	height of top of canopy	m	pft	SL	global
HBOT	height of bottom of canopy	m	pft	SL	global
TLAI	total one-sided leaf area index	m2/m2	pft	SL	global
TSAI	total one-sided stem area index	m2/m2	pft	SL	global
TDA	daily average 2-m temperature	K	pft	SL	global
T10	10-day running mean of 2-m temperature	K	pft	SL	global
AGDD0	growing degree-days base 0 degrees C	degree-days	pft	SL	global
AGDD5	growing degree-days base 5 degrees C	degree-days	pft	SL	global

Note that for snow related fields (e.g. SNOWLIQ), horizontal averaging is done only using columns that have snow. In this horizontal averaging, lake subgrid points are excluded. Furthermore, for snow related fields, vertical averaging is done by summing (e.g., SNOWLIQ) or averaging (e.g., TSNOW) only over valid snow layers.

Also note that additional history fields appear in the primary history file when DGVM is defined. In addition, a separate history file is produced once per year when DGVM is defined. This file is described in the CLM-DGVM user's guide.