Data Upload & Configuration

Try Demo Data

Load a built-in demo dataset to explore the dashboard's features.

Data must be in long format — one row per observation/measurement.

Session Save / Restore

Save your current analysis state (settings, results, plots) and reload it later to continue where you left off.

Power Analysis

Estimate statistical power and sample sizes using a priori methods. Configure parameters in the sidebar and click Run Analysis.


Effect Size

Benchmarks: small ≈ 0.2, medium ≈ 0.5, large ≈ 0.8




Tumor Growth Parameters

All growth rates are on the log scale. Rate 0.15 ≈ 16% daily volume increase.


Variance Components (log scale)


Study Design


Simulation

Computationally intensive. Use ≤500 simulations for quick estimates.


Alpha Levels


Target Power



Overview

The Power Analysis tab supports prospective (a priori) sample-size planning before an experiment is run. Both methods estimate the probability of detecting a true effect of a specified magnitude at a chosen significance level.

  • A priori — Analytic — closed-form power calculation using a two-sample t-test (two groups) or one-way ANOVA (three or more groups). Fast; no simulation required.
  • A priori — LMM Simulation — Monte Carlo simulation of longitudinal tumor-growth data. Fits the same mixed-effects model used in the Tumor Growth tab and extracts power from the Treatment × Day interaction. More realistic for repeated-measures designs.

Post-hoc power analysis (computed from observed data after the experiment) is not provided. Post-hoc power is a monotone function of the p-value and adds no information beyond the test result itself (Hoenig & Heisey, 2001).

Analytic Mode — Method & Parameters

Method

For two groups, a two-sample t-test power calculation is used (non-central t-distribution). For three or more groups, one-way ANOVA power is computed via the non-central F distribution.

Two groups: Cohen's d = Δ / SD_pooled; power from the non-central t-distribution.

Three or more groups: Cohen's d is converted to Cohen's f via f = d / √2 . This assumes the two most extreme groups span the full effect and overestimates f — and therefore power — when all treated groups are uniformly shifted vs control. A method note is shown in the Scenario Table output when ≥ 3 groups are selected.


Effect Size Input
Cohen's d
Enter one or more d values directly (comma-separated). Conventional benchmarks: small ≈ 0.2, medium ≈ 0.5, large ≈ 0.8.
Mean difference + SD
Enter the expected mean difference (Δ) and pooled within-group SD. Cohen's d is computed internally. Use 'Seed SD from loaded data' to populate the SD from your uploaded dataset.

Solve For
Find N
Returns the required N per group to achieve each target power × alpha combination. Results shown in the Scenario Table.
Find Power
Returns achieved power at specified N values. Useful when sample size is constrained by practical considerations.

SD Sensitivity Tab

Shows how the required N changes when the assumed SD is perturbed by ±20 % and ±40 %. Only available in Mean Difference + Pooled SD mode. Use this to gauge sensitivity of your sample size estimate to uncertainty in the expected variance.

LMM Simulation Mode — Method & Parameters

Method

Synthetic tumor-growth datasets are generated on the log scale:

log(Volume) = log(baseline) + b₀ + (rate + b₁) × t + ε

where b₀ ~ N(0, random intercept SD), b₁ ~ N(0, random slope SD), and ε ~ N(0, residual SD). Volumes are exponentiated back to the original scale.

For each simulated dataset, log(Volume) ~ Treatment × Day + (Day | ID) is fitted via lme4 and significance assessed by a likelihood-ratio test (LRT). Power = proportion of simulations where p < α.


Key Parameters
Control log-growth rate
Exponential growth constant for the control group on the log scale. A rate of 0.15 corresponds to ~16 % daily volume increase.
Treatment rate reduction
Reduction in growth rate for treated vs control, on the log scale.
Random intercept SD
Between-animal variability in baseline volume (log scale). Higher values require larger N.
Random slope SD
Between-animal variability in growth rate (log scale).
Residual SD
Within-animal measurement noise (log scale).
Simulations
Number of Monte Carlo draws. Use ≥ 1000 for publication-quality estimates; ≤ 500 for quick exploration. Power estimates are shown with ±1.96 × SE uncertainty bands in the Power Curves tab.

Interpretation

Alpha (α)
Significance threshold (Type I error rate). Conventional choices are 0.05 (5 %) and 0.01 (1 %). Lower alpha requires a larger N to achieve the same power.
Power (1−β)
Probability of detecting a true effect. 0.80 is a common minimum; 0.90 is recommended when false negatives are costly.
N per group
Sample size per treatment arm. Total study animals = N per group × number of groups.

Power estimates assume the specified effect size is exactly correct. If the true effect is smaller, actual power will be lower than estimated. Use the SD Sensitivity tab to understand robustness to variance assumptions.


A priori power / sample size table: For each combination of effect size, alpha, and target power, shows the required N per group (Find N mode) or achieved power (Find Power / LMM mode).
  • Effect_Size — Cohen’s d (analytic) or the simulated scenario (LMM).
  • N_Groups — number of treatment groups in the design.
  • Alpha — significance threshold.
  • Required_N — N per group needed to reach the target power (Find N mode).
  • Achieved_Power / Power — power reached at the specified N (Find Power / LMM mode).
Loading...
Download
Power vs N per group: prospective power curves for the specified effect size scenario(s). Each line represents one Cohen’s d / alpha combination. Dashed lines mark 0.80 and 0.90 power thresholds.
Loading...
Download Plot
Sensitivity to the assumed SD: shows how the required N changes when the pooled within-group SD used to convert a raw mean difference into Cohen’s d is perturbed by ±20 % and ±40 %. Only available when using the Mean difference + Pooled SD input mode.
  • SD_Change — percentage change applied to the assumed SD.
  • Assumed_SD — resulting SD value.
  • Cohens_d — Cohen’s d after adjusting for the new SD.
  • Required_N — sample size required at the reference alpha / target power.
Loading...
Download

Tumor Growth Analysis

Configure analysis parameters and run statistical modeling. Ensure data is uploaded first from the Data Upload tab.


Overview

The Tumor Growth tab provides two statistical modeling approaches selectable from the Statistical Model dropdown:

  • Linear Mixed-Effects Model (LME4) — fits a mixed-effects model to repeated tumor volume measurements. Accounts for inter-animal variability and unequal observation times. Recommended for most longitudinal datasets.
  • Area Under Curve (AUC) — summarises each animal’s total tumor burden as the trapezoidal AUC of its growth curve. Non-parametric and robust to missing timepoints, but discards trajectory shape information.

Both modes compute Tumor Growth Inhibition (TGI) for each treatment group relative to the reference. TGI = (1 − V_treated / V_control) × 100 at the final timepoint.

LME4 Mode — Analyses & Outputs

Model

A linear mixed-effects model is fitted to transformed tumor volumes:

log(Volume) ~ Treatment × Day + (1 | ID)

The Treatment × Day interaction captures whether treatment groups differ in their growth trajectories over time, not just at a single endpoint.

Transformation
Log (default) stabilises variance and linearises exponential growth. Square root suits moderate heteroscedasticity. Use ‘None’ only for already-linear data.
Random Effects
‘Intercept only’ allows each animal to have its own baseline volume. ‘Intercept + Slope’ additionally allows individual growth rates — more flexible but may fail to converge with small groups.
Cage Effect
When a cage ID is mapped in Data Upload, cage can be included as a covariate to account for housing-level clustering. ‘Include if not collinear’ adds it automatically when it is statistically separable from treatment.

ANOVA Tab

Type III ANOVA F-test for Treatment, Day, and the Treatment × Day interaction. A significant interaction (p < 0.05) indicates that treatment groups differ in their growth trajectories — the primary analysis target.


Comparisons Tab

Pairwise group comparisons at the mean observation day using estimated marginal means (EMMs):

  • vs Reference (Dunnett) — each treatment vs the reference group only. Dunnett correction controls the familywise error rate for this one-vs-many structure and is less conservative than Bonferroni.
  • All Comparisons (Tukey HSD) — every pairwise combination. Use when all inter-group differences are of scientific interest.

Comparisons are marginalised at the mean study day. For trajectory differences across time, see the Treatment Effects tab.


Treatment Effects Tab

Estimated marginal means (EMMs) of transformed volume per treatment group. EMMs are shown at the mean observation day and at five quantile days (min, Q1, median, Q3, max), capturing the Treatment × Day interaction that a single mean-day estimate would miss.


Growth Rates Tab

Per-animal exponential growth rates estimated by log-linear regression of each animal’s volume trajectory independently. Reported as growth rate (log-scale slope), fold change, and % change per day with 95 % CIs and R². These are descriptive; for group-level inference use the ANOVA and Comparisons tabs.


Diagnostics Tab

Q–Q plot of residuals and residuals vs fitted values. Systematic curvature suggests the transformation choice should be revisited. Funnel-shaped spread indicates heteroscedasticity.

AUC Mode — Analyses & Outputs

Trapezoidal AUC of tumor volume over time is computed per animal. AUC (mm³·day) captures total tumor burden integrated over the study, not just the final timepoint.

Individual AUC
Per-animal AUC values with group summaries (mean, SD, SEM).
AUC Summary
Group comparisons via Welch t-tests with Benjamini–Hochberg correction.

LOCF (last observation carried forward) can extrapolate AUC to a common endpoint for animals censored early, so all animals contribute to the same time window. Set Extrapolation Points to 0 to use only observed data.

Bayesian LMM Mode — Method & Outputs

Method

Fits the same model formula as LME4 using full Bayesian inference via brms / Stan. Instead of point estimates and p-values, every parameter has a posterior distribution : a probability distribution over plausible values given the data and priors.

log(Volume) ~ Treatment × Day + (1 | ID)

Results are summarised as posterior medians with 95 % highest posterior density (HPD) credible intervals . A 95 % CrI has a direct probability interpretation: there is a 95 % posterior probability that the true parameter lies within the interval — unlike a frequentist confidence interval.


Prior Strength

Priors express what you believe about parameter values before seeing the data. They regularise estimates and prevent the model from chasing noise in small samples. All presets use Normal priors on fixed effects and Exponential priors on variance components; only the widths differ.

Skeptical
Default. N(0, 0.25) on fixed effects; Exponential(2) on SDs. Encodes the reasonable belief that treatment effects are small — effects > ±0.5 log-units per day are considered very unlikely a priori. Recommended for exploratory preclinical studies where large effects have not been previously established.
Weakly informative
N(0, 1) on fixed effects; Exponential(1) on SDs. Broader than Skeptical — appropriate when prior work suggests the treatment category can produce moderate-to-large effects.
Informative
N(0, 0.5) on fixed effects; Exponential(2) on SDs. Between Skeptical and Weakly informative. Useful when effect sizes in the 0.1–0.5 log-unit range are plausible based on prior data.
Diffuse
N(0, 2.5) on fixed effects; Exponential(0.5) on SDs. Near-flat priors; use with caution on small datasets as estimates can be driven entirely by noisy data.
Manual
Specify the prior family and parameters for each model class independently. Fixed effects (b): Normal or Student-t. Intercept: same. Random-effect SD and residual sigma: Exponential or half-Normal.

Result Tabs
  • Summary — posterior median and 95 % CrI for every model parameter.
  • Treatment Effects — group-level estimated marginal means (posterior) at the mean study day.
  • Comparisons — posterior contrasts of each group vs the reference.
  • Posterior Check — overlay of observed data density vs 50 draws from the posterior predictive distribution. Systematic mismatch indicates model mis-specification.
  • MCMC Diagnostics — Rhat and effective sample size (ESS) per parameter. Rhat > 1.01 indicates non-convergence; increase iterations or inspect trace plots.
  • Growth Rates — per-animal log-linear regression rates (same as LME4, not MCMC-based).
Computation time: typically 3–12 minutes on modern hardware. Stan compiles the model on the first call with a given formula and caches the result — subsequent calls with the same formula are faster. The dashboard runs fitting in the background; the app stays responsive while the model runs.

Necrotic Tumors — Handling Options

When a Necrotic Flag column is mapped in Data Upload, a handling selector appears in the sidebar. Necrotic tumors have a non-viable core that inflates caliper-based volume estimates without contributing to proliferating tissue.

Exclude (recommended)
Removes flagged observations from the model input. Conservative and publication-defensible. The Necrosis tab reports how many observations were flagged and which groups were affected, regardless of handling mode.
Covariate
Adds a 0/1 .necrotic_flag fixed effect to the LMM formula. Estimates the average volume bias attributable to necrosis. Useful when necrosis is approximately evenly distributed across groups and you want to retain all timepoints.
No adjustment
All observations are used as-is (current default when no necrotic column is mapped). The Necrosis summary table is still shown for documentation purposes.
The Necrosis tab in the results panel is inserted automatically when a necrotic column is mapped and an analysis has been run.

Shared Parameters

Reference Group
The vehicle/control group used as comparator. Auto-detected from common names (Vehicle, Control, DMSO, PBS, Saline) or defaults to the first group alphabetically.
Post-hoc Comparisons
Dunnett (vs reference, default) or Tukey HSD (all pairs). Applies to the Comparisons tab in LME4 mode.
Extrapolation Points
Number of recent timepoints used to fit a slope for animals that died before study end, then extrapolate their volume to the final day. Set to 0 to use observed data only.
Time Column
Numeric study day, or calculated from a date column mapped in Data Upload (days elapsed from first observation).

Loading...

                      
Loading...
Download ANOVA
Per-animal exponential growth rates estimated from each subject’s individual tumor volume trajectory using linear regression on log₁ₚ(volume) vs time. Requires ≥3 time points per animal. All rate, fold change, and percent change values are on a per-day basis.
  • Treatment — treatment group.
  • ID — individual animal identifier.
  • Cage — cage identifier.
  • Growth Rate — slope of the log₁ₚ(volume)–time regression (units: log-volume per day). Represents the instantaneous exponential growth constant: a value of 0.10 means ~10% volume increase per day on a continuous compounding basis.
  • GR 95% CI Lower/Upper Bound — 95% confidence interval for the log-scale growth rate.
  • Fold Change — exp(Growth Rate): multiplicative volume change per day. A value of 1.10 means the tumor is 10% larger each day; values below 1.0 indicate regression.
  • FC 95% CI Lower/Upper Bound — exp(GR CI bounds): back-transformed confidence interval for the daily fold change.
  • Percent Change — (Fold Change − 1) × 100: daily volume change expressed as a percentage (e.g. +10.5%/day or −3.2%/day).
  • PC 95% CI Lower/Upper Bound — (exp(GR CI) − 1) × 100: back-transformed CI bounds for the percent change.
  • — coefficient of determination from the per-animal log-linear regression. Values close to 1.0 indicate a good exponential fit; lower values suggest irregular growth or too few time points.
These are descriptive per-animal values used to visualise within-group spread and for sample size estimation. For group-level inference, use the Treatment Effects tab.
Loading...
Download Growth Rates
Descriptive statistics for tumor volume by treatment group and timepoint. Shows mean, standard deviation, and standard error across subjects measured at each study day.
  • Treatment — treatment group.
  • Day — study day (measurement timepoint).
  • Mean — mean tumor volume (mm³) for the group at that timepoint.
  • SD — standard deviation of volume across animals in the group.
  • SEM — standard error of the mean (SD / √N).
  • N — number of animals with a measurement on that day.
Useful for inspecting raw descriptive trends across time and confirming data entry. Statistical comparisons should use the ANOVA, Comparisons, or AUC Summary tabs as appropriate.
Loading...
Download Data Summary




Tumor Growth Curves

Loading...

Growth Rates Plot

Loading...

Area Under the Curve Plot

Loading...

Waterfall Plot

Loading...

Effect Size Forest Plot

Loading...

Q-Q Plot of Residuals

Loading...

Residuals vs Fitted

Loading...

Export All Results

Download every available result table (CSV) and plot (PNG) as a single ZIP file.

Download All Results

Survival Analysis (Time-to-Endpoint)

Note on ‘survival’ in mouse tumour experiments: Most IACUC protocols require euthanasia once tumour volume exceeds a set limit (e.g. 2000 mm³). The recorded endpoint is therefore time until tumour volume threshold , not true death. This is mathematically identical to survival analysis, but results should be labelled as ‘Time-to-Endpoint’ or ‘Time-to-Tumour-Volume-Threshold’ rather than ‘survival’ in publications.
Occasionally a mouse dies before reaching the volume limit. Competing-risks models (e.g. Fine–Gray) are the rigorous solution, but they require large per-group sample sizes rarely achievable in mouse experiments. The recommended pragmatic approach is to treat any death as an event (‘endpoint reached’), because the animal did not survive the study regardless of cause. The sidebar ‘Natural death’ option controls this behaviour.

Overview

The Survival tab fits Kaplan–Meier (KM) survival curves and a Cox proportional hazards model to time-to-endpoint data. In mouse tumor experiments the 'endpoint' is typically the day a tumor exceeds the IACUC volume limit, not true animal death.

Three outputs are produced:

  • Kaplan–Meier curves with log-rank test p-values.
  • Cox proportional hazards model reporting hazard ratios (HR) per group relative to the reference.
  • Risk table showing animals at risk, events, and KM estimates at each event time.

Kaplan–Meier Estimator

The KM estimator computes a non-parametric step-function survival probability S(t) = P(T > t) from event times. Each downward step corresponds to one or more events on that day.

Log-rank test
Tests whether the survival curves of two or more groups are statistically equivalent. The omnibus p-value tests all groups simultaneously; pairwise p-values are computed by restricting each comparison to the relevant two groups (df = 1).
Median survival
Day by which 50 % of animals reached the endpoint. 'Not reached' if fewer than half had events before study end.
Censoring
Animals that never reach the endpoint contribute their last observation day as a censored time. This correctly uses partial information rather than excluding them.

When all animals in a group are censored (zero events), a log-rank test is not meaningful. The model falls back to pairwise comparisons using only groups with at least one event.

Cox Proportional Hazards Model

The Cox model estimates the hazard ratio (HR) for each treatment group relative to the reference:

h(t) = h₀(t) × exp(β₁ × Treatment)
HR < 1
Lower hazard than reference — animals reach the endpoint more slowly (better outcome).
HR = 1
Identical hazard to reference.
HR > 1
Higher hazard than reference — animals reach the endpoint faster (worse outcome).

Firth's bias-reduced estimation is applied automatically when any group has zero events. Standard Cox partial likelihood produces infinite coefficient estimates in this case; Firth's penalisation regularises them.

The proportional hazards assumption requires that the HR is constant over time. Crossing KM curves indicate a time-varying HR, which violates this assumption — interpret Cox results with caution in that case.

Endpoint Configuration

Mapped censor column
When an Event/Censor column is mapped in Data Upload (0 = censored, 1 = event), it is used directly.
Auto-detection
When no censor column is mapped, animals that disappear before the final study day are automatically treated as events; animals present at the final day are censored.
Volume threshold
Optionally generate an event indicator by flagging animals whose tumor volume exceeds a specified threshold at any timepoint.
Natural death
If checked (recommended), animals that die before reaching the volume threshold are counted as events. If unchecked, only volume threshold crossings are events and natural deaths are censored.

Time-to-Endpoint summary: Per-group event counts, total subjects, event rate, and median time-to-endpoint (the day by which 50 % of animals reached the endpoint — typically tumour volume exceeding the IACUC limit). ‘Not reached’ means fewer than half the group experienced an event by study end.
Loading...

                      
Cox proportional hazards model. Hazard Ratios (HR) are computed relative to the reference group. Firth’s bias-reduced method is applied automatically when a group has zero events.
  • Group — treatment group name.
  • HR — Hazard Ratio: the instantaneous risk of the event in this group relative to the reference. HR < 1 means lower hazard (better survival); HR > 1 means higher hazard.
  • CI_Lower / CI_Upper — 95 % confidence interval for the HR. If this interval does not include 1.0, the difference is statistically significant at the 5 % level.
  • P_Value — p-value for the individual group coefficient from the Cox model.
  • Events — number of animals that reached the endpoint (tumour volume exceeded the IACUC threshold, or died before reaching it if natural death is treated as an event).
  • Total — total number of animals in the group.
  • Event_Rate — Events ÷ Total. Values close to 1.0 mean most animals reached the endpoint.
  • Median_Survival — day by which 50 % of the group reached the endpoint. ‘Not reached’ if fewer than half had events by study end.
  • Note — flags the reference group row.
Loading...

                      
Loading...

Group colours are mapped automatically from the analysis groups.


Annotation



Kaplan-Meier Survival Curves

Loading...

Hazard Ratio Forest Plot

Loading...
Numbers at risk table: one row per group per event time point, summarising what happened to the cohort at that moment.
  • Group — treatment group name.
  • Time — the day on which one or more events occurred.
  • N_Risk — number of animals still alive and uncensored at the start of this time interval.
  • N_Events — number of animals that experienced the endpoint at exactly this time.
  • N_Censored — number of animals whose last observation was at this time without reaching the endpoint (e.g. still within tumour volume limit at study end, or removed from study).
  • Survival — Kaplan–Meier estimated survival probability at this time point (1.0 = 100 % surviving).
N_Risk decreases over time as events and censoring accumulate; a rapid drop indicates many events in a short window.
Loading...

Toxicity Analysis

Analyze body weight toxicity, or combine with tumor efficacy to assess the therapeutic window. Requires a Weight/Mass column configured in the Data Upload tab.


Overview

The Toxicity tab provides two complementary analysis modes selectable from the Statistical Model dropdown:

  • Body Weight Analysis — models longitudinal weight trajectories using a linear mixed-effects model, and derives AUC-based and time-to-event (KM) toxicity summaries.
  • Efficacy-Toxicity Analysis — integrates body weight toxicity with tumor efficacy data to assess the overall therapeutic window. Requires a tumor volume column.

Body weight is used as the toxicity surrogate throughout. When 'Subtract estimated tumor weight' is enabled, the gross weight is corrected by subtracting Volume(mm³) × density(g/cm³) / 1000, giving a net host weight.

Body Weight Analysis — Analyses & Metrics

Mixed-Effects Model

Fits a linear mixed-effects model to all repeated weight measurements:

Weight ~ Treatment × Day + [covariates] + (Day | Mouse)

Random slopes allow each mouse's weight trend to deviate from the group average. Fixed effects test whether trajectories differ by treatment group over time.

REML
Restricted Maximum Likelihood — preferred for final parameter estimates (default).
ML
Maximum Likelihood — use when comparing models with different fixed-effect structures.

Covariates (optional):

  • Tumor Volume — controls for tumor-driven weight changes independent of drug toxicity.
  • Sex — adjusts for sex-specific baseline weight differences.
  • Initial Mass — adjusts for pre-treatment weight variation across animals.

Body Weight AUC

For each mouse, body weight is expressed as % change from baseline at each timepoint, then a trapezoidal AUC is computed over the study. A negative AUC indicates sustained weight loss; a positive AUC indicates net weight gain.

  • Individual AUC values are shown as a jitter plot with a configurable centre mark (mean or median) and error bars (SEM, SD, or 95% CI).
  • Units are % · days : e.g. a value of −100 means an average 5% weight loss sustained over 20 days.
  • Pairwise group comparisons use t-tests with Benjamini-Hochberg correction.

Nadir Analysis

The nadir (minimum weight) is identified per mouse. Reported metrics include nadir day, nadir weight, % loss at nadir, and days to recovery.


Weight Loss KM Curve

Treats each mouse as an event-time observation where the event is crossing the weight-loss threshold (default 20%). Mice that never reach the threshold are censored at their last observation. A Kaplan-Meier curve is fitted per group; group differences are tested with the log-rank test.

Weight Loss Threshold: The % body weight loss that constitutes a toxicity event. The default (20%) is a common IACUC endpoint; adjust to match study-specific welfare criteria.

Efficacy-Toxicity Analysis — Analyses & Metrics

Efficacy Metrics

Three metrics quantify anti-tumor efficacy per mouse relative to the control group:

Final TGI (%)
Tumor Growth Inhibition at the final timepoint: TGI = (1 − V_treated / V̅_control) × 100 . Values > 0 indicate tumor suppression; > 100 indicates tumor regression.
Tumor AUC
Trapezoidal AUC of tumor volume over time, normalised to the control AUC: (1 − AUC_treated / AUC_control) × 100 . Captures the full trajectory rather than a single endpoint.

Therapeutic Window Metric (TWM)

A summary ratio combining efficacy and toxicity per group:

TWM = TGI(%) / Mean Body Weight Loss(%)

Higher TWM indicates a more favourable balance. The denominator is the group mean of per-mouse maximum weight loss (not the single worst-case mouse). A noise floor prevents division by near-zero weight changes. Displayed as a ranked bar chart.


Safety-Efficacy Scatter

A per-mouse bivariate plot where each point represents one animal. X-axis shows the chosen efficacy metric; Y-axis shows maximum % body weight loss. Points in the top-right quadrant (high efficacy, high toxicity) represent the least favourable profile.

  • Group ellipses — 68% confidence ellipses (1 SD) per treatment group.
  • Group centroids — mean efficacy and mean max weight loss per group, shown as large diamonds.

Total Benefit Score

An integrated scalar combining efficacy and toxicity AUCs over time:

B = AUC(efficacy) − λ × AUC(toxicity)

A positive score indicates net benefit; negative indicates net harm. The trade-off parameter λ (lambda) controls how strongly toxicity is penalised:

  • λ = 1.0 (default) — equal weight on efficacy and toxicity.
  • λ > 1 — penalise toxicity more heavily; use for fragile populations or curative intent.
  • λ < 1 — tolerate more toxicity; use when efficacy improvement is the primary goal.

Weight-Corrected TGI

Recalculates TGI using only mice that stayed within the safety weight-loss threshold throughout the study. Mice exceeding the threshold are excluded from the corrected calculation.

This prevents a drug that arrested tumor growth due to severe toxicity from appearing falsely effective. Comparing the standard and corrected TGI reveals the extent of this confound.

Safety threshold: Mirrors the Weight Loss Threshold in Body Weight Analysis. Mice whose maximum weight loss exceeds this value are excluded from the corrected TGI.


Shared Parameters

Reference Group
The vehicle/control group used as the denominator for TGI and AUC ratios. Auto-detected from common names (DMSO, Vehicle, Control, PBS, Saline) or defaults to the first group alphabetically.
Subtract Tumor Weight
Removes the estimated tumor mass (Volume × density / 1000) from gross body weight before all calculations, so that body weight reflects host tissue rather than tumor burden.
Tumor Density
Used only when tumor weight adjustment is enabled. Default 1.0 g/cm³ (water density). Typical soft-tissue tumor density is 0.9–1.1 g/cm³.
Baseline Day
The study day used to compute % change from baseline. Defaults to the earliest available day.

Analysis summary. Body Weight Analysis: mixed-effects model output, fixed effects, and marginal means. Efficacy-Toxicity Analysis: therapeutic window, benefit scores, and corrected TGI.
Loading...

                      

Fixed Effects

Loading...
Download Fixed Effects CSV

Estimated Marginal Means by Treatment

Loading...
Download EMMs CSV

AUC Summary by Group

Loading...
Download AUC CSV

Nadir Weight Analysis

Loading...
Download Nadir CSV
Loading...
Download Comparisons CSV
Time-to-threshold event data. Each row is one mouse. Event = 1 when the weight-loss threshold was crossed; Event = 0 (censored) when the mouse never reached the threshold. This table feeds the Kaplan-Meier plot in the Plots tab.

Time-to-Threshold Event Data

Loading...
Download Events CSV





Body Weight Trajectory

Loading...

Body Weight AUC (% Change from Baseline)

Loading...

Weight Loss Kaplan-Meier Curve

Loading...

AUC Comparison Forest Plot

Loading...

Therapeutic Window Metric

Loading...

Safety-Efficacy Scatter

Loading...

Total Benefit Score

Loading...

Weight-Corrected vs Standard TGI

Loading...
Mixed-effects model diagnostics for the body weight trajectory model. Inspect residual normality (Q-Q plot) and homoscedasticity (residuals vs fitted). Diagnostics are only available in Body Weight Analysis mode.

Q-Q Plot of Residuals

Loading...

Residuals vs Fitted

Loading...
Model diagnostics are only available in Body Weight Analysis mode. Switch the Statistical Model in the sidebar to access them.

Export All Results

Download every available result table (CSV) as a single ZIP file.

Download All Results

Dose-Response Analysis

Analyze tumor volume responses across dose levels using linear regression, ANOVA, and non-linear dose-response models. Upload and configure your data (including a Dose column) in the Data Upload tab first, then run Tumor Growth Analysis before proceeding here.


Overview

The Dose-Response tab models how tumor volume (or TGI) varies across dose levels. Three complementary analyses are performed simultaneously:

  • Linear regression — tests whether there is a significant linear trend in tumor volume with increasing dose.
  • One-way ANOVA — tests whether any dose group differs from the others, followed by Tukey HSD post-hoc comparisons if significant.
  • Non-linear dose-response model (4PL) — fits a four-parameter log-logistic (Hill) model to quantify ED50 and curve steepness.

Tumor Growth Analysis must be run before using this tab — dose-response uses volume data preprocessed there. A Dose column must also be mapped in Data Upload.

Linear Regression

Fits Volume ~ Dose by ordinary least squares. The slope quantifies the change in mean tumor volume per unit increase in dose.

Slope
Change in volume per dose unit. A negative slope indicates dose-dependent tumor suppression.
Proportion of variance in volume explained by dose. Low R² with a significant slope can occur when individual variability is high relative to group differences.
p-value
Significance of the slope. A non-significant p-value does not exclude a non-linear relationship — inspect the 4PL model output and plots as well.

One-Way ANOVA & Tukey HSD

Treats dose as a categorical factor and tests whether group means differ. A significant F-test (p < 0.05) triggers Tukey HSD post-hoc comparisons to identify which specific dose pairs differ.

F-statistic
Ratio of between-group to within-group variance. Larger values indicate greater separation between dose groups relative to within-group noise.
Tukey HSD
Family-wise error rate corrected pairwise differences. Values in 'p adj' below 0.05 indicate a significant difference at the 5 % level after correction for all comparisons.

ANOVA assumes equal variances across groups (homoscedasticity). When this is violated, interpret alongside the linear regression, which is more robust to mild heteroscedasticity.

Non-Linear Model (4-Parameter Log-Logistic)

A four-parameter log-logistic (4PL / Hill) model is fitted via the drc package:

Volume = c + (d − c) / (1 + (Dose / ED50)^b)
b
Hill coefficient: steepness of the dose-response curve. Larger absolute values indicate a sharper transition.
c
Lower asymptote (response at saturating inhibitory dose).
d
Upper asymptote (response in the absence of drug).
ED50
Dose producing 50 % of the maximal effect. The primary pharmacodynamic summary statistic.
AIC / BIC note: AIC and BIC from the linear model ( stats::lm ) and the non-linear model ( drc::drm ) are not directly comparable for model selection — the two packages use different likelihood parameterisations. Prefer visual inspection of the fitted curve and residuals when choosing between linear and non-linear models.

Dose-response summary: Results of linear regression (slope, R², p-value) and one-way ANOVA across dose levels. A significant linear slope indicates a systematic increase or decrease in tumor volume with dose. A significant ANOVA F-test indicates that at least one dose group differs from the others.
Loading...

                      
Per-dose summary statistics of tumor volume at the selected time point, one row per dose level.
  • Dose — dose level (concentration or quantity as provided in your data).
  • n — number of animals at this dose.
  • mean_volume — arithmetic mean tumor volume across all animals at this dose.
  • sd_volume — standard deviation of tumor volume; reflects within-dose variability.
  • sem_volume — standard error of the mean (SD ÷ √n); indicates precision of the mean estimate.
  • ci95_lower / ci95_upper — lower and upper bounds of the 95 % confidence interval for the mean (using the t-distribution). Non-overlapping intervals between adjacent doses suggest a significant dose step.
Loading...

Appearance

Options

Title & Subtitle

Plot Size / Export

Tumor Volume vs Dose

Loading...

Tumor Growth Inhibition vs Dose

Loading...
Full statistical test results. The text output includes linear regression (slope, intercept, p-value, R²), one-way ANOVA table, and polynomial trend p-values. Non-linear model AIC/BIC are shown when the drc package fit converges. When ANOVA p < 0.05 the Tukey HSD post-hoc table is shown below:
  • Comparison — the two dose levels being compared (‘DoseA - DoseB’).
  • diff — estimated mean difference in tumor volume (Dose A minus Dose B).
  • lwr / upr — lower and upper bounds of the Tukey-adjusted 95 % confidence interval for the difference.
  • p adj — Tukey family-wise error rate adjusted p-value. Values below 0.05 indicate a significant difference between that dose pair.
Loading...

                      
Loading...

Drug Synergy Analysis

Test whether a drug combination shows synergistic, additive, or antagonistic effects using Bliss independence and Loewe additivity models. Ensure tumor growth data is uploaded and configured in the Data Upload tab.


Overview

The Drug Synergy tab assesses whether a drug combination produces greater tumor suppression than predicted from the individual drugs acting independently. Two reference models are evaluated simultaneously:

  • Bliss Independence — treats the two drugs as probabilistically independent. The expected combined TGI is the sum of individual TGIs, capped at 100 %.
  • Loewe Additivity — treats the drugs as dose-equivalent. The Combination Index (CI) measures how the observed combination effect compares to the expected additive effect.

Four treatment groups must be assigned in the sidebar: Control, Drug A only, Drug B only, and the Combination (A + B). Analysis can be run at a single timepoint or tracked over the full study duration.

Tumor Growth Analysis must be run first — Drug Synergy uses preprocessed volume data from that tab.

Bliss Independence

Under Bliss independence, drugs act on independent targets and their joint fractional effect (FE) is:

Expected TGI = min(FE_A + FE_B, 1.0) × 100

where FE = TGI / 100 for each single agent. The cap at 1.0 prevents the expected value from exceeding the biological ceiling.

Bliss Difference
TGI_combo − Expected TGI. Positive = synergy; negative = antagonism; near zero = independence.
Ceiling effect: When either individual drug achieves TGI > 50 %, the Bliss expected TGI approaches or reaches 100 %, leaving no room to detect synergy even if it is real. In this regime Bliss Difference will be near zero or negative regardless of combination performance. Interpret Bliss results cautiously when single-agent TGIs are high.

Loewe Additivity & Combination Index

Loewe additivity assumes that drugs acting on the same pathway are dose-equivalent and interchangeable. The Combination Index (CI) is:

CI = min(FE_A + FE_B, 1.0) / FE_combo

Interpretation thresholds:

  • CI < 0.85 — synergistic: the combination outperforms the additive expectation.
  • 0.85 ≤ CI ≤ 1.15 — additive: the combination matches the expected additive effect.
  • CI > 1.15 — antagonistic: the combination underperforms the additive expectation.
Loewe Difference
TGI_combo − Loewe Expected TGI. Positive = synergy; negative = antagonism.
Single-dose approximation: This implementation derives fractional effects from single-dose measurements rather than full dose-response curves for each drug. The CI is therefore an approximation of the true Loewe CI. A rigorous Loewe analysis requires IC50 values from complete dose-response curves — collect full dose-response data if a definitive CI is needed.

Over-Time Analysis

When 'Analyze over time' is enabled in the sidebar, Bliss and Loewe scores are computed at every measured timepoint and plotted as a synergy trend. This reveals whether synergy emerges, fades, or reverses over the course of treatment.

Per-timepoint p-values (Combination vs Drug A and vs Drug B, two-sample t-test) are included in the Synergy Metrics table. These are unadjusted for multiple testing across timepoints — interpret overall patterns rather than individual p-values at isolated days.


Synergy summary: Overall assessment combining Bliss independence and Combination Index (CI) metrics. Reports whether the drug combination is synergistic, additive, or antagonistic at the evaluated timepoint, and lists the key quantitative scores.
Loading...

                      
Quantitative synergy scores. When ‘Analyze over time’ is disabled, the table has two columns ( Metric / Value ) summarising scores at the selected timepoint:
  • Bliss Difference — observed combination effect minus the Bliss-independent expected effect (TGI combo − TGI Bliss). Positive = synergy; negative = antagonism.
  • Loewe Difference — observed combination effect minus the Loewe additivity expected effect (sum of individual fractional effects, capped at 100%). Positive = synergy; negative = antagonism.
  • Combination Index (CI) — Loewe-based CI: CI < 0.85 synergistic; 0.85 ≤ CI ≤ 1.15 additive; CI > 1.15 antagonistic.
  • Interpretation — plain-language summary based on the CI threshold.
When ‘Analyze over time’ is enabled, each row is a measured timepoint with columns:
  • Time_Point — study day.
  • TGI_Drug_A / TGI_Drug_B / TGI_Combo — % tumor growth inhibition for Drug A, Drug B, and the combination relative to control.
  • Bliss_Expected_TGI / Loewe_Expected_TGI — predicted TGI under the Bliss independence and Loewe additivity models, respectively.
  • Bliss_Difference / Loewe_Difference — TGI_Combo minus the expected TGI; positive values indicate synergy.
  • Combination_Index — Loewe-based CI at this timepoint (see thresholds above).
  • P_Value_vs_Drug_A / P_Value_vs_Drug_B — two-sample t-test p-value comparing the combination group to each mono-therapy; values below 0.05 indicate a statistically significant difference.
  • Synergy_Assessment — plain-language classification at each timepoint.
Loading...




Synergy Plot

Loading...

Synergy Plot

Loading...

Combination Index

Loading...

Tumor Growth Inhibition

Loading...

Help & Documentation

Disclaimer

mouseExperiment is provided "as is" for research purposes only, without warranty of any kind, express or implied. The authors and contributors accept no liability for errors, inaccuracies, or any consequences — including but not limited to incorrect results, data loss, or decisions made on the basis of outputs from this software. All results must be independently validated before use in publications, reports, regulatory submissions, clinical decisions, or any other application.


Basic Workflow

  1. Data tab — upload a CSV or RDA file and map your columns (ID, time, volume, treatment). Optional columns: cage, dose, body weight, survival/censor indicator.
  2. Analysis tabs — each tab activates once the required columns are mapped:
    • Tumor Growth — always available after upload
    • Survival — requires a survival/censor column (or use the volume-threshold derivation)
    • Toxicity — requires a body weight column
    • Dose Response — requires a dose column
    • Drug Synergy — requires control, single-agent A, single-agent B, and combination groups
    • Power Analysis — always available; no data upload needed for a priori modes
  3. Select the statistical method in the sidebar, configure parameters, and click Run Analysis .
  4. Explore results across sub-tabs (summary, plots, pairwise comparisons, model output).
  5. Download plots (PNG) and tables (CSV) from the per-tab download buttons.

Data Format

Upload data in long format : one row per measurement per animal. Accepted formats: CSV (.csv) or R data file (.rda / .rds).

Column auto-detection

The dashboard detects columns by name. Recognised patterns (case-insensitive):

Role Recognised names Required?
Animal ID ID, Mouse_ID, Animal_ID, Subject Yes
Time / Day Day, Time, Timepoint Yes
Tumor volume Volume, Tumor_Volume Yes †
Tumor length Length, Tumor_Length Yes †
Tumor width Width, Tumor_Width Yes †
Treatment / Group Treatment, Group Yes
Cage Cage, Cage_ID No
Dose Dose, dose, DoseLevel No
Body weight Weight, Mass, Body_Weight No
Survival / Censor Survival_Censor, Censor, Event No

† Provide either a pre-calculated Volume column, or Length + Width columns (volume calculated automatically as V = π·L·W²/6).

Survival/Censor must be numeric: 1 = endpoint reached (e.g. tumour exceeded IACUC volume limit), 0 = censored (alive or study-end censored). If absent, use the volume-threshold derivation in the Survival tab sidebar.


Analysis Modules

Tumor Growth

LME4 (linear mixed-effects)
Log-transforms tumor volume and fits a linear mixed model with a Treatment × Day interaction. Mouse ID is a random intercept; cage (if provided) is an additional random intercept. Pairwise contrasts via emmeans with Tukey adjustment. TGI (tumor growth inhibition) is derived from the estimated slopes.
AUC (area under the curve)
Computes per-mouse AUC by trapezoidal integration, then compares groups by Kruskal-Wallis / pairwise Wilcoxon tests.
Bayesian LMM (brms)
Same structure as the LME4 model fitted via MCMC (Stan). Returns posterior distributions for treatment slopes, credible intervals, probability of direction, and ROPE analysis. Requires the brms package.

Survival Analysis

Kaplan-Meier
Non-parametric survival estimates with 95% confidence bands. Log-rank test for group differences.
Cox proportional hazards
Semi-parametric Cox PH model. Hazard ratios with 95% CI for each treatment vs. reference.
Bayesian AFT (brms)
Accelerated failure time model with choice of Weibull, log-normal, exponential, or gamma distribution. Returns time ratios and derived hazard ratios with credible intervals.

Toxicity (Body Weight)

LME4 body weight model
Linear mixed model on body weight over time. Treatment × Day interaction identifies groups with significant weight-change trajectories.
Bayesian body weight model
Bayesian LMM for body weight via brms; same structure as the frequentist model.
Therapeutic Window Metric (TWM)
Combines tumor growth inhibition and body weight change into a single efficacy-toxicity ratio. Available in both frequentist and Bayesian variants.

Drug Synergy

Bliss Independence
Calculates the expected additive effect from two monotherapies at a chosen time point, then tests whether the observed combination effect exceeds it. Positive excess = synergy; negative excess = antagonism.
Loewe Combination Index (CI)
CI < 1 synergy, CI = 1 additivity, CI > 1 antagonism. Requires four groups: control, drug A alone, drug B alone, and combination.
Bayesian synergy
Propagates uncertainty from the growth model through Bliss and Loewe calculations, yielding posterior distributions for synergy metrics.

Dose-Response

Frequentist Hill / Emax
Fits a four-parameter log-logistic (4PL) dose-response curve via nonlinear least squares. Reports IC50, Hill slope, and fitted curve.
Bayesian Hill / Emax
Same model fitted by MCMC with weakly informative priors. Returns posterior distributions for all curve parameters.

Power Analysis

Analytic (a priori)
Classical power calculation for t-test or one-way ANOVA across a range of effect sizes and sample sizes.
LMM simulation
Simulates repeated-measures data under a linear mixed model and estimates power empirically across a grid of sample sizes.
Bayesian simulation
Simulates data, fits a Bayesian model to each replicate, and reports the proportion of replicates where the posterior probability of a directional effect exceeds a target threshold.

Troubleshooting

File won't upload
Ensure the file is CSV (.csv) or an R data file (.rda / .rds).
Columns not auto-detected
Use the column mapping dropdowns in the Data tab to assign columns manually.
Analysis tab is greyed out
Upload and configure data first. Survival requires a censor column (or enable volume-threshold derivation). Toxicity requires a body weight column. Dose Response requires a dose column. Drug Synergy requires at least four treatment groups.
Analysis fails or produces no output
Verify that the selected columns contain valid, non-missing data. Tumor volumes must be positive. Time points must be numeric. At least two groups must be present for any comparison.
Bayesian model is slow to start
The first run compiles the Stan model (∼30–60 s). Subsequent runs with the same model family reuse the compiled binary and start faster. Bayesian fits run asynchronously — the app remains usable while MCMC sampling proceeds.
Plot download produces a blank file
Run the analysis first so the plot is rendered, then click the download button.

About

mouseExperiment

Version 0.3.6
Last Updated 2026-05-14
Repository github.com/sciOmics/mouseExperiment

mouseExperimentDashboard

Version 26.5.20
Last Updated 2026-05-20