Package: poems
Type: Package
Title: Pattern-Oriented Ensemble Modeling System
Version: 1.4.0
Authors@R: c(
    person("Sean", "Haythorne", email = "sean.haythorne@unimelb.edu.au", role = "aut"),
    person("Damien", "Fordham", email = "damien.fordham@adelaide.edu.au", role = "aut"),
    person("Stuart", "Brown", email = "stuart.brown@sa.gov.au", role = "aut", comment = c(ORCID = "0000-0002-0669-1418")),
    person("Jessie", "Buettel", email = "jessie.buettel@utas.edu.au", role = "aut"),
    person("Barry", "Brook", email = "barry.brook@utas.edu.au", role = "aut"),
    person("July", "Pilowsky", email = "pilowskyj@caryinstitute.org", role = c("aut", "cre"), comment = c(ORCID = "0000-0002-6376-2585")))
Description: A framework of interoperable R6 classes (Chang, 2020, <https://CRAN.R-project.org/package=R6>) for building ensembles of viable models via the pattern-oriented modeling (POM) approach (Grimm et al.,2005, <doi:10.1126/science.1116681>). The package includes classes for encapsulating and generating model parameters, and managing the POM workflow. The workflow includes: model setup; generating model parameters via Latin hyper-cube sampling (Iman & Conover, 1980, <doi:10.1080/03610928008827996>); running multiple sampled model simulations; collating summary results; and validating and selecting an ensemble of models that best match known patterns. By default, model validation and selection utilizes an approximate Bayesian computation (ABC) approach (Beaumont et al., 2002, <doi:10.1093/genetics/162.4.2025>), although alternative user-defined functionality could be employed. The package includes a spatially explicit demographic population model simulation engine, which incorporates default functionality for density dependence, correlated environmental stochasticity, stage-based transitions, and distance-based dispersal. The user may customize the simulator by defining functionality for translocations, harvesting, mortality, and other processes, as well as defining the sequence order for the simulator processes. The framework could also be adapted for use with other model simulators by utilizing its extendable (inheritable) base classes.
Depends: R (>= 4.1.0)
Language: en-AU
License: GPL-3
URL: https://github.com/GlobalEcologyLab/poems,
        https://globalecologylab.github.io/poems/
BugReports: https://github.com/GlobalEcologyLab/poems/issues
Encoding: UTF-8
RoxygenNote: 7.3.2
Imports: abc (>= 2.1), doParallel (>= 1.0.16), foreach (>= 1.5.1),
        fossil (>= 0.4.0), lhs (>= 1.1.1), metRology (>= 0.9.28.1), R6
        (>= 2.5.0), raster (>= 3.6), trend (>= 1.1.4), truncnorm (>=
        1.0), gdistance, qs2
Collate: 'GenericClass.R' 'Region.R' 'GenericModel.R' 'SpatialModel.R'
        'DispersalFriction.R' 'GenerativeTemplate.R'
        'DispersalTemplate.R' 'Generator.R' 'DispersalGenerator.R'
        'GenericManager.R' 'LatinHypercubeSampler.R' 'ModelSimulator.R'
        'SimulationModel.R' 'PopulationModel.R' 'SimulationResults.R'
        'PopulationResults.R' 'ResultsManager.R' 'SimulationManager.R'
        'SimulatorReference.R' 'SpatialCorrelation.R' 'Validator.R'
        'data.R' 'poems-package.R' 'population_density.R'
        'population_dispersal.R' 'population_env_stoch.R'
        'population_results.R' 'population_transformation.R'
        'population_transitions.R' 'population_simulator.R'
Suggests: knitr, rmarkdown, sf, scales, stringi, testthat
VignetteBuilder: knitr, rmarkdown
NeedsCompilation: no
Packaged: 2025-11-11 17:45:35 UTC; julypilowsky
Author: Sean Haythorne [aut],
  Damien Fordham [aut],
  Stuart Brown [aut] (ORCID: <https://orcid.org/0000-0002-0669-1418>),
  Jessie Buettel [aut],
  Barry Brook [aut],
  July Pilowsky [aut, cre] (ORCID:
    <https://orcid.org/0000-0002-6376-2585>)
Maintainer: July Pilowsky <pilowskyj@caryinstitute.org>
Repository: CRAN
Date/Publication: 2025-11-12 15:10:02 UTC
Built: R 4.7.0; ; 2026-05-29 03:52:12 UTC; windows
