Listeners: Class of Listener

In TrialSimulator: Clinical Trial Simulator

Class of Listener

Description

Create a class of listener. A listener monitors the trial while checking condition of pre-defined milestones. Actions are triggered and executed automatically.

Methods

Public methods

• Listeners$new()

• Listeners$add_milestones()

• Listeners$get_milestones()

• Listeners$get_milestone_names()

• Listeners$monitor()

• Listeners$mute()

• Listeners$reset()

• Listeners$clone()

---

Method new()

initialize a listener

Usage

Listeners$new(silent = FALSE)

Arguments

silent

logical. TRUE to mute messages.

---

Method add_milestones()

register milestones with listener. Order in ... matter as they are scanned in that order. It is user's responsibility to use reasonable order when calling this function, otherwise, the result of Listener$monitor() can be problematic.

Usage

Listeners$add_milestones(...)

Arguments

...

milestones

---

Method get_milestones()

return registered milestones

Usage

Listeners$get_milestones(milestone_name = NULL)

Arguments

milestone_name

return Milestone object with given name(s). If NULL, all registered milestones are returned.

---

Method get_milestone_names()

return names of registered milestones

Usage

Listeners$get_milestone_names()

---

Method monitor()

scan, check, and trigger registered milestones. Milestones are triggered in the order when calling Listener$add_milestones.

Usage

Listeners$monitor(trial, dry_run)

Arguments

trial

a Trial object.

dry_run

logical. See Controller::run for more information.

---

Method mute()

mute all messages (not including warnings)

Usage

Listeners$mute(silent)

Arguments

silent

logical.

---

Method reset()

reset all milestones registered to the listener. Usually, this is called before a controller can run additional replicates of simulation.

Usage

Listeners$reset()

---

Method clone()

The objects of this class are cloneable with this method.

Usage

Listeners$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.

Examples

##

TrialSimulator documentation built on Sept. 9, 2025, 5:26 p.m.