Direct Answer
The Historical Chart and Visualization Library defines the chart families, data standards, and verification policy that govern how quantitative data is presented across the 50 Swoopr market-history case studies. No numeric value appears in a chart unless its source URL, unit, observation date, and reviewer are recorded. Until that record is complete, pages display a verification-pending state rather than an invented or estimated figure.
Historical Chart & Visualization Library
This page documents the chart framework that applies to all 50 historical case studies in the Market History library. It explains the seven shared chart families, the provenance standard that governs when a quantitative series can be published, and how the existing interactive tools implement these standards today. Use this page as the reference when interpreting what a verification-pending notice means on a case-study chart slot, or when comparing how the same chart family is applied across different episode types.
Chart Standards
Every chart in the library must answer a specific question. Required elements for any published chart are: a clear title stating the question being answered; benchmark or series name; units; observation period with start and end dates; source with a verifiable URL; methodology note explaining any transformations; an accessible data table containing the same values as the visual; and a short interpretation stating what the chart does and does not prove.
No chart may present a hindsight observation as if it were contemporaneously available. The chart's title and interpretation must reflect what an investor at the time could have observed, with post-event findings labeled as such. No chart may imply that past performance predicts future results or that a historical pattern is a strategy recommendation.
Seven Chart Families
The library uses seven shared chart families. Each family is defined by the question it answers, not by its visual form. The same data may appear as a line, a small-multiple grid, or a bar depending on what best communicates the comparison being made.
1. Indexed performance and drawdown path
Shows the level of an asset price or index, rebased to 100 at a reference date, alongside a drawdown series showing percent below the prior peak at each point in time. Answers the question: how did the price level evolve from before the crisis through recovery, and how deep and long was the worst drawdown? Used for equity indexes, bond-price series, and commodity spot prices. Requires: ticker or series identifier, total-return or price-only distinction, currency, rebase date, and dividend or coupon treatment.
2. Interest-rate and yield path
Shows the level of a policy rate, government-bond yield, or interbank rate over the episode period. Answers the question: how did borrowing costs move during and after the crisis, and what was the policy response? Used for central-bank rate decisions, yield-curve shape changes, and tightening or easing cycles. Requires: rate name, central bank or market source, annualization convention, and whether the rate is nominal or real.
3. Inflation and unemployment path
Shows consumer price inflation and unemployment rate on a shared timeline or dual-axis chart. Answers the question: did the episode produce stagflation, deflation, or a standard recession pattern? Used for episodes where the macro regime is central to the investor outcome. Requires: price index name, CPI or PCE distinction, seasonally adjusted status, and unemployment rate definition (U-3, U-6, or national equivalent).
4. Currency and commodity price path
Shows an exchange rate or commodity spot price indexed to the crisis onset date. Answers the question: how did the foreign-exchange rate or commodity price respond to the episode's supply, demand, and policy changes? Used for currency crises, oil shocks, and metal or agricultural commodity disruptions. Requires: currency pair or commodity grade, exchange or pricing venue, and unit of measure.
5. Credit-spread and funding-stress path
Shows the spread between a risky yield and a risk-free benchmark, or an interbank-to-policy-rate spread such as the TED spread. Answers the question: when did credit stress begin to register in market prices, and how did it resolve? Used for banking crises, sovereign debt episodes, and corporate-credit events. Requires: spread definition, both legs named, data source, and whether the spread is option-adjusted.
6. Recovery-clock comparison
Shows the five recovery clocks side by side for a single episode: market-price recovery, real and total-return recovery, economic recovery (real GDP), labor-market recovery, and balance-sheet recovery. Answers the question: which dimension of the crisis resolved first and which lasted longest? For most episodes in this library, quantitative recovery dates for the slower clocks are under source verification and appear as pending rather than estimated. The Drawdown and Recovery Explorer implements the recovery-clock framework interactively.
7. Before, during, and after small multiples
Shows three snapshots of the same metric at three points in time: a pre-crisis reference period, the crisis trough or peak, and a post-crisis recovery period. Answers the question: how different were conditions at each stage, and is the post-crisis state genuinely restored or merely stabilized? Used for comparing balance-sheet ratios, valuation multiples, and policy-rate levels across phases of an episode.
Data Verification Policy
A quantitative series cannot move from verification-gated to publishable until its record contains all of the following: canonical source URL; source title and publisher; series identifier where applicable; unit of measure; reporting frequency; observation dates for at least beginning, trough or peak, and end; transformation formula if the published value differs from the raw series; return convention (total-return vs. price-only; annualized vs. cumulative); currency; retrieval or review date; and the name of the reviewer who confirmed the values against the source interface.
A verification-pending notice on a chart slot means the editorial team has identified which series is needed and from which source, but has not yet completed the spot-check of actual values. The structural chart framework and the written analysis on the surrounding page are complete. The chart itself will appear when the provenance record passes review.
This standard exists because a chart that displays an invented or proxy value while appearing authoritative is more misleading than an honest placeholder. Exact measurements are not backfilled with modern proxies unless an explicit methodology note accompanies the substitution and explains its limitations.
Interactive Tools
Six tools implement the visualization framework today using editorial-supported data. These tools do not require chart-level source verification because they are structural or editorial rather than quantitative claim-making:
- Crisis Timeline filters all 50 events by era, category, and geography. Answers: which events occurred in a given period, category, or region?
- Crisis Comparison Engine places two events side by side across structural conditions, transmission channels, and recovery paths. Answers: how did two episodes differ in mechanism?
- Drawdown and Recovery Explorer calculates the required gain from any drawdown percentage using the formula d / (1 minus d) and shows the five recovery clocks with their verification status. Answers: what gain is needed to break even from a given loss?
- Signal vs. Hindsight Library separates, for each of the 50 events, what was observable to a contemporaneous investor from what became clear only afterward. Answers: what could an investor actually have known before the crisis resolved?
- Anatomy of a Crisis shows the cause stack and contagion-map for each episode. Answers: what were the root causes, how did stress spread, and what feedback loops formed?
- Crisis Replay recreates the monthly portfolio choices during a selected episode, presenting contemporaneous information only, not outcomes known afterward. Answers: what would you have done with the information available at the time?
Two additional pages aggregate editorial-supported data across all 50 events without quantitative chart claims: the Winners and Losers explorer shows the investor lens by crisis category, and the Signal vs. Hindsight Library lets you filter the full corpus by signal type.
Case Studies and Chart Requirements
Each of the 50 case studies in the market-history library has a defined set of required charts. Every event requires three chart types: an event-path chart showing the build-up, break, transmission, policy response, and recovery; a signal-vs-hindsight chart separating contemporaneous signals from later findings; and a recovery-clock chart comparing the five recovery dimensions for that episode.
The event-path and recovery-clock charts require verified source data before they publish. The signal-vs-hindsight chart is editorially supported and publishes immediately. The machine-readable chart requirements for all 50 events are available at /data/chart-requirements-master.json for reference.
| Chart type | Data requirement | Current status |
|---|---|---|
| Event-path (indexed performance or rate path) | Source URL, series identifier, unit, dates, reviewer | Verification in progress for all 50 events |
| Signal vs. hindsight (editorial classification) | Editorial review of contemporaneous sources | Editorial data available; interactive tool live at signal-vs-hindsight |
| Recovery-clock comparison | Source URL, series identifier, unit, dates, reviewer for each clock | Verification in progress; framework live at drawdown-recovery-explorer |
Frequently Asked Questions
What chart families does the historical visualization library use?
The library uses seven shared chart families: indexed performance and drawdown path; interest-rate and yield path; inflation and unemployment path; currency and commodity price path; credit-spread and funding-stress path; recovery-clock comparison; and before, during, and after small multiples. Each family is chosen to answer a specific question about an episode rather than to display data for its own sake. Every chart requires a clear title, benchmark or series name, unit, observation period, source, methodology note, an accessible table or data summary, and a short interpretation.
Why are quantitative chart values shown as verification-pending on many pages?
A quantitative series cannot move from verification-gated to publishable until its record contains: canonical source URL; source title and publisher; series identifier where applicable; unit; frequency; observation dates; transformation formula; return convention; currency; retrieved and reviewed date; and reviewer identity. Spot-check of beginning, peak or trough, and end observations against the source interface is also required. This standard exists because publishing an inaccurate number dressed as a chart is more misleading than an honest verification-pending placeholder.
What interactive tools are available for exploring historical crises?
Six interactive tools cover the historical corpus: the Crisis Timeline filters 50 events by era, category, and geography; the Crisis Comparison Engine places two events side by side on structural conditions, transmission channels, and recovery paths; the Drawdown and Recovery Explorer calculates the required gain from any drawdown percentage and shows the five recovery clocks; the Signal vs. Hindsight Library separates what was observable before each event from what became clear only afterward; the Anatomy of a Crisis shows the cause stack and contagion map for each episode; and the Crisis Replay simulator recreates monthly portfolio choices during a selected event.
What is the Signal vs. Hindsight separation rule?
Every chart and written analysis must maintain a clear separation between evidence that was observable to a contemporaneous investor and explanations that became available only after the event. A chart's title, axis labels, and interpretation text must not present hindsight knowledge as if it were a contemporaneous signal. The Signal vs. Hindsight Library at /market-history/signal-vs-hindsight/ applies this separation systematically across all 50 events, listing observable signals separately from hindsight-only findings for each episode.