Skip to content

Citation pills

Every claim in Lab — a drug effect, a clearance route, a coupling, a condition modifier — carries a small pill that links it to its evidence.

Color legend

  • Green — literature citation (peer-reviewed source)
  • Blue — calibration (engine-tuned value with owner + last-reviewed date)
  • Red ⚠ — uncited (no source attached yet)

The same color language is used everywhere pills appear: the intervention inspector, the signal inspector, the meter inspector. If you remember the colors, you don't have to relearn each surface.

What the colors mean for trust

  • A row with only green pills → the magnitude is anchored in published literature.
  • A row with blue pills → the magnitude is a Lab calibration. The direction of the effect is usually still cited (the green pills next to the blue tell you so), but the exact number is engine-tuned to make the simulation behave realistically.
  • A row with red ⚠ → no source is on file yet. Treat the value as a working estimate. Lab tracks every red pill; they shrink over time as we wrap them.

Activity-style interventions (sleep, meditation, social, exercise) are inherently calibration-class — there's no clinical PD endpoint for "sleep raises growth hormone by 8 engine units" — so expect blue pills with green companions on those rows.

Hover any pill

Hovering a pill pops up:

  • The source title + authors + year (or for calibrations: the rationale + owner + last-reviewed date)
  • The "supports" line — what specifically this paper backs at this use site
  • The registry key
  • A jump hint

Click any pill

Clicking a pill auto-opens the References list at the bottom of the inspector and scrolls to the matching numbered entry, briefly flashing it. From there you can open the citation in the Bibliography for the full source card.

Stack behavior

When multiple sources back the same claim, pills stack with a slight overlap so the row stays compact. Hovering any pill in the stack lifts it forward; the stack itself doesn't fan apart. Sources are deduplicated — a single paper anchored from multiple wrappers on the same effect appears as one pill, not two.

The References list

At the very bottom of every inspector view sits a References section. It's collapsed by default — the row content is the headline; the bibliography is supporting detail you reach for when you need it.

  • Open it from the chevron, or click any pill above to auto-expand
  • Numbered entries match the pill numbers on the rows above
  • Citations are clickable → opens the full Bibliography card with DOI / PubMed links
  • Calibrations show rationale + owner + last-reviewed date

Order in the inspector view is intentional: row content first, then PK/PD detail sections, then the unified References list at the bottom.

Help docs for Protokol Tracker and Protokol Lab.