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.


Tweet
Maintained by Michael J. Watts
Last modified Friday, 25-May-2012 21:06:10 AEST