epigrowthfit is an R package for fitting nonlinear mixed effects models of epidemic growth to collections of one or more disease incidence time series. It can be applied to birth processes other than epidemics, as the statistical machinery is agnostic to the precise interpretation of supplied count data. epigrowthfit is built on Template Model Builder.
CRAN distributes both the package sources and binaries for Windows and macOS. Hence typical users will install epigrowthfit with
install.packages("epigrowthfit")or perhaps
install.packages("epigrowthfit", type = "source")to force installation from sources where installation of a binary
would occur by default. The rest of this section concerns the
type = "source" case.
Installation from sources depends on compilers and related tools. These will already be available on modern Linux installations. Windows users must have installed Rtools. macOS users must have installed Apple's Command Line Tools for Xcode and GNU Fortran. The most recent version of Command Line Tools supporting the version of macOS in use can be installed by running
sudo rm -rf /Library/Developer/CommandLineTools
sudo xcode-select --installin Terminal. Binaries for older versions of Command Line Tools can be downloaded here. GNU Fortran should be installed following the instructions on the R for macOS Developers page.
Vignette building depends on a
LaTeX distribution.
Specifically, PATH must specify the location of pdflatex.
Issues related to installation should be reported (with relevant output) here. Notably, details for Windows and macOS can differ for non-current versions of R or non-standard installations of R, where the "standard" way to install R is to download and unpack a binary built and published by CRAN.
Compiler errors encountered on macOS are almost always explained
by unmet dependencies or masking of native tools, headers, and
libraries with non-native ones (e.g., ones installed by Homebrew).
Masking occurs due to dubious configuration of PATH or dubious
setting (typically in ~/.R/Makevars) of Make variables such as
CPPFLAGS and LDFLAGS. Users should reattempt compilation
after removing suspicious components of PATH (e.g., by
removing relevant lines of startup files in your home directory,
then launching a new shell) and (re)moving ~/.R/Makevars.
epigrowthfit supports low level parallelism via
OpenMP. The support tends to
be automatic except on macOS, because Apple's Command Line Tools do
not bundle the requisite headers and runtime library. The R for macOS
Developers page makes these files
available for download, hence macOS users can follow the installation
instructions there. If clang --version gives 1403.0.22.14.1 (say),
then one would do
curl -O https://mac.r-project.org/openmp/openmp-15.0.7-darwin20-Release.tar.gz
sudo mkdir -p /opt/R/$(uname -m)
sudo tar -xvf openmp-15.0.7-darwin20-Release.tar.gz --strip-components=2 -C /opt/R/$(uname -m)and create a ~/.R/Makevars containing the lines
CPPFLAGS += -Xclang -fopenmp
LDFLAGS += -lompThe flags in the tar command line ensure that the files are unpacked
under /opt/R/x86_64 (Intel) or /opt/R/arm64 (Apple Silicon).
Standard installations of R will already be configured to search there
for dependencies.
After installing, users can access the package index (a list of available help topics) with:
help(package = "epigrowthfit")The HTML help contains useful hyperlinks and typeset math.
You can force HTML rendering, where that is not the default,
by passing help_type = "html".
Active development happens on branch master. Tested changes intended
for the next release are ported to branch release-candidate,
where tarballs submitted to CRAN are eventually built. Neither master
nor release-candidate should be considered stable.
The stable branches are named release-x.y.z. They branch from
release-candidate before the version number there is incremented,
typically just after a tarball is submitted to CRAN.
To install epigrowthfit from sources in a given branch or commit, install remotes and run, e.g.,
remotes::install_github("davidearn/epigrowthfit", ref = "release-0.15.2")
remotes::install_github("davidearn/epigrowthfit", ref = "cf6fdd8")