FOAM History File Content

Back to Users Guide

Atmosphere

history.atmos.* -- CCM2 history format by default. Contains about 60 standard fields from the atmosphere. Use ccm2nc to convert to netcdf if not output in netcdf format.

Default variable list. (1-6 letter tags and long descriptions).

3D fields

• CLOUD - Cloud fraction
• CMFDQ - Q Tendency - moist convection K/s
• CMFDT - T Tendency - moist convection kg/kg/s
• CMFMC - Moist covection mass flux kg/m2/s
• DTCOND - T tendency - convective adjustment K/s
• DTH - T horizonal diffusive heating K/s
• DTV - T vertical diffusion K/s
• OMEGA - Vertical pressure velocity Pa/s
• QRL - Longwave heating rate K/s
• QRS - Solar heating rate K/s
• T - temperature K
• U - zonal wind component m/s
• UTGW - U tendency - gravity wave drag m/s2
• VTGW - V tendency - gravity wave drag m/s2
• V - merdional wind component m/s
• VQ - Meridional water transport m/s
• VT - Meridional heat transport K m/s
• VVPUU - Kinetic Energy m2/s2
• VZ - Meridional transport m3/s3
• Z2 - Geopotential Height (above sea level) m

tracer 3D fields

• Q - water vapor concentration (specific humidity) kg/kg
• DC01 - convective adjustment tendency of water vapor kg/kg/s
• VD01 - vertical diffusion tendency of water vapor kg/kg/s

2D fields

• ALB - Albedo
• ALBCLR - Clear sky albedo
• CLDHGH - Vertically-integrated, random overlap, high cloud amount
• CLDLOW - Vertically-integrated, random overlap, low cloud amount
• CLDMED - Vertically-integrated, random overlap, mid-level cloud amount
• CLDTOT - Vertically-inegrated, random overlap, total cloud amount
• CNVCLD - Random overlap total convective cloud amount
• FLNS - Net longwave flux at surface W/m2
• FLNSC - Clearsky net longwave flux at surface W/m2
• FLNT - Net longwave flux at top W/m2
• FSNS - Net solar flux at surface W/m2
• FSNSC - Clearsky net solar flux at surface W/m2
• FSNT - Net solar flux at top W/m2
• FSNTC - Clearsky net solar flux at top W/m2
• LHFLX - Surface latent heat flux W/m2
• ORO - ocean (0), land(1), sea ice(2) flag
• PBLH - PBL height m
• PHIS - surface geopotential m2/s2
• PRECL - Large-scale (stable) precipitation rate m/s
• PRECC - Convective precipitation rate m/s
• PS - surface pressure Pa
• PSL - Sea level pressure Pa
• QPERT - Perturbation specific humidity (eddies in PBL) kg/kg
• SHFLX - Surface sensible heat flux W/m2
• SNOWH - Water equivalent snow depth m
• SOLIN - Solar insolation W/m2
• SRFRAD - Net radiative flux at surface W/m2
• TAUGWX - East-west gravity wave drag surface stress N/m2
• TAUGWY - North-south gravity wave drag surface stress N/m2
• TAUX - X-component (east-west) of surface stress N/m2
• TAUY - Y-component (north-south) of surface stress N/m2
• TPERT - Perturbation temperature (eddies in PBL) K
• TS1 - surface temperature (level 1) K
• TS2 - surface temperature (level 2) K
• TS3 - surface temperature (level 3) K
• TS4 - surface temperature (level 4) K
• USTAR - Surface friction velocity m/s
• WET - soil moisture m

tracer 2D fields

• QFLX - Surface water flux kg/m2/s

Optional atmosphere history variables and changing the atmosphere history file content: The fields listed below may optionally be output in the atmosphere history file. To change the contents of the atmosphere history file, use the namelist variable PRIMARY to add fields or EXCLUDE to remove fields (requires FOAM 1.5.17 or later). Use the 1-6 letter tags given above and below.

Example. To remove omega and add relative humidity and the longitude pressure gradient to the atmosphere history, add the following lines to atmos_params:

• PRIMARY = 'RELHUM','DPSLON',
• EXCLUDE = 'OMEGA',

additional 3D fields

• CGH - Counter-gradient term for heat in PBL K/m
• CGQ - Counter-gradient term for moisture in PBL 1/m
• CGS - Counter-gradient coefficient on surface kinematic fluxes s/m2
• CLDLWP - Actual cloud liquid water path length (account for cloud fraction) g/m2
• CLOUDUP - Average of Cloud when omega is < 0 (up)
• CMFDQR - Specific humidity tendency due to convective rainout kg/kg/s
• CMFLQ - Moist convection total water flux W/m2
• CMFSL - Moist convection liquid water static energy flux W/m2
• DPSLON - Longitude Pressure Gradient m/s2
• DPSLAT - Latitude Pressure Gradient m/s2
• DQP - Specific humidity tendency due to precipitation kg/kg/s
• DUH - U horizontal diffusive heating K/s
• DUV - U vertical diffusion m/s2
• DVH - V horizontal diffusive heating K/s
• DVV - V vertical diffusion m/s2
• EFFCLD - Effective cloud fraction
• ETADOT - vertical (eta) velocity 1/s
• KVH - Vertical diffusion diffusivities (heat/moisture) m2/s
• KVM - Vertical diffusion diffusivities (momentum) m2/s
• MQ - water mass kg/m2
• NUMOMGUP - Percentage of time omega is < 0 (up)
• OMEGAUP - Average of Omega when omega is < 0 (up) Pa/s
• RELHUM - Relative humidity (0-100%)
• SETLWP - Specified liquid water path lengths g/m2
• TTEND - T tendency K/s
• UTEND - U tendency m/s2
• VTEND - V tendency m/s2

(Below are new with FOAM 1.5.30)

• UQ - Zonal water flux m/s
• UT - Zonal heat flux Km/s
• UU - Zonal u-momentum flux m2/s2
• UV - Zonal v-momentum flux m2/s2
• UW - Zonal w-momentum flux Pa m/s2
• VW - Meridional w-momentum flux Pa m/s2
• VV - Meridional v-momentum flux m2/s2
• WQ - Vertical moisture flux Pa m/s2
• WT - Vertical heat flux K Pa/s2
• WW - Vertical momentum flux Pa2/s2

additional tracer 3D fields

• DF01 - SLT tendency of water vapor kg/kg/s
• HA01 - horizontal advective tendency of water vapor kg/kg/s
• TA01 - total advective tendency of water vapor kg/kg/s
• TE01 - total tendency of water vapor kg/kg/s
• VA01 - vertical advective tendency of water vapor kg/kg/s

additional 2D fields

• PRECSL - Large-scale (stable) snow rate (water equivalent) m/s
• PRECSC - Convective snow rate (water equivalent) m/s
• TOTLWP - Vertically-integrated actual liquid water path length
• LPSTEN - Surface pressure tendency Pa/s

Ocean

The OM3 history files use a combination of floats and chars to compress the files by approx 2:1. Only 16 bits of information are retained.

• history.ocean.* -- 3D values for T,S,P,U,V,W

1000. appears where there's land.

• history.osurf.* -- Surface forcing plus surface and near surface term balance information for vertical diffusion and convection. Also total convective frequenecy for upper and lower ocean.

Use om32nc to convert to netcdf if not output in NetCDF format..

Coupler (including Land, Sea Ice and River models)

• history.coupl.*-- plain Fortran binary write with the following fields:
• ORO -- snapshot of land/ocean/sea ice mask
• TSSUB1,2,3,4 -- Over land: average temp of each layer of 4 layer soil model. Over ocean: SST.
• SNDPTH -- snow depth in meters
• THICKN -- sea ice thickness
• WS -- soil moisture in meters
• VOL -- river volume in meters-cubed
• OPREC -- precip in m/s
• OHEAT,OQFLX,OTAUX,OTAUY -- 4 ocean forcing fields
• SHF -- sensible heat flux
• LHF -- latent heat flux
• EVP -- evaporation
• RNF -- runoff at a land point
• SNM -- snow melt in meters
• ORNF -- runoff at a river mouth in m/s
• RAD -- total downward surface radiation
• LWV -- total upward longwave radiation
• FICE -- sea ice fraction
• TSNOW -- temp of snow on sea ice
• TINTER -- temp at snow/sea ice interface
• TICE1 -- temp of upper sea ice layer
• TICE2 -- temp of lower sea ice layer
• MELTP -- sea ice melt potential