Welcome to the hmer package website!

Perform history matching with emulation in an easy and efficient way using hmer



logos

Background

Infectious disease models are widely used by epidemiologists to improve the understanding of transmission dynamics and disease natural history, and to predict the possible effects of interventions. As the complexity of such models increases, however, it becomes increasingly challenging to robustly calibrate them to empirical data. History matching with emulation (HME) is a calibration method that has been successfully applied to such models, but has not been widely used in epidemiology partly due to the lack of available software. To address this issue, we developed a new, user-friendly R package hmer that allows you to simply and efficiently perform history matching with emulation.

History matching with emulation (HME) and hmer

History matching concerns the problem of exploring the parameter space and identifying the parameter sets that may give rise to acceptable matches between the model output and the empirical data. This part of the input space is referred to as non-implausible, while its complement is referred to as implausible. History matching proceeds as a series of iterations, called waves, where implausible areas of input space are identified and discarded. To do so, it is necessary to explore large portions of the parameter space. Unfortunately, this can be computationally unfeasible when working with complex simulators and/or high-dimensional parameter spaces. To address this issue, we resort to emulators.

An emulator is a statistical model of the simulator, which can be built using a relatively small number of simulator runs. The emulator approximates the simulator results, but also has a built-in understanding of the uncertainty brought by its estimates. This property allows us to use the emulator as a surrogate for the simulator, with the advantage that emulators tends to be several order of magnitude faster than the corresponding simulators.

In the hmer package, to train emulators, we forego a full Bayesian approach and instead focus on Bayes linear updates (for details, see e.g. this book). This has the advantage of being quick to evaluate, and does not require us to supply full probabilistic specifications for all parameters of the emulator.

Package development contributors

The development of the hmer package was supported by the Wellcome Trust.

Subscribe to our mailing list!

To subscribe to our mailing list, please go here and click on the “Subscribe” button on the left panel. You will be asked to insert your email address.

As a subscriber, you will receive updates on package new features and on hmer workshops.

You can unsubscribe from the hmer mailing list at any time. For information on how we use your data, please see our privacy notice for mailing list recipients and our Data Protection pages.