meta: Extract Metapop population metadata

In johnbaums/mptools: RAMAS Metapop Tools

Description

Extract population details from RAMAS Metapop .mp files.

Usage

meta(mp)

Arguments

mp	A character string containing the path to a RAMAS Metapop .mp file containing simulation results. Metapop .mp files are plain text files that store settings describing RAMAS metapopulation models, and the results of simulating population dynamics according to those models.

Value

A data.frame containing one row per population, with columns:

popName	The name of the population.
xMetapop, yMetapop	The spatial coordinates of the population centroid, in RAMAS's coordinate system (see mp2xy).
initN	The initial abundance.
ddType	The density dependence type.
Rmax	The maximum growth rate.
K	The initial carrying capacity.
Ksd	The standard deviation in K, if applicable.
allee	The allee parameter, if applicable.
kch	A constant, or reference to a .kch file describing temporal change in K.
ddDispSourcePopN	The parameter indicating the effect of source population abundance on its dispersal rate.
cat1LocalMulti	The local multiplier for probablity of Catastrophe 1, if applicable.
cat1LocalProb	The local probability of Catastrophe 1, if applicable.
includeInTotal	Indicates whether abundance of this population is included in totals reported in simulation results.
stageMatrix	The name of the stage matrix in use by the population.
relFec	The mean fecundity of this population, relative to those given in the stage matrix.
relSurv	The mean survival rates of this population, relative to those given in the stage matrix.
localThr	The abundance threshold below which the population might be considered dead (depending on global options specified elsewhere).
cat2LocalMulti	The local multiplier for probability of Catastrophe 2, if applicable.
cat2LocalProb	The local probablity of Catastrophe 2, if applicable.
sdMatrix	The name of the standard deviation matrix in use.
ddDispTargetPopK	The target population K below which dispersal out of this population is reduced.
tSinceCat1	The number of time steps since this population last experienced Catastrophe 1.
tSinceCat2	The number of time steps since this population last experienced Catastrophe 2.
relDisp	Dispersal rates of this population relative to those specified by the global dispersal matrix/function.
relVarFec	Variation in fecundity rates of this population, relative to those given in the standard deviation matrix.
relVarSurv	Variation in survival rates of this population, relative to those given in the standard deviation matrix.

Note

mptools has been tested with outputs generated by RAMAS Metapop version 5, and may produce unexpected results for other versions. A warning is issued if the user attempts to access files originating from other versions of RAMAS Metapop.

References

• Akcakaya, H. R., Burgman, M. A., Kindvall, O., Wood, C. C., Sjogren-Gulve, P., Hatfield, J. S., & McCarthy, M. A. (2004). Species Conservation and Management: Case Studies. New York: Oxford University Press.

• RAMAS Software

• RAMAS GIS and RAMAS Metapop Frequently Asked Questions

See Also

results

Examples

mp <- system.file('example.mp', package='mptools')
res <- meta(mp)
head(res)

johnbaums/mptools documentation built on May 19, 2019, 3:03 p.m.