GetMCPAreas
This application will find the areas of the minimal convex polygon, or convex
hull, surrounding the non-zero patches at each time-step of
the simulation being processed.
Arguments
There are three mandatory arguments to this application. Optional
arguments are listed between brackers below:
MPFile Start_Year Delimiter [burn-in smoothing_method (sma | exp)
window_size]
MPFile is
the metapop file to process
Start_Year
is the first year of the simulation. Each subsequent time-step is
assumed to be one year after this
Delimiter is
the character used to delimit the fields in the outputs
burn-in is
the number of years to ignore at the start of the simulation, if a
"burn-in" period is being used
smoothing_method
is the method to use to smooth the time-series output by the
application. Options are sma
for simple
moving average and exp
for exponential
smoothing
window_size
is the number of years to include in the smoothing method. Although
exponential smoothing doesn't strictly use a smoothing window, the
application does use the window size to calculate the weighting factor
Outputs
The application will output a header specifying the number of patches
loaded, followed by a time-series of years and areas, with each year
and area on a single line, separated by the delimiter character
specified.
Examples
The following command specifies a start year of 2000 and a comma delimited output:
getmcpareas example.mp 2000 ,
This will yield the following output:
2000,85.3124
2001,123.471
2002,85.3124
2003,85.3124
2004,103.606
2005,103.606
2006,112.833
2007,103.684
2008,117.739
2009,117.739
2010,98.2659
2011,115.199
2012,140.124
2013,173.557
2014,120.513
2015,131.366
2016,136.827
2017,88.7664
2018,136.827
2019,142.483
Applying a three-year burn-in period is done with the following command:
getmcpareas example.mp 2000 , 3
Yields the following outputs:
2002,85.3124
2003,85.3124
2004,103.606
2005,103.606
2006,112.833
2007,103.684
2008,117.739
2009,117.739
2010,98.2659
2011,115.199
2012,140.124
2013,173.557
2014,120.513
2015,131.366
2016,136.827
2017,88.7664
2018,136.827
2019,142.483
Running the application with no burn-in, but simple moving average smoothing with a three-year window is done with:
getmcpareas example.mp 2000 , 0 sma 3
and produces the following output:
1,98.0318
2,98.0318
3,91.4103
4,97.5081
5,106.681
6,106.708
7,111.419
8,113.054
9,111.248
10,110.402
11,117.863
12,142.96
13,144.731
14,141.812
15,129.569
16,118.987
17,120.807
18,122.692
Finally, using exponential smoothing via the following command:
getmcpareas example.mp 2000 , 0 exp 3
produces the following output:
2000,85.3124
2001,104.392
2002,94.852
2003,90.0822
2004,96.8441
2005,100.225
2006,106.529
2007,105.106
2008,111.423
2009,114.581
2010,106.423
2011,110.811
2012,125.468
2013,149.512
2014,135.013
2015,133.19
2016,135.008
2017,111.887
2018,124.357
2019,133.42
Back to RAMAS Metapop Tools main page.
Maintained by Dr Michael J. Watts