SmokingHistoryGenerator: R Package for the Smoking History Generator

Efficient R interface to the Cancer Intervention and Surveillance Modeling Network (CISNET) Smoking History Generator microsimulation engine, which synthesizes individual smoking histories (initiation, cessation, intensity) and ages at death from calibrated initiation, cessation, cigarettes-per-day, and mortality tables. The wrapper exposes fixed-cohort and population data-frame simulation, multi-threaded segmentation, reproducible pseudo-random streams (L'Ecuyer RngStream MRG32k3a or Matsumoto–Nishimura Mersenne Twister), legacy CLI-style configuration files, and portable YAML configuration save/load with optional split smoking and mortality parameter bundles. Methods follow Jeon et al. (2012) <doi:10.1111/j.1539-6924.2011.01775.x>. Random number generators: Matsumoto and Nishimura (1998) <doi:10.1145/272991.272995>; L'Ecuyer (1999) <doi:10.1287/opre.47.1.159>; L'Ecuyer et al. (2002) <doi:10.1287/opre.50.6.1073.358>.

Version: 6.5.3-1.0.1
Imports: methods, Rcpp (≥ 1.0.2), yaml
LinkingTo: Rcpp
Suggests: testthat (≥ 3.0.0), glue, httr2
Published: 2026-06-12
DOI: 10.32614/CRAN.package.SmokingHistoryGenerator (may not be active yet)
Author: John Clarke [aut, cre] (Author and maintainer of SHG R package wrapper for the SHG), Ben Racine [aut] (Co-author of the original SHG), Martin Krapcho [aut] (Co-author of the original SHG), Alexander Gaenko [aut] (Co-author of the original SHG), Makoto Matsumoto [ctb, cph] (Mersenne Twister mt19937 (src/mersenne_class.*); copyright notice in source), Takuji Nishimura [ctb, cph] (Mersenne Twister mt19937 (src/mersenne_class.*); copyright notice in source), Pierre L'Ecuyer [ctb, cph] (RngStream MRG32k3a (src/RngStream.*); copyright notice in source)
Maintainer: John Clarke <john.clarke at cornerstonenw.com>
License: GPL-3
URL: https://github.com/NCI-CISNET/shg-r
NeedsCompilation: yes
Materials: README, NEWS
CRAN checks: SmokingHistoryGenerator results

Documentation:

Reference manual: SmokingHistoryGenerator.html , SmokingHistoryGenerator.pdf

Downloads:

Package source: SmokingHistoryGenerator_6.5.3-1.0.1.tar.gz
Windows binaries: r-devel: not available, r-release: not available, r-oldrel: not available
macOS binaries: r-release (arm64): not available, r-oldrel (arm64): not available, r-release (x86_64): not available, r-oldrel (x86_64): not available

Linking:

Please use the canonical form https://CRAN.R-project.org/package=SmokingHistoryGenerator to link to this page.