Non-spatial disperse - Version 1.0. More...

#include <NonSpatialDisperse.h>

Inheritance diagram for clNonSpatialDispersal:

Public Member Functions
	clNonSpatialDispersal (clSimManager *p_oSimManager)
	Constructor. More...

	~clNonSpatialDispersal ()
	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...

float	ComputeBasalArea (clTreePopulation *p_oPop, short int iSpecies)
	Computes the total basal area of all trees over reproductive age of a given species. 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_fDbhForReproduction
	Array of species with each one's dbh for reproduction. More...

double *	mp_fSlopeOfLambda
	Slope of the lambda function - sized number of species. More...

double *	mp_fInterceptOfLambda
	Intercept of the lambda function - sized number of species. More...

float	m_fAreaOfPlotInHa
	Area of plot in hectares, for scaling basal area. 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...

Detailed Description

Non-spatial disperse - Version 1.0.

This class performs non-spatial dispersal. There are two kinds. The first is non-density dependent, or bath, dispersal. This kind of dispersal represents a constant seed rain which does not depend on the presence of parent trees in the plot. The other kind is density-dependent dispersal. The number of seeds produced depends on the amount of basal area of reproductively mature trees of that species in the plot.

The mean number of seeds per square meter per year is calculated as lambda = BA*m + b, where m is the slope of lambda, b is the intercept of lambda, and BA is the amount of basal area in square meters per hectare. Lambda is multiplied by number of square meters per seed grid cell and number of years per timestep to arrive at the expected number of seeds per grid cell.

The slope of lambda controls density-dependent dispersal. Setting it equal to zero turns off density-dependent dispersal. The intercept of lambda controls non-density dependent dispersal, and same thing goes there.

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 "NonSpatialDisperse".

Author: Lora E. Murphy

Edit history:
--------------—
October 20, 2011 - Wiped the slate clean for SORTIE 7.0 (LEM)

Constructor & Destructor Documentation

◆ clNonSpatialDispersal()

clNonSpatialDispersal::clNonSpatialDispersal ( clSimManager * p_oSimManager )

Constructor.

Parameters

p_oSimManager Sim Manager object.

◆ ~clNonSpatialDispersal()

clNonSpatialDispersal::~clNonSpatialDispersal ( )

Destructor.

Member Function Documentation

◆ AddSeeds()

void clNonSpatialDispersal::AddSeeds ( )

protectedvirtual

Does dispersal.

For each species for which the slope of lambda is not zero, ComputeBasalArea() is called. Lambda is calculated and scaled to the appropriate grid cell size and number of years. The resulting number of seedlings is assigned to the grid cell.

Implements clDisperseBase.

◆ ComputeBasalArea()

float clNonSpatialDispersal::ComputeBasalArea	(	clTreePopulation *	p_oPop,
		short int	iSpecies
	)

protected

Computes the total basal area of all trees over reproductive age of a given species.

Parameters

p_oPop	Pointer to tree population object.
iSpecies	Species for which to calculate basal area

Returns: Basal area in square meters per hectare.

◆ DoShellSetup()

void clNonSpatialDispersal::DoShellSetup ( xercesc::DOMDocument * p_oDoc )

protectedvirtual

Reads in parameter file values.

Parameters

p_oDoc DOM tree of parsed parameter file.

Implements clDisperseBase.

Member Data Documentation

◆ m_fAreaOfPlotInHa

float clNonSpatialDispersal::m_fAreaOfPlotInHa

protected

Area of plot in hectares, for scaling basal area.

◆ mp_fDbhForReproduction

double* clNonSpatialDispersal::mp_fDbhForReproduction

protected

Array of species with each one's dbh for reproduction.

◆ mp_fInterceptOfLambda

double* clNonSpatialDispersal::mp_fInterceptOfLambda

protected

Intercept of the lambda function - sized number of species.

◆ mp_fSlopeOfLambda

double* clNonSpatialDispersal::mp_fSlopeOfLambda

protected

Slope of the lambda function - sized number of species.

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

NonSpatialDisperse.h

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ clNonSpatialDispersal()

◆ ~clNonSpatialDispersal()

Member Function Documentation

◆ AddSeeds()

◆ ComputeBasalArea()

◆ DoShellSetup()

Member Data Documentation

◆ m_fAreaOfPlotInHa

◆ mp_fDbhForReproduction

◆ mp_fInterceptOfLambda

◆ mp_fSlopeOfLambda