R/dd_model_lc.R

Defines functions dd_model_lc

Documented in dd_model_lc

#' Diversity-dependent model with linear (l) dependence on speciation and
#' constant (c) extinction
#'
#' A list specifying a DD model with linear diversity-dependence on the
#' speciation rate and constant-rate extinction; to be fed as argument
#' `dd_model` to [comrad::fit_dd_model_with_fossil()].
#'
#' \deqn{\lambda(N) = \lambda_{0} - (\lambda_{0} - \mu_{0}) \frac{N}{K} \\ \mu(N) = \mu_{0}}
#'
#' @author Theo Pannetier
#' @export
dd_model_lc <- function() {
  list(
    "name" = "lc",
    "speciation_func" = function(params, N) {
      pmax(params["lambda_0"] - (params["lambda_0"] - params["mu_0"]) * (N / params["k"]), 0)
    },
    "extinction_func" = function(params, N) {
      rep(params["mu_0"], length(N))
    },
    "constraints" = list(
      function(params, ...) params["lambda_0"] > 0,
      function(params, ...) params["mu_0"] >= 0,
      function(params, ...) params["k"] >= 1,
      function(params, ...) params["lambda_0"] > params["mu_0"],
      function(params, N_max, ...) {
        kprime <- ceiling(params["k"] * params["lambda_0"] /
                            (params["lambda_0"] - params["mu_0"]))
        N_max <= kprime
      }
    ),
    "params_check" = function(params) {
      params_names <- names(params)
      if (!(length(params_names) == 3 &&
            all(params_names %in% c("lambda_0", "mu_0", "k"))
      )) {
        stop("params for ddmodel_lc should be \"lambda_0\", \"mu_0\" and \"k\".")
      }
    },
    "DDD_name" = 1
  )
}
TheoPannetier/comrad documentation built on April 8, 2023, 8:06 a.m.