The StanMoMo package performs Bayesian
Mortality Modeling with
Stan, which is a C++ package for performing full
Bayesian inference (see https://mc-stan.org/). The current package supports a
variety of popular mortality models: the Lee-Carter (LC) model, the
Renshaw-Haberman model (LC with cohort effect), the Age-Period-Cohort
(APC) model, the Cairns-Blake-Dowd (CBD) model and the M6 model (CBD
with cohort effect). By a simple function call, the user obtains the
MCMC simulations for each parameter, the log likelihoods and death rates
predictions. Moreover, the package includes tools for model selection
and Bayesian model averaging by leave-future-out validation.
To install the stable version on CRAN:
install.packages("StanMoMo")To install the source package from Github:
install.packages("devtools")
devtools::install_github('kabarigou/StanMoMo')The installation of the source package may take a few minutes (models need to be compiled). For this reason, we recommend to install the binary package instead. Once the package is installed, you can perform Bayesian mortality forecasting in a matter of seconds.
After installing the package, you have to load the package via:
library(StanMoMo)The main purpose of this package is to provide users high-level functions for estimating and forecasting mortality models in a Bayesian setting without requiring any knowledge of the Stan modeling language. This package depends on the rstan package, which translates the Stan model to C++ code, which is compiled into a dynamic shared object (DSO). If you install the binary package (what we recommend), the mortality models are already pre-compiled. If you install the source package, the models are compiled during the installation and therefore you need a C++ compiler on your machine (for instance, Rtools for Windows or Xcode on Mac, see here for more details).
If you have any comments, suggestions for improvements or if you are motivated to contribute to the package, feel free to email karim290492@gmail.com
This package is related to our paper. When referring to this package, please cite as
Barigou, K., Goffard, P. O., Loisel, S., & Salhi, Y. (2023). Bayesian model averaging for mortality forecasting using leave-future-out validation. International Journal of Forecasting, 39(2), 674-690.