Figure for reporting engine: box whisker

[KatrinCoboeken]

Figure: box whisker

Figure is used to compare simulated pk Parameter or physiologic properties vs different virtual populations.

Additional it provides a table which contains the simulated properties in numeric format

Arguments:

Data

· Simulation result of one or more populations

Data.frame/data.table with following columns

o Value (double) value of the output to show (e.g. a PK parameter or a physiological property) in the unit of display, so no unit conversion is needed

o Individual_ID (Integer) must be unique per group

o Group (ordered factor) (character)

it is used to group individual results,

it is also used for legend (e.g. “Pediatric population”,”Adult Population”)

order of factor is used for order on X-Axis

· simulationResult.Metadata metada of Simulation Result

List with following entries:

o Value_unit: character

FigureConfiguration:

· Ylabel (e.g. ‘Cmax’)

· Yscale: character (default ‘lin’)

· Ylim vector of length 2 (e.g c(0,24)), default NULL time range to display, if null range is calculated to cover whole range of simulated results and observed data

· Percentile of whiskers (default c(5 95))

Return:

List with entries

· Figure: Figure object

· Table: table object

Details:

Plotting of simulated results

· Plot box whsiker plot for each group,

· percentiles of box are 25th, 50th and 75th percentile

· percentiles of whisker can be set by argument

Xticklabels

· group name of simulation result is on the x axis, for long text rotation is needed

Ylabel

· according to Xlabel and Ylabel issue #27 Figure: plot time profile

Table construction

Construct data.frame with one row per group and following columns

· group name

· number of entries per group

· percentile of lower whisker

· 25th percentile

· 50th percentile

· 75th percentile

· percentile of upper whisker

· arithmetric mean value

· standard deviation

· geometric mean value

· geometric standard deviation

Set meaningful column names out of X and Y labels and legend entries

[ju-rgen]

Example

Checks could be necessary for minimal number of values needed for computation of quantiles.

Individual ID seems not to be used, so not needed for input.