Package: mcmsupply 1.0.1

Hannah Comiskey

mcmsupply: Estimating Public and Private Sector Contraceptive Market Supply Shares

Family Planning programs and initiatives typically use nationally representative surveys to estimate key indicators of a country’s family planning progress. However, in recent years, routinely collected family planning services data (Service Statistics) have been used as a supplementary data source to bridge gaps in the surveys. The use of service statistics comes with the caveat that adjustments need to be made for missing private sector contributions to the contraceptive method supply chain. Evaluating the supply source of modern contraceptives often relies on Demographic Health Surveys (DHS), where many countries do not have recent data beyond 2015/16. Fortunately, in the absence of recent surveys we can rely on statistical model-based estimates and projections to fill the knowledge gap. We present a Bayesian, hierarchical, penalized-spline model with multivariate-normal spline coefficients, to account for across method correlations, to produce country-specific,annual estimates for the proportion of modern contraceptive methods coming from the public and private sectors. This package provides a quick and convenient way for users to access the DHS modern contraceptive supply share data at national and subnational administration levels, estimate, evaluate and plot annual estimates with uncertainty for a sample of low- and middle-income countries. Methods for the estimation of method supply shares at the national level are described in Comiskey, Alkema, Cahill (2022) <arxiv:2212.03844>.

Authors:Hannah Comiskey [aut, cre], Niamh Cahill [aut], Leontine Alkema [aut]

mcmsupply_1.0.1.tar.gz
mcmsupply_1.0.1.zip(r-4.5)mcmsupply_1.0.1.zip(r-4.4)mcmsupply_1.0.1.zip(r-4.3)
mcmsupply_1.0.1.tgz(r-4.4-any)mcmsupply_1.0.1.tgz(r-4.3-any)
mcmsupply_1.0.1.tar.gz(r-4.5-noble)mcmsupply_1.0.1.tar.gz(r-4.4-noble)
mcmsupply_1.0.1.tgz(r-4.4-emscripten)mcmsupply_1.0.1.tgz(r-4.3-emscripten)
mcmsupply.pdf |mcmsupply.html
mcmsupply/json (API)
NEWS

# Install 'mcmsupply' in R:
install.packages('mcmsupply', repos = c('https://hannahcomiskey.r-universe.dev', 'https://cloud.r-project.org'))

Peer review:

Bug tracker:https://github.com/hannahcomiskey/mcmsupply/issues

Uses libs:
  • jags– Just Another Gibbs Sampler for Bayesian MCMC
  • c++– GNU Standard C++ Library v3
Datasets:
  • Country_and_area_classification - The Country and area classification according to the United Nations Standaistical Division, Standard country or area codes for statistical use (M49). Adapted for use in FP2030 by the Track20 project. A subset of data from the United Nations country classifications
  • DEFT_DHS_database - DEFT_DHS_database A database of the design effects for some of the DHS surveys in the national and subnational datasets. Due to due to multistage and clustering of the DHS sample, the average standard error is increased by a design effect (DEFT) factor over that in an equivalent simple random sample.
  • country_names - The names of the countries with national and subnational administration level data stored
  • national_FPsource_VARCOV_bivarlogitnormal - An array of variance-covariance matrices corresponding to the DHS survey observations for the proportion of modern contraceptives supplied by the public and private sectors at the national level
  • national_FPsource_data - DHS survey observations for the proportion of modern contraceptives supplied by the public and private sectors at the national level
  • national_FPsource_format - A checklist for ensuring national-level custom data is appropriate to be used for estimation
  • national_estimated_correlations_bivarlogitnormal - The estimated national-level correlations between the rates of change in methods
  • national_inv_sigma_delta_hat_bivarlogitnorm - The median estimate for the national-level variance-covariance matrix of the delta.k terms in the multi-country national model.
  • national_tau_alpha_cms_hat_bivarlogitnorm - The median estimates of the precision for the national-level country
  • national_theta_rms_hat_bivarlogitnorm - The median estimates of the national-level sub-continental, sector-, method-specific intercepts in the multi-country national model. This array is used to inform the Normal prior of the country-level intercept in the single-country national model.
  • national_varcov_order_bivarlogitnormal - The order of observations to join the variance-covariance array data and the DHS survey observations for the proportion of modern contraceptives supplied by the public and private sectors at the national level
  • subnat_FPsource_data - DHS survey observations for the proportion of modern contraceptives supplied by the public and private sectors at the subnational administration level.
  • subnat_FPsource_format - A checklist for ensuring subnational-level custom data is appropriate to be used for estimation
  • subnational_alpha_cms_hat - The median estimates of the subnational-level country, sector-, method-specific intercepts in the multi-country subnational model. This array is used to inform the Normal prior of the subnational-level intercept in the single-country subnational model.
  • subnational_estimated_correlations - The estimated subnational-level correlations between the rates of change in methods
  • subnational_inv.sigma_delta_hat - The median estimate for the subnational-level precision matrix of the delta.k terms in the multi-country subnational model. This array is used to inform the multi-variate normal prior in the single-country subnational model.
  • subnational_tau_alpha_pms_hat - Subnational_tau_alpha_pms_hat The median estimates of the precision for the subnational-level country

On CRAN:

5.02 score 2 stars 15 scripts 191 downloads 6 exports 129 dependencies

Last updated 8 months agofrom:b54f996703. Checks:OK: 3 NOTE: 4. Indexed: yes.

TargetResultDate
Doc / VignettesOKNov 01 2024
R-4.5-winOKNov 01 2024
R-4.5-linuxOKNov 01 2024
R-4.4-winNOTENov 01 2024
R-4.4-macNOTENov 01 2024
R-4.3-winNOTENov 01 2024
R-4.3-macNOTENov 01 2024

Exports:get_dataget_modelinputsget_posterior_P_sampsplot_estimatespull_estimatesrun_jags_model

Dependencies:abindarrayhelpersaskpassbackportsbase64encbitbit64blobbootbroombslibcachemcallrcellrangercheckmateclicliprcodacodetoolscolorspaceconflictedcpp11crayoncurldata.tableDBIdbplyrdigestdistributionaldplyrdtplyrevaluatefansifarverfastmapfontawesomeforcatsforeachfsgarglegenericsggdistggplot2gluegoogledrivegooglesheets4gtablehavenhighrhmshtmltoolshttridsisobanditeratorsjquerylibjsonliteknitrlabelinglatticelifecyclelubridatemagrittrMASSMatrixmatrixStatsmemoisemgcvmimemodelrmunsellnlmenumDerivopensslpillarpkgconfigplyrposteriorprettyunitsprocessxprogresspspurrrquadprogR2jagsR2WinBUGSR6raggrappdirsRColorBrewerRcppreadrreadxlrematchrematch2reprexrjagsrlangrmarkdownrstudioapirunjagsrvestsassscalesselectrstringistringrsvUnitsyssystemfontstensorAtextshapingtibbletidybayestidyrtidyselecttidyversetimechangetinytextzdbutf8uuidvctrsviridisLitevroomwithrxfunxml2yaml

Package data

Rendered frompackage_data.Rmdusingknitr::rmarkdownon Nov 01 2024.

Last update: 2024-04-05
Started: 2023-03-23

Running a national level multi-country model

Rendered fromnational_multicountry_mod.Rmdusingknitr::rmarkdownon Nov 01 2024.

Last update: 2024-04-05
Started: 2024-04-05

Running a national level single-country model

Rendered fromnational_singlecountry_mod.Rmdusingknitr::rmarkdownon Nov 01 2024.

Last update: 2024-04-05
Started: 2024-04-05

Running a national level single-country model with custom data

Rendered fromnational_singlecountry_customdata_models.Rmdusingknitr::rmarkdownon Nov 01 2024.

Last update: 2024-04-05
Started: 2024-04-05

Running a subnational level multi-country model

Rendered fromsubnational_multicountry_models.Rmdusingknitr::rmarkdownon Nov 01 2024.

Last update: 2024-04-05
Started: 2024-04-05

Running a subnational level single-country model

Rendered fromsubnational_singlecountry_models.Rmdusingknitr::rmarkdownon Nov 01 2024.

Last update: 2024-04-05
Started: 2024-04-05

Running a subnational level single-country model with custom data

Rendered fromsubnational_singlecountry_customdata_models.Rmdusingknitr::rmarkdownon Nov 01 2024.

Last update: 2024-04-05
Started: 2024-04-05

Readme and manuals

Help Manual

Help pageTopics
The Country and area classification according to the United Nations Standaistical Division, Standard country or area codes for statistical use (M49). Adapted for use in FP2030 by the Track20 project. A subset of data from the United Nations country classificationsCountry_and_area_classification
The names of the countries with national and subnational administration level data storedcountry_names
DEFT_DHS_database A database of the design effects for some of the DHS surveys in the national and subnational datasets. Due to due to multistage and clustering of the DHS sample, the average standard error is increased by a design effect (DEFT) factor over that in an equivalent simple random sample.DEFT_DHS_database
Wrapper function that retrieves the DHS data used for modelling the proportion of modern contraceptives supplied by the public and private sectors at the national and subnational administration levels.get_data
Function to pull the complete posterior sample for the national method-supply share estimates. Functionality for the subnational models is still under development.get_posterior_P_samps
Get JAGS model inputsget_modelinputs get_subnational_modelinputs
The estimated national-level correlations between the rates of change in methodsnational_estimated_correlations_bivarlogitnormal
DHS survey observations for the proportion of modern contraceptives supplied by the public and private sectors at the national levelnational_FPsource_data
A checklist for ensuring national-level custom data is appropriate to be used for estimationnational_FPsource_format
An array of variance-covariance matrices corresponding to the DHS survey observations for the proportion of modern contraceptives supplied by the public and private sectors at the national levelnational_FPsource_VARCOV_bivarlogitnormal
The median estimate for the national-level variance-covariance matrix of the delta.k terms in the multi-country national model.national_inv_sigma_delta_hat_bivarlogitnorm
The median estimates of the precision for the national-level country, sector-, method-specific intercepts in the multi-country national model. This vector is used to inform the precision in the Normal prior of the national-level intercept in single-country national models.national_tau_alpha_cms_hat_bivarlogitnorm
The median estimates of the national-level sub-continental, sector-, method-specific intercepts in the multi-country national model. This array is used to inform the Normal prior of the country-level intercept in the single-country national model.national_theta_rms_hat_bivarlogitnorm
The order of observations to join the variance-covariance array data and the DHS survey observations for the proportion of modern contraceptives supplied by the public and private sectors at the national levelnational_varcov_order_bivarlogitnormal
Wrapper function to plot the JAGS estimatesplot_estimates
Function to pull method-supply share median estimates and credible intervals for a given year and country.pull_estimates
Wrapper function to run the jags model for estimating the proportion of modern contraceptive methods supplied by the public & private Sectors using a Bayesian hierarchical penalized spline model for the national and subnational administration levelsrun_jags_model
DHS survey observations for the proportion of modern contraceptives supplied by the public and private sectors at the subnational administration level.subnat_FPsource_data
A checklist for ensuring subnational-level custom data is appropriate to be used for estimationsubnat_FPsource_format
The median estimates of the subnational-level country, sector-, method-specific intercepts in the multi-country subnational model. This array is used to inform the Normal prior of the subnational-level intercept in the single-country subnational model.subnational_alpha_cms_hat
The estimated subnational-level correlations between the rates of change in methodssubnational_estimated_correlations
The median estimate for the subnational-level precision matrix of the delta.k terms in the multi-country subnational model. This array is used to inform the multi-variate normal prior in the single-country subnational model.subnational_inv.sigma_delta_hat
subnational_tau_alpha_pms_hat The median estimates of the precision for the subnational-level country, sector-, method-specific intercepts in the multi-country subnational model. This vector is used to inform the precision in the Normal prior of the subnational-level intercept in single-country subnational models.subnational_tau_alpha_pms_hat