df_forcing variables

Tip

  1. Need help? Please let us know in the SUEWS Community.

  2. Please report issues with the manual on GitHub Issues (or use Report Issue for This Page for page-specific feedback).

  3. Please cite SUEWS with proper information from our Zenodo page.

orphan:

df_forcing variables#

Note

For SUEWS users: These are the meteorological forcing variables required to run SUEWS.

For the modern YAML configuration, specify your forcing file path using model.control.forcing.file in your configuration.

Data structure of df_forcing is explained here.

RH#
Description:

Relative Humidity [%] (measurement height z is specified in site properties)

Tair#
Description:

Air temperature [°C] (measurement height z is specified in site properties)

U#
Description:

Wind speed [m s-1] (measurement height z is specified in site properties)

Wuh#
Description:

External water use [m3]

fcld#
Description:

Cloud fraction [tenths]

id#
Description:

Day of year [DOY]

imin#
Description:

Minute [M]

isec#
Description:

Second [S]

it#
Description:

Hour [H]

iy#
Description:

Year [YYYY]

kdiff#
Description:

Diffuse radiation [W m-2] Recommended in this version. if SOLWEIGUse = 1

kdir#
Description:

Direct radiation [W m-2] Recommended in this version. if SOLWEIGUse = 1

kdown#
Description:

Incoming shortwave radiation [W m-2] Must be > 0 W m-2.

lai#
Description:

Observed leaf area index [m-2 m-2]. Used only when model.physics.laimethod is set to 0; otherwise ignored. When active, the scalar value is applied uniformly to all three vegetation classes (evergreen trees, deciduous trees, grass) each day, and every timestep must carry a non-missing, non-negative observation. The -999 missing sentinel (and other negative placeholders) is not permitted on this path; if observations are unavailable, either switch back to calculated LAI or gap-fill the forcing with non-negative values first. Observed values are clamped into each vegetation class’s [laimin, laimax] envelope at runtime — see Prescribing Observed LAI for the rationale (downstream rescaling requires LAI <= laimax) and guidance on configuring laimin/laimax so legitimate observations (e.g. zero-LAI winter dieback) are not clipped.

ldown#
Description:

Incoming longwave radiation [W m-2]

pres#
Description:

Barometric pressure [kPa] (measurement height (z) is needed in SUEWS_SiteSelect.txt)

qe#
Description:

Latent heat flux [W m-2]

qf#
Description:

Anthropogenic heat flux [W m-2]

qh#
Description:

Sensible heat flux [W m-2]

qn#
Description:

Net all-wave radiation [W m-2] (Required if NetRadiationMethod = 0.)

qs#
Description:

Storage heat flux [W m-2]

rain#
Description:

Rainfall [mm] (measurement height (z) is needed in SUEWS_SiteSelect.txt)

snow#
Description:

Snow cover fraction (0 – 1) [-] (Required if SnowUse = 1)

wdir#
Description:

Wind direction [°] Not available in this version.

xsmd#
Description:

Observed soil moisture [m3 m-3] or [kg kg-1]