RPanczak / ISPM_excess-mortality-historical

Tracking century of excess mortality in Switzerland 🇨🇭, Sweden 🇸🇪 & Spain 🇪🇸
https://rpanczak.github.io/ISPM_excess-mortality-historical/
Other
4 stars 1 forks source link
bayesian epidemiology journal-article pandemic r reproducible-research research-compendium stan

Tracking excess mortality in Switzerland :switzerland:, Sweden :sweden: & Spain :es:.

Citations and links

Paper

Data & code to reproduce paper:

Staub K, Panczak R, Matthes KL, Floris J, Berlin C, Junker C, Weitkunat R, Mamelund SE, Zwahlen M, Riou J (2021) Historically high excess mortality during the COVID-19 pandemic in Switzerland, Sweden and Spain. Annals of Internal Medicine. [Epub ahead of print 1 February 2022]. doi:10.7326/M21-3824
* Equal contribution.

Code version 2.1.

Archived on DOI

Preprint

Earlier version of preprint:

Staub K, Panczak R, Matthes KL, Floris J, Berlin C, Junker C, Weitkunat R, Mamelund SE, Egger M, Zwahlen M, Riou J (2021) Pandemic excess mortality in Spain, Sweden, and Switzerland during the COVID-19 pandemic in 2020 was at its highest since 1918. medRxiv 2021.08.12.21261825. doi: https://doi.org/10.1101/2021.08.12.21261825
* Equal contribution.

Code version 1.0.

Archived on DOI

Online documentation

Details of the data sources, data preparation and main as well as supplementary analyses are available on the project pages.

Visual summary of repo content here.

Content of this repository

Structure

.
+-- analyses
+-- data
+-- data-raw
+-- docs
+-- paper
|   \-- supplementary
+-- R
+-- stan
\-- ubelix

analyses folder

This folder contains set of literate programming R scripts written either in R or inR flavoured markdown. The files are numbered sequentially in order in which they should be executed. The key parts of this folder include:

data-raw & data folders

Raw, unprocessed data are stored and accessed from the data-raw folder; prepared data are stored in data. Both of these folders contain subdirectories with names of the data source, for instance mortality_org folder stores data from the HMD whereas BfS folder stores data from Swiss Federal Statistical Office [Bundesamt für Statistik (BfS)]. outputs_YYYY-MM-DD folders in data directory hold results of the analyses runs and can be reused in order to save the computational time. Three files in data directory with names starting with results_ store outputs of the main models that were used for reporting in main figures and tables of the manuscript.

docs folder

This folder stores html files generated from the scripts in the analyses folder, with the names equivalent to the scripts that are used to generate them. These files are used on the project pages.

paper folder

This folder stores figures and tables presented in the paper and in the supplementary materials.

R folder

This folder stores various scripts used for data manipulation or analyses by the scripts from the analyses folder. Most important scripts include:

stan folder

Scripts from R script above make calls to Stan programs stored in this directory. Names of this programs are matching the scripts calling them (age_serfling_nb.stan & global_serfling_nb.stan). Both of the scripts have versions with 21 in the name of the file which are special cases of each script designed to handle incomplete 2021 data. Note that the programs will be compiled on their first run and will create additional files with the same name and extensions depending on the platform (for instance .exe on Windows OS; shell scripts on *NIX systems).

ubelix folder

This folder stores example OpenPBS scripts that can be used to submit the analyses scripts to HPC cluster.

secrets folder

This folder should store username & password for accessing Human Mortality Database in plain text files named username.txt & password.txt.

Computing environment

Details on the version of R software and packages used are presented at the bottom of the output documents stored in docs folder. Script 03_joint-model-cmdstan.R was run on HPC cluster using R version 4.1.0 with packages versions cmdstanr 0.4.0 & cmdstan 2.27.0.

Visual summary of main results

Estimates of excess

Yearly differences

Yearly differences

Monthly differences

Monthly differences

Four pandemics

Four pandemics

Four pandemics - percent

Age effects

Four pandemics

CC BY-NC-SA 4.0