safety.vizRelease candidateAnnotated demo

safety.viz v1.12.0: Visit or Study day

Every chart that shows change over time can now be read by visit or by study day, with one switch that works the same way everywhere. The demo data now carries real study days, and hep-explorer's 30-day timing test is measured in days.

Captured 11 November 2026after: the dev site, dev at bb8f52c5before: release 1.11.3, the released site59 of 59 checks held
In short
01 / the participant profile

The profile has an X-axis control: Visit or Study day

The gallery's participant profile page, participant 01-701-1028. It opens on Visit.

Before · release 1.11.3
The participant profile for 01-701-1028 in release 1.11.3: one time axis titled Study Day, running from 1 to 183, with no X-axis control.
After · release 1.12.0 (dev site)
The same profile in release 1.12.0 in Visit view: the X-axis control with Visit pressed, one evenly spaced tick per visit from Baseline to Week 26, and the adverse events listed under the chart.
  1. The X-axis control: Visit | Study day.
  2. Visit view: the visits evenly spaced, each tick a visit name (Baseline, Week 2, Week 4 … Week 26).
  3. The adverse events are listed, with their study days, not drawn: a visit axis has no days to draw them on.

Before: the axis was titled “Study Day”, but on this page it plotted a day worked out from the visit name (Baseline day 1, Week N day 7N + 1), so the last ALT sat at 183. The real study day is 180.

After · Study day view
The same profile in Study day view: the axis titled Study day from -8 to 180, a dotted line at day 1, the Week 8 point's tooltip reading Week 8 · Day 54, and the adverse-event track under the chart.
  1. A dotted line marks day 1, the first dose. Records before it have negative days.
  2. The tooltip names both: “Week 8 · Day 54”.
  3. The adverse-event track shows only in this view, on the same day axis as the labs.

The last ALT now sits at study day 180, Week 26. The adverse events listed in Visit view: application site erythema: from study day 3, no end date recorded; application site pruritus: from study day 21, no end date recorded.

Try it
  1. Open the participant profile demo and click a point in the chart at the top.The profile below opens on Visit, with the X-axis control in its controls.
  2. Press Study day.The axis turns into days, a line marks day 1, and the adverse-event track appears.
  3. Point at a dot on the ALT line.The tooltip reads like “Week 8 · Day 54”.
02 / the side panel

The profile as a side panel has its own toggle

Selecting a participant in a host chart opens the profile beside it. It opens on the host's view, or on Visit where the host has no toggle, and keeps its own choice after that.

Before · release 1.11.3
The histogram's side panel for 01-701-1028 in release 1.11.3: the axis titled Study Day, running 0 to 13.
After · release 1.12.0 (dev site)
The same side panel in release 1.12.0: the X-axis control with Visit pressed, and visit names on the axis.
  1. The side panel's own X-axis control, opening on Visit.

The histogram, participant 01-701-1028. Before, the panel plotted the visit number under the title “Study Day”: the last ALT at 13. In Study day view it now sits at day 180.

Try it
  1. Open the histogram demo, set Participant ID to 01-701-1028 and click a bar, then a row of the listing.The side panel opens on Visit, with its own X-axis control.
  2. Press Study day in the panel.The panel's axis turns into days; the histogram does not change.
03 / the outlier explorer

The outlier explorer plots by visit or by study day

Release 1.11.3 plotted each participant's results in the order they came, under the title "Measurement". The main axis now takes the same X-axis control, opening on Visit.

Before · release 1.11.3
The outlier explorer in release 1.11.3: ALT for every participant over an axis titled Measurement, numbered 1, 2, 3 and so on.
After · release 1.12.0 (dev site)
The outlier explorer in release 1.12.0: the X-axis control with Visit pressed, and one evenly spaced tick per visit, unscheduled visits included.
  1. The X-axis control, in the controls on the left.
  2. The axis title: “Visit”, with 19 visits, unscheduled ones after the visit they follow.

Alanine Aminotransferase, every participant.

Study day view, 01-701-1028 selected
The outlier explorer in Study day view with participant 01-701-1028 selected; a point's tooltip reads Week 8 · Day 54.
  1. The tooltip names both: “Week 8 · Day 54”.
The listing
The listing for participant 01-701-1028: a Time column reading Baseline · Day -8, Week 2 · Day 14 and so on.
  1. The “Time” column names both: “Baseline · Day -8”, “Week 2 · Day 14”, “Week 4 · Day 27” …

The listing's 10 records for 01-701-1028 each name a visit and a study day, whichever view is on.

Try it
  1. Open the outlier explorer demo.The axis is titled Visit.
  2. Press Study day, then click a line.The axis is in days; the listing below names the visit and the day of each record.
04 / the QT drill-down

The QT drill-down by visit or by study day

Selecting a participant in the QT explorer opens their ECGs in the side panel. Release 1.11.3 passed the visit number there as the study day.

Before · release 1.11.3
The QT drill-down for 01-701-1028 in release 1.11.3: an axis titled Study Day running 0 to 26.
After · release 1.12.0 (dev site)
The QT drill-down in release 1.12.0, Visit view: the X-axis control and visit names on the axis.
  1. The X-axis control, opening on Visit.

Before: “Study Day” over the visit numbers 0, 2, 4, 6, 8, 12, 16, 20, 24, 26. After, in Study day view, the same ECGs fall on days 1, 14, 27, 42, 54, 83, 111, 139, 172, 180.

After · Study day view
The QT drill-down in Study day view, the last ECG at day 180.

On the demo's ECG data no participant has two visits on one study day, so the two views differ here only in spacing. The design's case of several ECGs on one day, apart by visit and stacked by day, is not in this data.

Try it
  1. Open the QT explorer demo and click a point.The side panel opens on Visit.
  2. Press Study day in the panel.The ECGs move to their study days.
05 / hep-explorer

hep-explorer: step by visit or by study day, and timing in days

The eDISH scatter. The slider under it now steps by visit or by study day, chosen with a control labelled "Step by". The 30-day timing test always measures study days.

Before · release 1.11.3
hep-explorer's scatter in release 1.11.3: every point filled, and a slider from 0 to 13.
After · release 1.12.0 (dev site)
hep-explorer's scatter in release 1.12.0: 131 of 318 points hollow, the slider in study days, and the Step by control with Study day pressed.
  1. A hollow point: this participant's peak ALT and peak bilirubin are more than 30 days apart.
  2. The footnote says what filled means.
  3. The Step by control: Visit | Study day, opening on Study day.

On the demo data 131 of 318 participants are hollow, read from the points as drawn. Before: 0 of 318, because the test measured visit numbers, which are never 30 apart. The old slider ran from 0 to 13, visit numbers, under the name "Study day".

After · Step by Visit
The playback bar stepping by visit, from Baseline to Week 26.

Step by Visit: the slider runs from Baseline to Week 26. By study day it runs from day -38 to day 200.

Try it
  1. Open the hep-explorer demo and choose eDISH / mDISH scatter.Some points are hollow; the footnote says why.
  2. Under the chart, press Visit beside "Step by", then play.The points step through the visits by name.
06 / no time axis

With neither a visit nor a study day, a message

The gallery's data has both, so this is shown in a small harness page: the gallery's own demo data with its visit and study-day columns taken out, loaded into the dev site's bundle and into release 1.11.3's.

Before · release 1.11.3, harness
The outlier explorer in release 1.11.3 on data with no visit and no study day: lines drawn over an axis titled Measurement.
After · release 1.12.0 (dev site), harness
The outlier explorer in release 1.12.0 on the same data: in place of the chart, the message This data has no visit or study day, so there is no time axis to plot.
  1. In place of the chart: “This data has no visit or study day, so there is no time axis to plot.”

The outlier explorer. The participant profile shows the same message (read, not shown). Before, the profile drew an empty axis titled “Study Day”. Open the harness: release 1.12.0, release 1.11.3.

07 / hep-explorer, no study day

hep-explorer with no study day: crosses, and a footnote

With visits but no study day, the timing test cannot be run. Every point is drawn as a cross, neither filled nor hollow, and the chart says why. Shown in the harness: the gallery's demo data with its study-day column taken out.

Before · release 1.11.3, harness
hep-explorer in release 1.11.3 on data with no study day: all 318 points filled.
After · release 1.12.0 (dev site), harness
hep-explorer in release 1.12.0 on the same data: every point a cross, a tooltip reading Timing not evaluated (no study day), the footnote saying timing was not evaluated, and Study day greyed beside Step by.
  1. A point's tooltip: “Timing not evaluated (no study day)”.
  2. The footnote: “Timing was not evaluated: the data has no study day, so each point is drawn as a cross, neither filled (peak ALT and peak TB within 30 days of each other) nor hollow.”
  3. Step by: Study day greyed, titled “No study day in this data”.

All 318 points are crosses, and the timing-window input (Highlight Points Based on Timing) is disabled. Before, release 1.11.3 drew all 318 filled, as if each had passed a test it never ran. Open the harness: release 1.12.0, release 1.11.3.

08 / the demo app

The demo app passes the toggle and remembers the view

The demo app's charts are given the same X-axis setting, built from the columns mapped on the Data tab. Each chart remembers the view you last chose while the page is open; a new page opens on each chart's own default.

Before · release 1.11.3
The demo app's outlier explorer in release 1.11.3: no X-axis control, an axis titled Measurement.
After · release 1.12.0 (dev site)
The demo app's outlier explorer in release 1.12.0, after Study day was chosen, the Histogram opened, and the Outlier Explorer opened again: Study day is still pressed.
  1. Study day, still chosen after leaving the chart and coming back.

The Outlier Explorer opens on Visit. The capture pressed Study day, opened the Histogram, and came back: the chart was still on Study day. Clicking a participant then opened the side panel on Study day, with its own toggle.

Try it
  1. Open the demo app, choose Outlier Explorer and press Study day.The axis is in days.
  2. Choose Histogram, then Outlier Explorer again.Study day is still chosen. Reload the page, and it opens on Visit.
09 / changed defaults

Four charts read the study day from DY by default

The histogram, outlier explorer, shift plot and delta-delta now look for the study day in a column called DY when they are not told otherwise. The outlier explorer also looks for the visit in VISIT and VISITNUM, so given no time setting it offers both views and opens on Visit. A page that names its own study-day column is unaffected; a page whose data has a DY column it did not mean as a study day should set it to none. The release notes say so.

Whatrelease 1.11.3release 1.12.0 (dev site)
Study-day column, given no settinghistogram: none, outlier: none, shift: none, delta: nonehistogram: DY, outlier: DY, shift: DY, delta: DY
An outlier explorer given no time settingplots a “Measurement” sequenceoffers Visit | Study day, reading VISITNUM and VISIT for the visit, and opens on “Visit”
Shift-plot listing columnsParticipant ID, Baseline, Comparison, Change, Percent ChangeParticipant ID, Visit, Study day, Baseline, Comparison, Change, Percent Change
Shift-plot listing, data with no study daynot readParticipant ID, Visit, Baseline, Comparison, Change, Percent Change: no Study day column
Delta-delta tooltip, participant 01-701-1028Participant: 01-701-1028
Change in Alanine Aminotransferase: +0.00
Change in Aspartate Aminotransferase: +0.00
Participant: 01-701-1028
Change in Alanine Aminotransferase: +0.00
Change in Aspartate Aminotransferase: +0.00
Visit: Baseline → Week 26
Study day: -8 → 180

The first two rows were read in the harness, each chart mounted with no settings beyond its measures (release 1.12.0, release 1.11.3); the fourth on the gallery data without its DY column (harness). The others were read on the gallery pages.

Before · release 1.11.3
The shift-plot listing for 01-701-1028 in release 1.11.3, with no Study day column.
After · release 1.12.0 (dev site)
The shift-plot listing in release 1.12.0, with Visit reading Baseline → Week 26 and Study day reading -8 → 180.
  1. Study day: “-8 → 180”, beside Visit: “Baseline → Week 26”.

The shift plot, Baseline against Week 26, participant 01-701-1028 selected. Delta-delta's tooltip now adds “Study day: -8 → 180” under “Visit: Baseline → Week 26”.

10 / decided in the build
Calls made while building, for the reviewer
  • The AE explorer and AE timelines side panels have no X-axis toggle. They show adverse events only, which are drawn in days, so they open on Study day. A Visit option there would have nothing to draw. The requirement's definition of done asked for an X-axis control in all eight hosts; six have one. Whether they should take one is split out for later. (safety.viz pull request #379) (the AE panels’ toggle, safety.viz #385)
  • The baseline flag (baseline_col) is not forwarded to the side panels of the histogram, outlier explorer, shift plot and delta-delta in this release; it is split out for later. (safety.viz #386)
  • hep-explorer's control is labelled "Step by", not "X-axis": the scatter's own axes are ALT and bilirubin, and the control changes only what the slider steps through. Points whose timing was not evaluated are drawn as crosses, and the timing-window input is disabled. (safety.viz pull request #381)
Noticed while capturing
  • The data pull request says participant 01-701-1028's last ALT on the profile demo moved from 13 to 180. On the gallery's participant profile page, release 1.11.3 put it at 183, a day worked out from the visit name. The 13, a visit number, is what the side panels plotted. (safety.viz pull request #378)
  • Switching the outlier explorer's main axis clears the selected participant and closes the side panel.
  • Not captured here: the Visit and Study day columns added to the hep-explorer and hep-waterfall listings (safety.viz #377), and the gsm.safety widgets, which follow in their own release (hub #438).
11 / where to check it

The requirements

  • The objective: firm up the tools for the ISG relaunch (hub #429).
  • Both visit and study day in the demo data (hub #435).
  • One x-axis toggle between Visit and Study day (hub #436).
  • hep-explorer's slider and 30-day timing in study days (hub #437).
  • The design, approved 11 November (the x-axis toggle design).

The tasks and pull requests

  • Demo data: the visit, study day and baseline flag (#365); the synthetic cohorts' days and one visit numbering (#366); the baseline rule reads the flag (#367). Pull request (#378).
  • The toggle: one setting and control (#368); the profile (#369); the side panels (#370); the outlier explorer (#371); the QT drill-down (#372); the demo app (#373); axis names on the charts without it (#374). Pull request (#379).
  • hep-explorer: the slider (#375); timing on study days only (#376); both columns in the liver listings (#377). Pull request (#381).
  • Release preparation (#380), pull request (#382); the release notes; the release candidate (pull request #383); what its review found (#384), fixed in pull request (#387).