runmodelS: Run model under steady state conditions

View source: R/NicheMapRcode.R

runmodelSR Documentation

Run model under steady state conditions

Description

Rapid method for calculating below or above canopy or below ground microclimate under steady-state at one user specified height.

Usage

runmodelS(
  climdata,
  vegp,
  soilp,
  nmrout,
  reqhgt,
  lat,
  long,
  metopen = TRUE,
  windhgt = 2,
  surfwet = 1,
  groundem = 0.95
)

Arguments

climdata

data.frame of climate variables needed to run the run the model (dataset should follow format of weather())

vegp

a list of vegetation parameters as returned by microctools::habitatvars().

soilp

a list of soil parameters as returned by soilinit()

nmrout

a list of putputs from NicheMapR as returned by runNMR().

reqhgt

height (m) for which microclimate is needed.

lat

latitude of location (decimal degrees).

long

longitude of location (decimal degrees).

metopen

optional logical indicating whether the wind measurement used as an input to the model is from a nearby weather station located in open ground (TRUE) or above the canopy for which temperatures are modelled (FALSE - see details)

windhgt

height above ground of wind measurement. If metopen is FALSE, must be above canopy.

surfwet

proportion of leaf surface acting as free water surface

groundem

thermal emissivity of ground layer

Details

This is a rapid implementation of model when time increments are hourly such that transient heat fluxes and heat storage in canopy can be ignored. Computations are performed simultaniously on all data, negating need to run in timesteps. Also includes implementation of model with snow present. Should generally be run using wrapper function runwithNMR() but provided as a standalone function in case data for multiple heights are needed, in whihc case it can be run multiple times without also running NicheMapR.

Value

a data.frame with the following columns:

obs_time time of observation. Same as in climdata.

Tref Temperature (deg C) at reference height as in climdata

Tloc Temperature (deg C) at height reqhgt

tleaf Leaf temperature (deg C) at height reqhgt. -999 if reqhgt above canopy or below ground

RHref Relative humidity (percentage) at reference height as in climdata.

RHloc Relative humidity (percentage) at height reqhgt

RSWloc Total incoming shortwave radiation at height reghgt (W/m^2)

RLWloc Total downward longwave radiation at height reqhgt (W/m^2)

windspeed wind speed at height reqhgt (m/s)

dp fraction of Rswloc that is diffuse radiation


ilyamaclean/microclimc documentation built on July 28, 2023, 1:40 a.m.