The base class for predators encompsassing all their general behaviours. More...

#include <Predators.h>

Public Member Functions
	TPredator (Vole_Population_Manager ThePrey, int p_x, int p_y, Landscape p_L, TPredator_Population_Manager *p_PPM)

	~TPredator ()

bool	OverlapMyTerritory (unsigned x, unsigned y)

virtual void	st_Dispersal ()

virtual void	st_Movement ()

virtual int	st_Hunting ()

virtual void	BeginStep (void)
	BeingStep behaviour - must be implemented in descendent classes. More...

virtual void	Step (void)
	Step behaviour - must be implemented in descendent classes. More...

virtual void	EndStep (void)
	EndStep behaviour - must be implemented in descendent classes. More...

unsigned	SupplySpeciesID ()

int	SupplyKill ()

bool	SupplyTerr ()

int	SupplyKillEff ()

int	SupplyHomeRange ()

Public Member Functions inherited from TAnimal
unsigned	SupplyFarmOwnerRef ()

AnimalPosition	SupplyPosition ()

APoint	SupplyPoint ()

int	SupplyPolygonRef ()

int	Supply_m_Location_x ()

int	Supply_m_Location_y ()

virtual void	KillThis ()

virtual void	CopyMyself ()

void	SetX (int a_x)

void	SetY (int a_y)

	TAnimal (int x, int y, Landscape *L)

virtual void	ReinitialiseObject (int x, int y, Landscape *L)
	Used to re-use an object - must be implemented in descendent classes. More...

virtual int	WhatState ()

virtual void	Dying ()

void	CheckManagement (void)

void	CheckManagementXY (int x, int y)

virtual bool	OnFarmEvent (FarmToDo)

Public Member Functions inherited from TALMaSSObject
int	GetCurrentStateNo ()
	Returns the current state number. More...

void	SetCurrentStateNo (int a_num)
	Sets the current state number. More...

bool	GetStepDone ()
	Returns the step done indicator flag. More...

void	SetStepDone (bool a_bool)
	Sets the step done indicator flag. More...

virtual void	ReinitialiseObject ()
	Used to re-use an object - must be implemented in descendent classes. More...

	TALMaSSObject ()
	The constructor for TALMaSSObject. More...

virtual	~TALMaSSObject ()
	The destructor for TALMaSSObject. More...

void	OnArrayBoundsError ()
	Used for debugging only, tests basic object properties. More...

Protected Attributes
TTypeOfPredatorState	CurrentPState

unsigned	SpeciesID

unsigned	m_DispersalMax

unsigned	m_SearchArea

int	m_kills_this_season

int	PreyResponse1

int	PreyResponse2

int	m_Search_x

int	m_Search_y

int	SimW

int	SimH

unsigned	m_FailureCount

unsigned	m_NoFailuresBeforeDispersal

unsigned	m_HomeRange

bool	m_HaveTerritory

int	m_KillEfficiency

Vole_Population_Manager *	m_Prey

TPredator_Population_Manager *	m_OurPopulationManager

vector< Vole_Base * > *	CurrentPrey

Protected Attributes inherited from TAnimal
int	m_Location_x

int	m_Location_y

Landscape *	m_OurLandscape

Protected Attributes inherited from TALMaSSObject
int	m_CurrentStateNo
	The basic state number for all objects - '-1' indicates death. More...

bool	m_StepDone
	Indicates whether the iterative step code is done for this timestep. More...

Additional Inherited Members
Protected Member Functions inherited from TAnimal
void	CorrectWrapRound ()
	Corrects wrap around co-ordinate problems. More...

Detailed Description

The base class for predators encompsassing all their general behaviours.

Defines simple predators that are really nothing more than moving mortality probabilities of different sizes and strengths. Breeding is once a year if enough prey are eaten, and death occurs if a starvation criteria is reached. The last individual cannot die so the population can never go extinct. If predators do not eat for a definable number of hunts then they may disperse, otherwise they move only locally. Different types of predators can be defined in the same simulation by defining the Weasel and Owl classes using configuration variables to create e.g. specialist or generalist predators, with different movement patterns, hunting efficiency and numerical responses.

Definition at line 87 of file Predators.h.

Constructor & Destructor Documentation

◆ TPredator()

TPredator::TPredator	(	Vole_Population_Manager *	ThePrey,
		int	p_x,
		int	p_y,
		Landscape *	p_L,
		TPredator_Population_Manager *	p_PPM
	)

Tpredator constructor

Definition at line 696 of file Predators.cpp.

                                                           : TAnimal(p_x,p_y,p_L)
 {
     CurrentPState=tops_InitialState;
     m_KillEfficiency=0;
     m_kills_this_season=0;
     m_FailureCount=0;
     m_NoFailuresBeforeDispersal=5; // Default
     m_OurPopulationManager=p_PPM;
     m_Prey = ThePrey;
     m_Search_x=m_Location_x;
     m_Search_y=m_Location_y;
     m_HomeRange=0;
     m_HaveTerritory=false;
     m_SearchArea=0;
     m_DispersalMax=0;
     SimH=m_OurLandscape->SupplySimAreaHeight();
     SimW=m_OurLandscape->SupplySimAreaWidth();
     PreyResponse1=0;
     PreyResponse2=0;
 }

References CurrentPState, m_DispersalMax, m_FailureCount, m_HaveTerritory, m_HomeRange, m_KillEfficiency, m_kills_this_season, TAnimal::m_Location_x, TAnimal::m_Location_y, m_NoFailuresBeforeDispersal, TAnimal::m_OurLandscape, m_OurPopulationManager, m_Prey, m_Search_x, m_Search_y, m_SearchArea, PreyResponse1, PreyResponse2, SimH, SimW, Landscape::SupplySimAreaHeight(), Landscape::SupplySimAreaWidth(), and tops_InitialState.

◆ ~TPredator()

TPredator::~TPredator ( )

Definition at line 719 of file Predators.cpp.

 {
  
 }

Member Function Documentation

◆ BeginStep()

virtual void TPredator::BeginStep ( void )

inlinevirtual

BeingStep behaviour - must be implemented in descendent classes.

Reimplemented from TAnimal.

Reimplemented in Owl, and Weasel.

Definition at line 130 of file Predators.h.

130 {}

◆ EndStep()

virtual void TPredator::EndStep ( void )

inlinevirtual

EndStep behaviour - must be implemented in descendent classes.

Reimplemented from TAnimal.

Reimplemented in Owl, and Weasel.

Definition at line 132 of file Predators.h.

132 {}

◆ OverlapMyTerritory()

bool TPredator::OverlapMyTerritory	(	unsigned	x,
		unsigned	y
	)

Definition at line 770 of file Predators.cpp.

 {
    // ensure we can't go negative
    x+=SimW;
    y+=SimH;
    unsigned mx = m_Location_x+SimW;
    unsigned my = m_Location_y+SimH;
    // most likely that it is not in so test for false
    if (x<mx-m_HomeRange) return false;
     else if (x>=mx+m_HomeRange) return false;
       else if (y<my-m_HomeRange) return false;
         else if (y>=my+m_HomeRange) return false;
          else return true;
 }

References m_HomeRange, TAnimal::m_Location_x, TAnimal::m_Location_y, SimH, and SimW.

Referenced by TPredator_Population_Manager::InOtherTerritory().

◆ st_Dispersal()

void TPredator::st_Dispersal ( )

virtual

Moves the home range to an area where it does not overlap with a conspecific

Definition at line 787 of file Predators.cpp.

 {
  
   bool found=false;
   unsigned Count=0;
   while ((!found)&&(Count<100))
   {
     // Simple random walk
     Count++;
     m_Location_x=((m_Location_x+(random(2*m_DispersalMax)-m_DispersalMax)))%SimW;
     m_Location_y=((m_Location_y+(random(2*m_DispersalMax)-m_DispersalMax)))%SimH;
     if (!m_OurPopulationManager->InOtherTerritory(SpeciesID,m_Location_x,
                                                                  m_Location_y,this))
     {
       m_HaveTerritory=true;
       found=true;
     }
   }
 }

References TPredator_Population_Manager::InOtherTerritory(), m_DispersalMax, m_HaveTerritory, TAnimal::m_Location_x, TAnimal::m_Location_y, m_OurPopulationManager, SimH, SimW, and SpeciesID.

Referenced by Weasel::Step(), and Owl::Step().

◆ st_Hunting()

int TPredator::st_Hunting ( )

virtual

Definition at line 726 of file Predators.cpp.

 {
    unsigned kills=0;
    // count days since last kill
    // Takes the Search_x, Search_y, SearchArea. Applies KillEfficiency to
    // all voles defined by this square
    CurrentPrey=m_Prey->SupplyVoleList(m_Search_x,m_Search_y,m_SearchArea);
    //int s=CurrentPrey->size();  // **CJT** to help with debug
    for (unsigned i=0; i<CurrentPrey->size(); i++)
    {
      if (random(1000)<m_KillEfficiency)
      {
       (*CurrentPrey)[i]->OnKilled();
       kills++;
      }
    }
    // Must tidy up here because m_Prey cannot know when to do it
    CurrentPrey->clear();
    delete CurrentPrey;
    // record the kills
    m_kills_this_season+=kills;
    return kills;
 }

References CurrentPrey, m_KillEfficiency, m_kills_this_season, m_Prey, m_Search_x, m_Search_y, m_SearchArea, and Vole_Population_Manager::SupplyVoleList().

Referenced by Weasel::Step(), and Owl::Step().

◆ st_Movement()

void TPredator::st_Movement ( )

virtual

Definition at line 753 of file Predators.cpp.

 {
    // Can relocate search_x & search_y to be up somewhere in the homerange
    // but must have all the square in the HomeRange
    // 1. Drift a bit
    m_Location_x+=random(3)-1;
    m_Location_y+=random(3)-1;
    m_Location_x=(SimW+m_Location_x)%SimW;
    m_Location_y=(SimH+m_Location_y)%SimH;
    // 2. determine search area
    int max_dist=m_HomeRange-m_SearchArea;
    m_Search_x=(m_Location_x+random(max_dist))%SimW;
    m_Search_y=(m_Location_y+random(max_dist))%SimH;
 }