clRelativeGrowth Class Reference

Relative growth - Version 1.2. More...

#include <RelativeGrowth.h>

Inheritance diagram for clRelativeGrowth:

clMichMenBase clGrowthBase clBehaviorBase clWorkerBase

List of all members.

Public Member Functions

 clRelativeGrowth (clSimManager *p_oSimManager)
 Constructor.
 ~clRelativeGrowth ()
 Destructor.
float CalcDiameterGrowthValue (clTree *p_oTree, clTreePopulation *p_oPop, float fHeightGrowth)
 Applies growth as described in the equation above.
float CalcHeightGrowthValue (clTree *p_oTree, clTreePopulation *p_oPop, float fDiameterGrowth)
 Applies growth as described in the equation above.
void SetNameData (char *cNameString)
 Captures the behavior name passed from the parameter file.
void DoShellSetup (xercesc::DOMDocument *p_oDoc)
 Does setup.

Protected Attributes

float * mp_fExp
 Diameter or height exponent - array size is number of species.
float m_fNumberYearsPerTimestep
 Number of years per timestep - from sim manager.


Detailed Description

Relative growth - Version 1.2.

This is a growth shell object which applies the Michaelis-Menton function to find relative growth. It can be used to grow either the diameter or the height. Height and diameter growth are calculated slightly differently; the diameter growth matches the historical method which goes back to Pacala 1996, and the height growth grows the way I think it should be grown.

The growth equation is:

Y = (A * gli) / ((A/S) + gli)
where Y is the relative annual growth (cm radial in the case of diameter, cm in the case of height), A is asymptotic growth (diameter or height), gli is the amount of light, and S is the slope of growth response.

The actual amount of new diameter growth is:

G = ((Y + 1)T - 1) * diamQ
where Y is from the equation above, T is the number of years per timestep, diam is the tree's diameter, and Q is the diameter exponent.

(There are some strangenesses in the math - 1s are added and subtracted at various times and I don't know why. This is based on code I didn't originally write.)

Height growth is:

G = Y * HQ
where G is height grown in cm and H is the height in cm. This is looped over the number of years per timestep, allowing H to increment at each intermediate year.

Diameter growth may be limited to a max of the adult constant area increment or the adult constant radial increment (see clConstantRadialGrowth and clConstantBAGrowth for more on how these increments are calculated and applied).

An object of this class can be created by the strings "relradial" (relative diameter growth limited by constant radial increment), "relba" (relative diameter growth limited by constant basal area increment), "relunlim" (non-limited relative diameter growth), and "relative michaelis-menton height growth" (height growth, always non-limited).

The namestring for this class is "relativegrowthshell". It is probable that there will be more than one object of this class created.

Copyright 2003 Charles D. Canham.

Author:
Lora E. Murphy

Edit history:
-----------------
April 28, 2004 - Submitted as beta (LEM)
October 26, 2005 - Added diameter exponent and updated version to 1.1
April 14, 2008 - Added height growth and updated version to 1.2

Constructor & Destructor Documentation

clRelativeGrowth::clRelativeGrowth ( clSimManager p_oSimManager  ) 

Constructor.

Sets the namestring.

Parameters:
p_oSimManager Sim Manager object.

clRelativeGrowth::~clRelativeGrowth (  ) 

Destructor.


Member Function Documentation

float clRelativeGrowth::CalcDiameterGrowthValue ( clTree p_oTree,
clTreePopulation p_oPop,
float  fHeightGrowth 
) [virtual]

Applies growth as described in the equation above.

Parameters:
p_oTree Tree for which to calculate growth.
p_oPop Tree population.
fHeightGrowth Amount of height growth, in m (ignored).
Returns:
Amount of growth increase, in cm.

Reimplemented from clGrowthBase.

float clRelativeGrowth::CalcHeightGrowthValue ( clTree p_oTree,
clTreePopulation p_oPop,
float  fDiameterGrowth 
) [virtual]

Applies growth as described in the equation above.

Parameters:
p_oTree Tree for which to calculate growth.
p_oPop Tree population object, just in case it's needed.
fDiameterGrowth Amount of diameter growth for this tree, in cm.
Returns:
Amount, in m, by which to increase the tree's height.

Reimplemented from clGrowthBase.

void clRelativeGrowth::SetNameData ( char *  cNameString  )  [virtual]

Captures the behavior name passed from the parameter file.

This is useful since this class can produce a few different kinds of behaviors.

Parameters:
cNameString Behavior name from parameter file.

Reimplemented from clBehaviorBase.

void clRelativeGrowth::DoShellSetup ( xercesc::DOMDocument *  p_oDoc  )  [virtual]

Does setup.

Reads in values from the parameter file, and validates that all species/type combos use light (each must have "Light" registered).

Parameters:
p_oDoc DOM tree of parsed input file.
Exceptions:
modelErr if any species/type combo to which this behavior is applied does not have a light behavior.

Reimplemented from clGrowthBase.


Member Data Documentation

float* clRelativeGrowth::mp_fExp [protected]

Diameter or height exponent - array size is number of species.

Number of years per timestep - from sim manager.


The documentation for this class was generated from the following file:

Generated on Wed Oct 28 13:58:48 2009 for SORTIE Core C++ Documentation by  doxygen 1.5.6