Goose Management Model ODdox  1.02
Goose_Greylag_FamilyGroup Class Reference

A class to describe the Greylag family group. More...

#include <GooseGreylag_All.h>

Public Member Functions

virtual void EndStep (void)
 The Goose_Greylag_FamilyGroup EndStep. More...
 
 Goose_Greylag_FamilyGroup (Landscape *p_L, Goose_Population_Manager *p_NPM, double a_weight, bool a_sex, int a_groupsize, APoint a_roost)
 Goose_Greylag_FamilyGroup constructor. More...
 
void Init (Goose_Population_Manager *p_NPM, double a_weight, bool a_sex, int a_groupsize, APoint a_roost)
 Intitialise object. More...
 
virtual void KillThis (void)
 The FamilyGroup KillThis must be overridden for families. More...
 
void ReInit (Landscape *p_L, Goose_Population_Manager *p_NPM, double a_weight, bool a_sex, int a_groupsize, APoint a_roost)
 ReInit for object pool. More...
 
virtual void Step (void)
 The Goose_Greylag_FamilyGroup Step. More...
 
virtual ~Goose_Greylag_FamilyGroup ()
 Goose_Greylag_FamilyGroup destructor. More...
 
- Public Member Functions inherited from Goose_Greylag_Base
 Goose_Greylag_Base (Landscape *p_L, Goose_Population_Manager *p_NPM, double a_weight, bool a_sex, APoint a_roost)
 Goose_Greylag_Base constructor. More...
 
void Init (Goose_Population_Manager *p_NPM, double a_weight, bool a_sex, APoint a_roost)
 Intitialise object. More...
 
void ReInit (Landscape *p_L, Goose_Population_Manager *p_NPM, double a_weight, bool a_sex, APoint a_roost)
 ReInit for object pool. More...
 
virtual ~Goose_Greylag_Base ()
 Goose_Greylag_Base destructor. More...
 
- Public Member Functions inherited from Goose_Base
void AddBodyCondition (double a_condition)
 Alters body conditon by addition of a double value. More...
 
double AdjustIntakeRateToSnowDepth (double a_intakerate)
 When there is snow, the intake rate is decreased by 10 % per cm of snow. More...
 
virtual void BeginStep (void)
 The BeginStep is the first 'part' of the timestep that an animal can behave in. It is called once per timestep (10 minutes). More...
 
void EvaluateForageToHopLoc (APoint a_HopLoc)
 Do a forage evaluation from current location to a_HopLoc. More...
 
void Explore ()
 Behavioural exploration of the area to find forage. More...
 
double GetBodyCondition ()
 Returns the current body condition. More...
 
double GetDailyEnergyBudget ()
 Returns the daily energy budget. More...
 
double GetDailyEnergyExpenditure ()
 Returns the daily energy expenditure. More...
 
double GetFlightCost ()
 Get the flight costs per m per g. More...
 
int GetFlightDistance ()
 Returns the total daily distance flown. More...
 
int GetFlightNumber ()
 Returns the total daily number of flights. More...
 
int GetForageLocIndex ()
 Gets for the forage location index. More...
 
int GetForagingTime (int a_EndForagingTime, double a_RoostLeaveTime)
 Returns the time spent foraging. More...
 
double GetGooseMinForageRate (GooseSpecies a_species)
 Returns the minimum forage rate for the species. More...
 
int GetGroupsize ()
 Returns the groupsize. More...
 
int GetMaxAppetiteHitTime ()
 Returns m_DailyMaxAppetiteHitTime. More...
 
double GetMaxForageRate (double a_grain, double a_maize, double a_grass, double a_interferenceComp, bool a_iscereal, TTypesOfVegetation a_veg, bool a_stubble, TTypesOfVegetation a_prevcrop)
 Returns the max forage rate of the three different types of forage The max rate is adjusted according to feeding time in the time budget, according to the interference competition value and to the current snow depth in the landscape. More...
 
double GetMaxIntakeRate (double a_grain, double a_maize, double a_grass)
 Returns the max intake rate of the three different types of intake. More...
 
TMaxIntakeSource GetMaxIntakeSource ()
 Supply the current max intake source. More...
 
APoint GetRoost ()
 Supply roost coords. More...
 
double GetRoostLeaveTime ()
 Returns the time when the goose leaves the roost. More...
 
bool GetSex ()
 Returns the sex. More...
 
GooseSpecies GetSpecies ()
 Returns the species. More...
 
double GetTotalWeight ()
 Returns the weight of the bird. More...
 
 Goose_Base (Landscape *p_L, Goose_Population_Manager *p_NPM, double a_weight, bool a_sex, APoint a_roost)
 Goose_Base constructor. More...
 
void Init (Goose_Population_Manager *p_NPM, double a_weight, bool a_sex, APoint a_roost)
 Intitialise object. More...
 
void On_Bang (int a_polyid)
 The goose is scared by a bang at location. More...
 
void On_Bang (int a_polyid, double a_scare)
 The goose is scared by a bang at location. More...
 
virtual void On_Emigrate ()
 Cause the bird to immediately transition to Emigrate. More...
 
void On_Migrate (TTypeOfLeaveReason a_leavereason)
 The goose is told to leave the simulation area (poss due to bad weather) More...
 
void On_MoveTo (int a_x, int a_y)
 The goose is moved to the location specified by a_x, a_y - caused by group decision. More...
 
void ReInit (Landscape *p_L, Goose_Population_Manager *p_NPM, double a_weight, bool a_sex, APoint a_roost)
 ReInit for object pool. More...
 
double ScaleForageToGroupsize (double a_forage)
 Scales forage to groupsize. More...
 
void Set_GooseFattoKJConversion (double a_cost)
 Set the fat to kJ conversion constant for all geese. More...
 
void Set_GooseFieldForageDist (double sp1, double sp2, double sp3)
 Set the max forage distance from a field for all geese. More...
 
void Set_GooseFollowingLikelyhood (int a_likelyhood, GooseSpeciesType a_speciestype)
 Set the followinglikelyhood. More...
 
void Set_GooseForageDist (double sp1, double sp2, double sp3)
 Set the max forage distance from roost for all geese. More...
 
void Set_GooseKJtoFatConversion (double a_cost)
 Set the kJ to fat conversion constant for all geese. More...
 
void Set_GooseLeavingRoost (bool a_leaving)
 Set the flag to indicate if we are coming from the roost. More...
 
void Set_GooseLeavingThreshold (double a_threshold)
 Set the body condition threshold for leaving for all geese. More...
 
void Set_GooseMaxAppetiteScaler (double a_cost)
 Set the goose appetite scale used to calculate max intake for all geese. More...
 
void Set_GooseMaxEnergyReserveProportion (double a_prop)
 Set the maximum energy reserve proportion allowed for all geese. More...
 
void Set_GooseMinForageOpenness (double a_cost)
 Set the min forage openess for all geese. More...
 
void Set_Indivmingooseforagerate (double a_cost)
 Set the mimimum tolerated forage rate for the individual goose. More...
 
void Set_mingooseforagerate (double a_cost, GooseSpecies a_species)
 Set the mimimum tolerated forage rate for all geese. More...
 
void SetBodyCondition (double a_condition, unsigned a_index)
 Sets the current body condition. More...
 
void SetFlightCost (double a_cost)
 Set the flight cost per m per g. More...
 
void SetSex (bool a_sex)
 Sets the sex. More...
 
void st_Dying (void)
 Behavioural state dying. More...
 
TTypeOfGoose_BaseState st_Forage ()
 Behavioural forage. More...
 
TTypeOfGoose_BaseState st_Roost ()
 Roosting until next forage or next morning. More...
 
virtual void StartDay (void)
 Do any 'housekeeping' associated with the start of day. More...
 
void SubtractBodyCondition (double a_condition)
 Alters body conditon by subtraction of a double value. More...
 
virtual ~Goose_Base ()
 Goose_Base destructor. More...
 

Additional Inherited Members

- Protected Member Functions inherited from Goose_Greylag_Base
virtual void ChangeRoost ()
 Find the closest roost. More...
 
virtual APoint ChooseHopLoc ()
 Pick a hop location point within a_dist meters - must be overridden by descendent classes. More...
 
TTypeOfGoose_BaseState st_ToRoost ()
 Return to roost and assess whether to forage again that day. More...
 
- Protected Member Functions inherited from Goose_Base
void FlyTo (APoint a_pt)
 The goose flys to the location specified by a_pt. More...
 
void FlyTo (int a_x, int a_y)
 The goose flys to the location specified by a_x, a_y. More...
 
TTypeOfGoose_BaseState st_ChooseForageLocation (void)
 Selects a forage location based on past memory, or initiates an exploration. More...
 
- Protected Attributes inherited from Goose_Base
TTypeOfGoose_BaseState CurrentGState
 Variable to record current behavioural state. More...
 
double m_BMR
 The daily BMR. More...
 
double m_BodyCondition [5]
 A variable describing current body condition over the past 5 days. More...
 
unsigned m_BodyConditionCounter
 A counter for the daily body condition. More...
 
double m_DailyMaxAppetite
 The daily max kJ possible to get as intake. More...
 
int m_DailyMaxAppetiteHitTime
 The time of day when m_DailyMaxAppetite was hit. More...
 
double m_DEB
 The daily energy budget excluding flying (kJ) More...
 
double m_energyReserve
 The bird's energy reserves in grams. More...
 
double m_energyToday
 The bird's daily energy account (kJ) More...
 
int m_FlightDistance
 Storage for the total distance flown per day. More...
 
int m_FlightNumber
 Counter for the number of flights per day. More...
 
int m_forageLocCount
 The number of forage locations visited today. More...
 
int m_groupsize
 The size of the group this bird represents. More...
 
double m_Indivmingooseforagerate
 The minimum tolerable forage rate in kJ/minute for the individual. More...
 
double m_LeaveRoostTime
 Controls the time when the goose will leave the roost. More...
 
bool m_LeavingRoost
 Flag to indicate that we are coming from the roost. Used to control code for "following". More...
 
TMaxIntakeSource m_MaxIntakeSource
 Holds information about the food source which gave max intake rate. More...
 
int m_myForageIndex
 Temporary storage for a forage location index - this is a speed optimisation. More...
 
GooseSpeciesType m_myGooseSpeciesType
 Holds the goose species type. More...
 
GooseMemoryMapm_MyMemory
 The Goose Memory. More...
 
int m_myMemPolyID
 Temporary storage for a memory location polygon id. More...
 
APoint m_MyRoost
 The current roost location. More...
 
GooseSpecies m_myspecies
 Holds goose species. More...
 
Goose_Population_Managerm_OurPopulationManager
 This is a time saving pointer to the correct population manager object. More...
 
bool m_sex
 Sex of bird, true = male false = female. More...
 
double m_TheBodyCondition
 A variable describing current body condition averaged over 5 days. More...
 
double m_weight
 The weight of the bird in gram excluding fat reserve. More...
 
double m_weightTotal
 The weight of the bird in g including fat reserve. More...
 
- Static Protected Attributes inherited from Goose_Base
static double m_flightcost = -1
 The cost of flight per g per m in kJ. More...
 
static int m_followinglikelyhood [(int) gst_foobar] = { -1, -1, -1 , -1, -1, -1 }
 An attribute used to determine the chance of following or exploring when foraging. More...
 
static double m_GooseFattoKJConversion = -1
 Conversion rate fat to kJ. More...
 
static double m_GooseFieldForageDist [gs_foobar] = { -1, -1, -1 }
 The maximum distance travelled from roost to forage sites for each species of goose (m) More...
 
static double m_GooseFieldForageDistX2 [gs_foobar] = { -1, -1, -1 }
 Double the maximum distance travelled from roost to forage sites for each species of goose (m) - this is a speed optimisation. More...
 
static double m_GooseForageDist [gs_foobar] = { -1, -1, -1 }
 The maximum distance travelled from roost to forage sites for each species of goose (m) More...
 
static double m_GooseForageDistX2 [gs_foobar] = { -1, -1, -1 }
 Double the maximum distance travelled from roost to forage sites for each species of goose (m) - this is a speed optimisation. More...
 
static double m_GooseKJtoFatConversion = -1
 Conversion rate kJ to fat. More...
 
static double m_GooseLeavingThreshold = -1
 The trigger for leaving as a 5 day average of body condition. More...
 
static double m_GooseMaxAppetiteScaler = -1
 Scaler to determine the max kJ possible to eat per day based on non-energy reserve weight. More...
 
static double m_GooseMaxEnergyReserveProportion = -1
 Max proportion of weight that can be energy reserve. More...
 
static double m_GooseMinForageOpenness = -1
 The minimum openness value a goose will tolerate for forage. More...
 
static double m_mingooseforagerate [gs_foobar] = { -1, -1, -1 }
 The minimum tolerable forage rate in kJ/minute for the species. More...
 
static double m_SnowDepth = 0.0
 The current snow depth. Held here for speed optimization. More...
 

Detailed Description

A class to describe the Greylag family group.

Definition at line 76 of file GooseGreylag_All.h.

Constructor & Destructor Documentation

◆ Goose_Greylag_FamilyGroup()

Goose_Greylag_FamilyGroup::Goose_Greylag_FamilyGroup ( Landscape p_L,
Goose_Population_Manager p_NPM,
double  a_weight,
bool  a_sex,
int  a_groupsize,
APoint  a_roost 
)

Goose_Greylag_FamilyGroup constructor.

Definition at line 149 of file GooseGreylag_All.cpp.

150  : Goose_Greylag_Base(p_L, p_NPM, a_weight, a_sex, a_roost)
151 {
152  Init(p_NPM, a_weight, a_sex, a_groupsize, a_roost);
153 }

References Init().

◆ ~Goose_Greylag_FamilyGroup()

Goose_Greylag_FamilyGroup::~Goose_Greylag_FamilyGroup ( )
virtual

Goose_Greylag_FamilyGroup destructor.

Definition at line 161 of file GooseGreylag_All.cpp.

162 {
163  ;
164 }

Member Function Documentation

◆ EndStep()

virtual void Goose_Greylag_FamilyGroup::EndStep ( void  )
inlinevirtual

The Goose_Greylag_FamilyGroup EndStep.

Reimplemented from Goose_Base.

Definition at line 90 of file GooseGreylag_All.h.

90 { ; }

◆ Init()

void Goose_Greylag_FamilyGroup::Init ( Goose_Population_Manager p_NPM,
double  a_weight,
bool  a_sex,
int  a_groupsize,
APoint  a_roost 
)

Intitialise object.

Here we deal with intialisation that is only for family greylags

Definition at line 140 of file GooseGreylag_All.cpp.

141 {
142  Goose_Greylag_Base::Init(p_NPM, a_weight, a_sex, a_roost);
146  m_groupsize = a_groupsize;
148 }

References gst_GreylagFamilyGroup, Goose_Greylag_Base::Init(), Goose_Base::m_groupsize, and Goose_Base::m_myGooseSpeciesType.

Referenced by Goose_Greylag_FamilyGroup(), and ReInit().

◆ KillThis()

void Goose_Greylag_FamilyGroup::KillThis ( void  )
virtual

The FamilyGroup KillThis must be overridden for families.

Kill this for single animal agents is straightforward, but for families it is a single bird that dies. The bird is randomly picked from the family group, and if the family group is empty the group 'dies' In all cases we need to remove the bird from the forage area if any. The birds do not fly away at this point (if there are any left), this happens when the get the On_Bang message.

Reimplemented from Goose_Base.

Definition at line 205 of file GooseGreylag_All.cpp.

206 {
213  if (m_myForageIndex != -1)
214  {
216  }
217  if (--m_groupsize < 1)
218  {
219  delete m_MyMemory; // this is reinitisalised in the object pool.
220  TAnimal::KillThis();
221  }
222 
223 }

References Goose_Base::m_groupsize, Goose_Base::m_myForageIndex, Goose_Base::m_myGooseSpeciesType, Goose_Base::m_MyMemory, Goose_Base::m_OurPopulationManager, and Goose_Population_Manager::RemoveGeeseFromForageLocation().

◆ ReInit()

void Goose_Greylag_FamilyGroup::ReInit ( Landscape p_L,
Goose_Population_Manager p_NPM,
double  a_weight,
bool  a_sex,
int  a_groupsize,
APoint  a_roost 
)

ReInit for object pool.

Definition at line 154 of file GooseGreylag_All.cpp.

155 {
156  Goose_Greylag_Base::ReInit(p_L, p_NPM, a_weight, a_sex, a_roost);
157  Init(p_NPM, a_weight, a_sex, a_groupsize, a_roost);
158 }

References Init(), and Goose_Greylag_Base::ReInit().

Referenced by Goose_Population_Manager::CreateObjects().

◆ Step()

void Goose_Greylag_FamilyGroup::Step ( void  )
virtual

The Goose_Greylag_FamilyGroup Step.

In state ChooseForageLocation, if the bird is the group leader then he will determine the forage location. Otherwise does nothing, all thinking is done by the group leader.

In state Forage the bird must assess competitive status, and determine forage intake. If acceptable feed, otherwise move

Reimplemented from Goose_Base.

Definition at line 167 of file GooseGreylag_All.cpp.

168 {
169  if (m_StepDone || m_CurrentStateNo == -1) return;
170  switch (CurrentGState)
171  {
172  case togs_InitialState: // Initial state always starts by setting the behaviour to togs_Roost
174  break;
177  m_StepDone = true;
178  break;
179  case togs_Forage:
181  m_StepDone = true;
182  break;
183  case togs_ToRoost:
185  m_StepDone = true;
186  break;
187  case togs_Roost:
189  m_StepDone = true;
190  break;
191  case togs_Emigrate:
193  break;
194  case togs_Die:
195  st_Dying(); // No return value - no behaviour after this
196  m_StepDone = true;
197  break;
198  default:
199  m_OurLandscape->Warn("Goose_Greylag_FamilyGroup::Step()","unknown state - default");
200  exit(1);
201  }
202 }

References Goose_Base::CurrentGState, Goose_Base::On_Migrate(), Goose_Base::st_ChooseForageLocation(), Goose_Base::st_Dying(), Goose_Base::st_Forage(), Goose_Base::st_Roost(), Goose_Greylag_Base::st_ToRoost(), togs_ChooseForageLocation, togs_Die, togs_Emigrate, togs_Forage, togs_InitialState, togs_Roost, togs_ToRoost, and tolr_migration.


The documentation for this class was generated from the following files:
togs_Roost
Definition: Goose_Base.h:80
Goose_Base::st_Roost
TTypeOfGoose_BaseState st_Roost()
Roosting until next forage or next morning.
Definition: Goose_Base.cpp:550
Goose_Base::m_myForageIndex
int m_myForageIndex
Temporary storage for a forage location index - this is a speed optimisation.
Definition: Goose_Base.h:291
Goose_Base::m_groupsize
int m_groupsize
The size of the group this bird represents.
Definition: Goose_Base.h:171
Goose_Greylag_Base::Goose_Greylag_Base
Goose_Greylag_Base(Landscape *p_L, Goose_Population_Manager *p_NPM, double a_weight, bool a_sex, APoint a_roost)
Goose_Greylag_Base constructor.
Definition: GooseGreylag_All.cpp:68
togs_Die
Definition: Goose_Base.h:81
togs_ToRoost
Definition: Goose_Base.h:79
Goose_Base::st_ChooseForageLocation
TTypeOfGoose_BaseState st_ChooseForageLocation(void)
Selects a forage location based on past memory, or initiates an exploration.
Definition: Goose_Base.cpp:258
togs_ChooseForageLocation
Definition: Goose_Base.h:77
Goose_Greylag_Base::Init
void Init(Goose_Population_Manager *p_NPM, double a_weight, bool a_sex, APoint a_roost)
Intitialise object.
Definition: GooseGreylag_All.cpp:77
Goose_Base::CurrentGState
TTypeOfGoose_BaseState CurrentGState
Variable to record current behavioural state.
Definition: Goose_Base.h:147
Goose_Greylag_Base::ReInit
void ReInit(Landscape *p_L, Goose_Population_Manager *p_NPM, double a_weight, bool a_sex, APoint a_roost)
ReInit for object pool.
Definition: GooseGreylag_All.cpp:72
Goose_Base::st_Dying
void st_Dying(void)
Behavioural state dying.
Definition: Goose_Base.cpp:251
Goose_Base::m_MyMemory
GooseMemoryMap * m_MyMemory
The Goose Memory.
Definition: Goose_Base.h:299
Goose_Base::On_Migrate
void On_Migrate(TTypeOfLeaveReason a_leavereason)
The goose is told to leave the simulation area (poss due to bad weather)
Definition: Goose_Base.cpp:722
tolr_migration
Definition: Goose_Base.h:104
togs_InitialState
Definition: Goose_Base.h:76
Goose_Greylag_Base::st_ToRoost
TTypeOfGoose_BaseState st_ToRoost()
Return to roost and assess whether to forage again that day.
Definition: GooseGreylag_All.cpp:98
Goose_Greylag_FamilyGroup::Init
void Init(Goose_Population_Manager *p_NPM, double a_weight, bool a_sex, int a_groupsize, APoint a_roost)
Intitialise object.
Definition: GooseGreylag_All.cpp:140
Goose_Base::st_Forage
TTypeOfGoose_BaseState st_Forage()
Behavioural forage.
Definition: Goose_Base.cpp:433
Goose_Base::m_myGooseSpeciesType
GooseSpeciesType m_myGooseSpeciesType
Holds the goose species type.
Definition: Goose_Base.h:163
Goose_Base::m_OurPopulationManager
Goose_Population_Manager * m_OurPopulationManager
This is a time saving pointer to the correct population manager object.
Definition: Goose_Base.h:151
Goose_Population_Manager::RemoveGeeseFromForageLocation
void RemoveGeeseFromForageLocation(GooseSpeciesType a_type, int a_index, int a_number)
Removes a goose or geese to the forage location - requires an index.
Definition: Goose_Population_Manager.cpp:1812
togs_Emigrate
Definition: Goose_Base.h:82
gst_GreylagFamilyGroup
Definition: Goose_Base.h:64
togs_Forage
Definition: Goose_Base.h:78