SORTIE Core C++ Documentation
|
Conspecific BA dependent neighborhood disperse - Version 1.0. More...
#include <ConspecificBANeighborhoodDisperse.h>
Public Member Functions | |
clConspecificBANeighborhoodDisperse (clSimManager *p_oSimManager) | |
Constructor. More... | |
~clConspecificBANeighborhoodDisperse () | |
Destructor. More... | |
Public Member Functions inherited from clDisperseBase | |
clDisperseBase (clSimManager *p_oSimManager) | |
Constructor. More... | |
virtual | ~clDisperseBase () |
Destroys common objects. More... | |
void | Action () |
Performs all disperse calculations. More... | |
void | TimestepCleanup () |
Resets all values in the seed grid to 0 and sets the static m_bUpdatedGapStatus to false if this is a hooked object. More... | |
Public Member Functions inherited from clBehaviorBase | |
virtual float | GetBehaviorVersion () |
Gets the behavior version number. More... | |
clBehaviorBase (clSimManager *p_oSimManager) | |
Constructor. More... | |
virtual | ~clBehaviorBase () |
Destructor. More... | |
virtual short int | ValidateVersionNumber (float fTestVersion) |
Makes sure that the version number of a file passed is between the minimum and current version numbers. More... | |
virtual void | RegisterTreeDataMembers () |
Registers tree data members. More... | |
virtual void | SetSpeciesTypeCombos (short int iNumCombos, stcSpeciesTypeCombo *p_whatCombos) |
Sets the species/type combos for a behavior. More... | |
virtual void | SetNameData (std::string sNameString) |
Sets the string for the parameter file behavior. More... | |
virtual short int | GetNewTreeInts () |
Gets the number of new tree integer data members this behavior wants to register. More... | |
virtual short int | GetNewTreeFloats () |
Gets the number of new tree float data members this behavior wants to register. More... | |
virtual short int | GetNewTreeChars () |
Gets the number of new tree character data members this behavior wants to register. More... | |
virtual short int | GetNewTreeBools () |
Gets the number of new tree bool data members this behavior wants to register. More... | |
virtual short int | GetNumSpeciesTypeCombos () |
Gets the number of species/type combos to which this behavior applies. More... | |
virtual short int | GetNumBehaviorSpecies () |
Gets the number of unique tree species to which this behavior applies. More... | |
struct stcSpeciesTypeCombo | GetSpeciesTypeCombo (short int iIndex) |
Gets one of this behavior's type/species combos. More... | |
virtual short int | GetBehaviorSpecies (short int iIndex) |
Gets one of the behavior's species. More... | |
short int | GetBehaviorListNumber () |
Gets the behavior list number for this behavior, which differentiates between multiple copies of the behavior in the behavior list. More... | |
void | SetBehaviorListNumber (short int iNumber) |
Sets the behavior list number for this behavior, which differentiates between multiple copies of the behavior in the behavior list. More... | |
std::string | FormatSpeciesTypeQueryString () |
Formats the string for species/types query. More... | |
virtual DOMElement * | GetParentParametersElement (xercesc::DOMDocument *p_oDoc) |
This will get the correct set of parameters for this behavior based on the behavior list position number. More... | |
Public Member Functions inherited from clWorkerBase | |
clWorkerBase (clSimManager *p_oSimManager) | |
Constructor. More... | |
virtual | ~clWorkerBase () |
Destructor. More... | |
std::string | GetName () |
Gets the object's namestring. More... | |
clSimManager * | GetSimManager () |
void | DoObjectSetup (xercesc::DOMDocument *p_oDoc, fileType iFileType) |
Triggers the setup process. More... | |
virtual void | EndOfRunCleanup () |
Performs any necessary cleanup operations at the end of a run. More... | |
Protected Member Functions | |
void | DoShellSetup (xercesc::DOMDocument *p_oDoc) |
Reads in parameter file values. More... | |
void | AddSeeds () |
Does dispersal. More... | |
Protected Member Functions inherited from clDisperseBase | |
void | GetData (xercesc::DOMDocument *p_oDoc) |
Triggers all disperse setup if an object is hooked. More... | |
void | SetUpBase () |
Does disperse base setup. More... | |
Protected Member Functions inherited from clWorkerBase | |
void | AssembleFileCode (int iFileType, int iFileVersion, char *cCode) |
Creates the proper identifying filecode for an XML file. More... | |
Protected Attributes | |
double * | mp_fA |
A parameter - sized number of species. More... | |
double * | mp_fB |
B parameter - sized number of species. More... | |
double | m_fRadius |
Neighborhood search radius. More... | |
float | m_fMinSaplingHeight |
Minimum sapling height. More... | |
Protected Attributes inherited from clDisperseBase | |
bool | m_bHooked |
Protected Attributes inherited from clBehaviorBase | |
short int | m_iNumSpeciesTypeCombos |
How many type/species combos a behavior will act on. More... | |
short int | m_iNumBehaviorSpecies |
How many distinct species are in the combo list - important for filling species-specific values from parameter file. More... | |
short int * | mp_iWhatSpecies |
List of distinct species - for filling species-specific values from parameter file. More... | |
stcSpeciesTypeCombo * | mp_whatSpeciesTypeCombos |
Array of species/type combos that the behavior will act on. More... | |
short int | m_iNewTreeInts |
The number of new tree integer data members this behavior wants to add. More... | |
short int | m_iNewTreeFloats |
The number of new tree float data members this behavior wants to add. More... | |
short int | m_iNewTreeChars |
The number of new tree character data members this behavior wants to add. More... | |
short int | m_iNewTreeBools |
The number of new tree boolean data members this behavior wants to add. More... | |
short int | m_iBehaviorListNumber |
The number of this behavior in the behavior list, to differentiate between possible multiple copies of this behavior. More... | |
float | m_fVersionNumber |
Version number - this will be rounded to 2 digits after the decimal place. More... | |
std::string | m_sXMLRoot |
XML root that encloses the parameters for this behavior. More... | |
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. More... | |
Protected Attributes inherited from clWorkerBase | |
std::string | m_sNameString |
If a behavior has registered a command line command with the sim manager, this allows it to be called. More... | |
clSimManager * | mp_oSimManager |
Pointer to the simulation manager object. More... | |
int * | mp_iAllowedFileTypes |
List of the input file types this object can handle. More... | |
int | m_iNumAllowedTypes |
Number of input file types this object can handle. More... | |
Additional Inherited Members | |
Protected Types inherited from clDisperseBase | |
enum | function { weibull, lognormal } |
What PDF is used by a species. More... | |
enum | cover { gap, canopy } |
Cover status. More... | |
Static Protected Attributes inherited from clDisperseBase | |
static clDisperseOrg * | mp_oDisperseOrg |
clDisperseOrg object - this pointer is held in common by all shells More... | |
static clGrid * | mp_oSeedGrid |
Seed grid. More... | |
static short int * | mp_iNumSeedsCode |
Data member codes for "dispersed seeds" grid for "seeds_x" data member. More... | |
static short int | m_iGapCountCode |
Data member code - for counting trees for gap status. More... | |
static short int | m_iIsGapCode |
Data member code for substrate grid for gap status. More... | |
static short int | m_iTotalSpecies |
Total number of species. More... | |
static bool | m_bUpdatedGapStatus |
A flag indicating whether or not the gap status of the seed grid has been updated this timestep. More... | |
static bool | m_bIsStochastic |
Whether dispersal is stochastic (true) or deterministic (false). More... | |
Conspecific BA dependent neighborhood disperse - Version 1.0.
This class disperses seeds. The number of seeds is a function of the basal area of conspecific adults.
The number of seeds per square meter per year is calculated as:
where a and b are parameters, and BAC is the basal area of conspecific adults within a specified radius, in square meters.
The number of seeds per square meter is multiplied by number of square meters per seed grid cell and number of years per timestep to arrive at the number of seeds per grid cell.
This behavior is not connected to any specific species-type combo, but is connected to specific species. There should be applyTo tags for this behavior and a unique list of species will be compiled for those tags with the type being ignored.
This behavior's namestring and parameter file call string are both "ConspecificBANeighborhoodDisperse".
Copyright 2013 Charles D. Canham.
Edit history:
--------------—
November 7, 2013 - Created (LEM)
clConspecificBANeighborhoodDisperse::clConspecificBANeighborhoodDisperse | ( | clSimManager * | p_oSimManager | ) |
Constructor.
p_oSimManager | Sim Manager object. |
clConspecificBANeighborhoodDisperse::~clConspecificBANeighborhoodDisperse | ( | ) |
Destructor.
|
protectedvirtual |
Does dispersal.
For each grid cell, the neighborhood basal area of each species is calculated. The number of seeds per square meter is calculated and scaled to the appropriate grid cell size and number of years. The resulting number of seeds is assigned to the grid cell.
Implements clDisperseBase.
|
protectedvirtual |
Reads in parameter file values.
p_oDoc | DOM tree of parsed parameter file. |
Implements clDisperseBase.
|
protected |
Minimum sapling height.
For doing neighbor searches.
|
protected |
Neighborhood search radius.
|
protected |
A parameter - sized number of species.
|
protected |
B parameter - sized number of species.