Base Intervention Model

GEMS models non-pharmaceutical interventions (NPIs) — such as testing, isolation, or setting closures — using a conceptual framework based on the idea of Trigger → Strategy → Measure, abbreviated as TriSM.

This logic forms the foundation for how interventions are defined and applied during a simulation:

  • Triggers determine when an intervention should be activated.
  • Strategies represent defined response plans that organize one or more measures.
  • Measures implement the actual effect on the simulation.

The TriSM pattern separates decision-making from action, enabling users to construct complex intervention policies without hard-coding behavior into the simulation core. Instead, users compose interventions from modular building blocks that are triggered by events or conditions during the simulation.

This page introduces the conceptual structure of TriSM. It is intended as a starting point for users who want to integrate interventions into their GEMS simulations.

Triggers

Triggers are the starting point of every intervention in GEMS. They observe the simulation and activate a response when certain conditions are met.

Triggers can be event-based — such as when an individual develops symptoms or is hospitalized — or time-based, activating at specific ticks or at regular intervals. Most triggers apply to all individuals in the simulation, while only the STickTrigger specifically targets individuals within a given setting, such as a school or household. Every trigger must be defined with a strategy. A trigger cannot exist on its own — it always needs to specify which strategy to activate when it fires.

In short, triggers define when an intervention should be considered.

Strategies

Strategies define what kind of response should happen when a trigger fires. Conceptually, they represent intervention plans — abstract containers for one or more actions.

A strategy may contain several measures or none at all. If it has no measures, triggering it results in no change to the simulation.

Strategies can also include conditions to determine whether they should be applied in a given context (e.g., only apply to children or specific settings).

There are two kinds of strategies:

  • IStrategies apply to individuals.
  • SStrategies apply to settings (e.g., a school or office).

Measures

Measures are the building blocks of actual intervention effects. They change how individuals or settings behave in the simulation — for example, isolating someone, testing a group, or closing a school class.

While triggers and strategies handle the when and what kind of response, measures implement the how. They are the only part of the TriSM structure that directly alters the simulation’s course.

Measures can be immediate, delayed, or conditional. Each measure can be configured to take effect after a fixed offset or with a delay function based on individual properties. The condition handles whether a measure should apply in a given situation, allowing interventions to target only specific individuals or settings.

Some measures can also trigger follow-up strategies — secondary intervention plans that are launched in response to the measure's outcome. For example, a positive test might result in isolating that agent.

GEMS provides a wide range of built-in measures for common interventions. For advanced use cases, users can also define custom measures to model specific behaviors or policy effects not covered by the defaults.

Testtypes

For testing measures (like individual test, pool test, or seroprevalence test), you need to specify the type of test being used. This is done by defining a Test Type.

A Test Type represents the properties of a diagnostic test (such as sensitivity and specificity). You define it once, and then you can reuse it in multiple testing measures. If you want different tests (e.g. antigen vs. PCR), you define multiple Test Types and assign them to the appropriate testing measures.

In short: the Test Type defines the diagnostic test itself, while the testing measure defines how, when, and to whom it is applied.

Conditions and Delays

In GEMS, measures and strategies can be extended with conditions and (for measures) offsets and delays to fine-tune their behavior:

  • Condition: Restricts whether a strategy or measure should be applied in a given context. For example, you can specify that an isolation measure should only apply to students, or only to members of households with more than 4 people.

  • Delay: Postpones the execution of a measure by a fixed time or a function of individual properties. For example, test results might arrive later for older individuals or rural settings.

  • Offset: A simple time shift; a measure will be applied a fixed number of ticks after the strategy is triggered. This is useful for scheduling follow-up actions (e.g. reopen a school class 10 days after closing it).

These extensions enable more nuanced and realistic modeling of interventions, while keeping the core logic modular and readable.