Skip to contents

Creates visual representations of information stored within replica modules.

Usage

# S4 method for class 'ReplicaAdder'
depict(x, type = c("distribution", "difference", "heatmap"), ...)

Arguments

x

A ReplicaAdder.

type

Character string specifying the type of visualisation to create.

Options are:

  • "distribution"

  • "difference"

  • "heatmap"

...

Additional arguments passed to the underlying plotting function.

Value

A graphical object.

Details

The behaviour of depict() depends on the class of the supplied object.

Methods are currently available for:

  • ReplicaAdder

depict() is the primary method used to visualise information generated by replica modules.

For synthetic-population validation workflows, depict() is typically used after ratify has been called.

Together, ratify and depict() support evaluation of synthetic-population quality.

ratify() generates validation diagnostics and stores the results within a module, whereas depict() creates graphical summaries of those diagnostics.

ReplicaAdder Method

Creates graphical summaries of validation results stored within a ReplicaAdder.

Validation results must first be generated using ratify.

Supported visualisations include:

  • "distribution": observed versus expected distributions;

  • "difference": percentage-point differences;

  • "heatmap": differences displayed as a heatmap.

Examples

if (FALSE) { # \dontrun{

ADDER <- enhance(
  ADDER
)

ADDER <- ratify(
  ADDER
)

depict(
  ADDER,
  type = "distribution"
)

depict(
  ADDER,
  type = "difference"
)

depict(
  ADDER,
  type = "heatmap"
)

} # }