plot_distribution: Plot distributions of retained simulated observations

In SimTOST: Sample Size Estimation for Bio-Equivalence Trials Through Simulation

Plot distributions of retained simulated observations

Description

Creates density, histogram, ECDF, or Q–Q plots for a selected trial-level quantity. The estimand argument selects an arm parameter, a reconstructed TOST statistic, a continuous comparison, a count rate ratio, or endpoint correlations.

Usage

plot_distribution(x, estimand = "mu", arms = NULL, endpoints = NULL, ...)

Arguments

x	A result returned by sampleSize() or simPower() with keep_sim_data = TRUE.
estimand	Quantity to display: "mu" (or "mean"), "sigma", "dispersion", "rate", "t_value", "DOM", "ROM", "RR", or "correlation". "mean" and "sigma" display arm-specific simulation parameters; "DOM" and "ROM" display continuous comparison estimates; "RR" displays count rate ratios; and "correlation" displays endpoint correlations.
arms	Optional character vector of arm names. For mean and sigma, these are the arms to facet. For comparison estimands, these select comparator panels containing at least one supplied arm. If NULL, all are shown.
endpoints	Optional character vector of endpoint names. If NULL, all endpoints are displayed.
...	Optional plotting controls, including type, show_reference, n_trials, seed, and max_points. Legacy selector names are accepted for backward compatibility.

Details

Every comparator follows the package convention c(test, reference). For t_value, the lower and upper TOST statistics are reconstructed from the retained outcomes using the same continuous parallel formulas as the test. The dashed lines are the corresponding one-sided critical values. The plotted DOM is test - reference and the plotted ROM is test / reference; reversing the comparator reverses the displayed estimand. The plotted RR is rate_test / rate_reference.

Value

A ggplot object.

SimTOST documentation built on Oct. 9, 2026, 5:07 p.m.