This calculates NCI for a tree according to the default function. More...

#include <NCITermDefault.h>

Inheritance diagram for clNCITermDefault:

Public Member Functions
	clNCITermDefault ()
	Constructor. More...

	~clNCITermDefault ()
	Destructor. More...

ncivals	CalculateNCITerm (clTree p_oTree, clTreePopulation p_oPop, clPlot *p_oPlot, const float &fX, const float &fY, const int &iSpecies)
	Calculates NCI according to above equation. More...

void	DoSetup (clTreePopulation p_oPop, clBehaviorBase p_oNCI, xercesc::DOMElement *p_oElement)
	Does setup. More...

Public Member Functions inherited from clNCITermBase
	clNCITermBase ()
	Constructor. More...

int	GetNumberNCIs ()

virtual void	PreCalcs (clTreePopulation *p_oPop)
	Performs calculations like either clGrowthBase::PreGrowthCalcs or clMortalityBase::PreMortCalcs. More...

virtual	~clNCITermBase ()
	Destructor. More...

bool	DoesRequireTargetDiam ()

Protected Attributes
double **	mp_fLambda
	Lamba for NCI. More...

double *	mp_fMaxCrowdingRadius
	Maximum search radius, in meters, in which to look for crowding neighbors. More...

double *	mp_fAlpha
	Neighbor DBH effect. More...

double *	mp_fBeta
	Neighbor distance effect. More...

double *	mp_fMinimumNeighborDBH
	The minimum DBH, in cm, of neighbors to be included in NCI calculations. More...

double	m_fDbhDivisor
	The value to divide DBH by in NCI. More...

float	m_fMinSaplingHeight
	Minimum sapling height. More...

bool	m_bIncludeSnags
	Whether or not to include snags in NCI. More...

int	m_iNumTotalSpecies
	Number of total species. More...

Protected Attributes inherited from clNCITermBase
bool	bRequiresTargetDiam
	Whether or not this effect depends on a target diameter being available. More...

int	iNumNCIs
	Number of NCI values calculated and populated into ncivals. More...

Detailed Description

This calculates NCI for a tree according to the default function.

NCI_i is calculated as follows (simplifying the notation):

NCI_i = Σ λ_k((DBH_k/q)^α/distance^β) where:

we're summing over k = 0 to N neighbors greater than the minimum neighbor DBH
α is the neighbor DBH effect parameter
β is the neighbor distance effect parameter
q is the DBH divisor parameter
DBH_k is the DBH of the kth neighbor, in cm
γ is the size sensitivity to NCI parameter
λ_k is the NCI lambda parameter for the species of the kth neighbor
distance is distance from target to neighbor, in meters

NCI ignores neighbors with disturbance and harvest death codes. Natural deaths are NOT ignored, because it presumes that those deaths occurred in the current timestep and they should still be considered as live neighbors.

This returns 1 value for NCI.

Constructor & Destructor Documentation

◆ clNCITermDefault()

clNCITermDefault::clNCITermDefault ( )

Constructor.

◆ ~clNCITermDefault()

clNCITermDefault::~clNCITermDefault ( )

Destructor.

Member Function Documentation

◆ CalculateNCITerm()

ncivals clNCITermDefault::CalculateNCITerm	(	clTree *	p_oTree,
		clTreePopulation *	p_oPop,
		clPlot *	p_oPlot,
		const float &	fX,
		const float &	fY,
		const int &	iSpecies
	)

virtual

Calculates NCI according to above equation.

Parameters

p_oTree	Tree for which to calculate NCI.
p_oPop	Tree population.
p_oPlot	Plot object.
fX	X coordinate for which to calculate NCI.
fY	Y coordinate for which to calculate NCI.
iSpecies	Species for which to calculate NCI.

Implements clNCITermBase.

◆ DoSetup()

void clNCITermDefault::DoSetup	(	clTreePopulation *	p_oPop,
		clBehaviorBase *	p_oNCI,
		xercesc::DOMElement *	p_oElement
	)

virtual

Does setup.

Parameters

p_oPop	Tree population.
p_oNCI	NCI behavior object.
p_oElement	Root element of the behavior.

Exceptions

ModelException if the max radius of neighbor effects is < 0, or if DBH divisor is <= 0.

Implements clNCITermBase.

Member Data Documentation

◆ m_bIncludeSnags

bool clNCITermDefault::m_bIncludeSnags

protected

Whether or not to include snags in NCI.

◆ m_fDbhDivisor

double clNCITermDefault::m_fDbhDivisor

protected

The value to divide DBH by in NCI.

q in the NCI equation above. May be set to 1.

◆ m_fMinSaplingHeight

float clNCITermDefault::m_fMinSaplingHeight

protected

Minimum sapling height.

For doing neighbor searches.

◆ m_iNumTotalSpecies

int clNCITermDefault::m_iNumTotalSpecies

protected

Number of total species.

For the destructor.

◆ mp_fAlpha

double* clNCITermDefault::mp_fAlpha

protected

Neighbor DBH effect.

α variable in equation above. Array sized number of species.

◆ mp_fBeta

double* clNCITermDefault::mp_fBeta

protected

Neighbor distance effect.

β variable in equation above. Array sized number of species.

◆ mp_fLambda

double** clNCITermDefault::mp_fLambda

protected

Lamba for NCI.

Array sized number of total species by number of total species.

◆ mp_fMaxCrowdingRadius

double* clNCITermDefault::mp_fMaxCrowdingRadius

protected

Maximum search radius, in meters, in which to look for crowding neighbors.

Array sized number of species.

◆ mp_fMinimumNeighborDBH

double* clNCITermDefault::mp_fMinimumNeighborDBH

protected

The minimum DBH, in cm, of neighbors to be included in NCI calculations.

Array assumed to be sized total number of species.

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

NCITermDefault.h

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ clNCITermDefault()

◆ ~clNCITermDefault()

Member Function Documentation

◆ CalculateNCITerm()

◆ DoSetup()

Member Data Documentation

◆ m_bIncludeSnags

◆ m_fDbhDivisor

◆ m_fMinSaplingHeight

◆ m_iNumTotalSpecies

◆ mp_fAlpha

◆ mp_fBeta

◆ mp_fLambda

◆ mp_fMaxCrowdingRadius

◆ mp_fMinimumNeighborDBH