|
void | UpdateGridValues (clTreePopulation *p_oPop) |
| Performs the grid updating each timestep.
|
|
void | GetData (xercesc::DOMDocument *p_oDoc) |
| Triggers all light setup.
|
|
void | PopulateGLIBrightnessArray () |
| Populates the GLI brightness array.
|
|
void | PopulateSailLightBrightnessArray () |
| Populates the sail brightness array.
|
|
float | GetDayAngle (int iJulianDay) |
| Computes day angle.
|
|
float | GetDeclination (float &fDayAngle) |
| Computes solar declination.
|
|
float | GetEccentricity (float &fDayAngle) |
| Computes solar eccentricity.
|
|
float | GetSunrise (float &fLatInRadians, float &fDeclination) |
| Computes sunrise.
|
|
float | GetCosineOfZenithAngle (float &fDeclination, float &fLatInRadians, float &fTimeNow) |
| Computes cosine of the zenith angle of the sun at a given time.
|
|
float | GetAltitudeAngle (float &fCosZenAng) |
| Computes altitude angle of the sun at a given time in radians.
|
|
float | GetAzimuthAngle (float &fDeclination, float &fLatInRadians, float &fAltInRad, float &fTimeNow) |
| Computes azimuth angle of the sun at a given time in radians in SORTIE azimuth coordinates.
|
|
float | GetAirmassEffect (float &fAltInDeg, float &fCosZenAng) |
| Computes the airmass effect for a given altitude angle.
|
|
float | GetBeamRadiation (float &fClearSkyTransCoeff, float &fAirmass, float &fEccentricity, float &fCosZenAng) |
| Computes beam radiation strength.
|
|
virtual float | GetLightExtinctionCoefficient (clTree *p_oTree) |
| Gets the light extinction coefficent.
|
|
|
clGrid * | mp_oLightGrid |
| Grid object which holds the light values.
|
|
enum clBasalAreaLight::iTreeType * | mp_iSpeciesTypes |
| What type each species is.
|
|
float * | mp_fStatus |
| The status of each species, as angiosperm or conifer.
|
|
float | m_fA |
| The "a" parameter for the mean light function.
|
|
float | m_fConiferB |
| The conifer "b" parameter for the mean light function.
|
|
float | m_fAngiospermB |
| The angiosperm "b" parameter for the mean light function.
|
|
float | m_fConiferC |
| The conifer "c" parameter for the mean light function.
|
|
float | m_fAngiospermC |
| The angiosperm "c" parameter for the mean light function.
|
|
float | m_fSigma |
| The sigma parameter of the lognormal PDF function.
|
|
float | m_fMinDbh |
| The minimum DBH for trees to count towards density in a cell.
|
|
float | m_fRadius |
| The search radius for trees.
|
|
float | m_fChangeThreshold |
| The amount by which total basal area in a cell has to change in order to trigger a new light calculation.
|
|
short int | m_iGridLightCode |
| Return code for the "Light" data member of the "Basal Area Light" grid.
|
|
short int | m_iGridConBACode |
| Return code for the "Con BA" data member of the "Basal Area Light" grid.
|
|
short int | m_iGridAngBACode |
| Return code for the "Ang BA" data member of the "Basal Area Light" grid.
|
|
bool | m_bGridUpdated |
| Whether or not the "Basal Area Light" grid has been updated this timestep.
|
|
bool | m_bHooked |
| Whether or not this shell object is hooked to clLightOrg.
|
|
bool | m_bNeedsCommonParameters |
| Whether or not this shell object requires the common light parameters held in clLightOrg such as clLightOrg::m_iLastJulDay.
|
|
float ** | mp_fBrightness |
| Sky brightness array.
|
|
float ** | mp_fPhoto |
| Simulated fisheye photo array.
|
|
float | m_fMinSunAngle |
| The altitude angle below which the sky is assumed to be dark.
|
|
float | m_fAzimuthOfNorth |
| The azimuth angle of north.
|
|
int | m_iNumAziAng |
| Number of azimuth angles into which the sky hemisphere is divided.
|
|
int | m_iNumAltAng |
| Number of altitude angles into which the sky hemisphere is divided.
|
|
int | m_iMinAngRow |
| Row in the brightness array corresponding to the minimum solar angle.
|
|
short int | m_iNumSpeciesTypeCombos |
| How many type/species combos a behavior will act on.
|
|
short int | m_iNumBehaviorSpecies |
| How many distinct species are in the combo list - important for filling species-specific values from parameter file.
|
|
short int * | mp_iWhatSpecies |
| List of distinct species - for filling species-specific values from parameter file.
|
|
stcSpeciesTypeCombo * | mp_whatSpeciesTypeCombos |
| Array of species/type combos that the behavior will act on.
|
|
short int | m_iNewTreeInts |
| The number of new tree integer data members this behavior wants to add.
|
|
short int | m_iNewTreeFloats |
| The number of new tree float data members this behavior wants to add.
|
|
short int | m_iNewTreeChars |
| The number of new tree character data members this behavior wants to add.
|
|
short int | m_iNewTreeBools |
| The number of new tree boolean data members this behavior wants to add.
|
|
short int | m_iBehaviorListNumber |
| The number of this behavior in the behavior list, to differentiate between possible multiple copies of this behavior.
|
|
float | m_fVersionNumber |
| Version number - this will be rounded to 2 digits after the decimal place.
|
|
std::string | m_sXMLRoot |
| XML root that encloses the parameters for this behavior.
|
|
float | m_fMinimumVersionNumber |
| Minimum version number - this behavior will run parameter data for a file marked between this number and the current version number, inclusive.
|
|
std::string | m_sNameString |
| If a behavior has registered a command line command with the sim manager, this allows it to be called.
|
|
clSimManager * | mp_oSimManager |
| Pointer to the simulation manager object.
|
|
int * | mp_iAllowedFileTypes |
| List of the input file types this object can handle.
|
|
int | m_iNumAllowedTypes |
| Number of input file types this object can handle.
|
|
Basal Area Light - Version 1.0.
This behavior calculates light level as a function of local tree basal area. Basal area is split between conifers and angiosperms. The two basal area totals are used to calculate a mean light level, which is used to choose a random value from a lognormal probability distribution. In order to ensure some level of continuity through time, a grid cell's light level is not recalculated unless the local tree basal area has changed by more than a threshold set by the user.
A grid, "Basal Area Light", is used to store light values. Trees get the light levels of their grid cell.
The mean light level for a grid cell is calculated as follows:
GLIm = a / (1 + (BAa/ca) ba + (1 + (BAc/cc) bc) where:
-
GLIm is the mean light level, as a value between 0 and 100
-
BAa is angiosperm basal area, in square meters, within the user-specified radius of the "Basal Area Light" cell's center
-
BAc is conifer basal area, in square meters, within the user-specified radius of the "Basal Area Light" cell's center
-
a is a parameter
-
ba and ca are parameters for angiosperms
-
bc and cc are parameters for conifers
For purposes of basal area calculation, each species is assigned to "conifer" or "angiosperm" status. Seedlings and snags are never counted in basal area. Other trees only count if they have a DBH above a user-set minimum.
After the mean light level is calculated, it is turned into a "location
parameter" (mu) for the lognormal PDF as follows:
μ = ln(mean) - (σ 2)/ 2 The mu value is used as the zeta value in a lognormal random draw.
Note that this behavior is dependent on the size of grid cells for its behavior.
This behavior creates a new grid called "Basal Area Light". There's more on that grid below.
The namestring for this behavior is "basalarealightshell"; the parameter file call string is "BasalAreaLight".
Copyright 2011 Charles D. Canham.
- Author
- Lora E. Murphy
Edit history:
--------------—
October 20, 2011 - Wiped the slate clean for SORTIE 7.0 (LEM)