Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,11 @@ heading here; `tests/test_repo_hygiene.py` asserts that they do.

## [Unreleased]

### OBR page: fiscal rules view and conventions

- **Fiscal rules on `/obr`.** A new "Against the fiscal rules" section sets the October 2026 EFO path for the current budget (Table 6.5) and public sector net financial liabilities (derived from Table 6.14) beside what the model books for the four worked examples (`results/demo_shocks.json` at obr-macroeconomic-model `0e44ec8`). Only the spending example moves the public finances; the section says it is not a rule readout. No existing figure changes.
- **Conventions on `/obr/methodology`.** Step 2 gains a table of the OBR conventions the emulator inherits as EFO Table 1.9 input paths, imposes through an opt-in overlay, or does not reproduce.

### Model re-pin and site review (#278, #279)

- **#278: model pins.** OBR `2965e82d` → `0e44ec87` (main after obr-macroeconomic-model #74 and #75), BoE SVAR `c13a9c91` → `c827ab86`, FRB/US `846eeb5c` → `162cfe6a`, US HANK `551a40d3` → `58353e5f`. After a redeploy the hosted tools run these pins. The FRB/US and US HANK compare rows with stored paths re-run identically; the OBR rows were re-run at `0e44ec8`.
Expand Down
2 changes: 1 addition & 1 deletion DESIGN.md
Original file line number Diff line number Diff line change
Expand Up @@ -742,7 +742,7 @@ row (entry cards or chips): the next tab, `/models#compare`, and `/connect` for

| Tab | Layout | Must carry |
|---|---|---|
| Overview | lede (one sentence: what it answers) → `#verdict` strip (§4.14) → `#fit` good for / not for → `#answers` "What it returns": worked examples behind a scenario switch, stat tiles + sparkline (home of those figures) → `#pe-bridge` the join as a pipeline, one line, and the page's **one** caveat callout → `section#card` model card, collapsed (§4.13) → chip row. No StepPanel, no "About this step" expanders. | link to `/models#compose`, Validation caveats; every other caveat lives on Validation |
| Overview | lede (one sentence: what it answers) → `#verdict` strip (§4.14) → `#fit` good for / not for → `#answers` "What it returns": worked examples behind a scenario switch, stat tiles + sparkline (home of those figures) → on `/obr` only, `#fiscal-rules`: the EFO path table, the examples table and one sources expander → `#pe-bridge` the join as a pipeline, one line, and the page's **one** caveat callout → `section#card` model card, collapsed (§4.13) → chip row. No StepPanel, no "About this step" expanders. | link to `/models#compose`, Validation caveats; every other caveat lives on Validation |
| Methodology | StepPanel, one step per model block; panel = equations (`.meth-eq`) | the model's source paper citation (link to Paper tab) |
| Validation | stat row (the headline fit numbers: their home) + trust card (§4.13) → StepPanel of the tests (OBR is the reference) → limits card (`#caveats`, every failure statement in full, as `.limits` groups of `details.expander.limit` rows with a visible `h3` per group; r3) → "On this page" rail ≥ 1100 px | the verdict, every known limit, links to the code that produced each number |
| Code | `.scrolly-code` StepPanel: install → run → reproduce; panel = commands | `/connect` for hosted use, repo paths |
Expand Down
43 changes: 43 additions & 0 deletions obr/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -157,6 +157,49 @@ <h3 class="scen-title">Corporation tax main rate up 5 points</h3>
</div>
</section>

<section id="fiscal-rules" class="band ov-rules">
<div class="band-head" data-icon="scale"><h2>Against the fiscal rules</h2>
<p class="section-intro">The October 2026 EFO path for the two rules, beside what the model books for the four examples above. Not a rule test: the examples end in 2027Q4, before the target year.</p></div>
<ul class="scen-points rules-points">
<li><strong>Stability rule</strong>: the current budget (day-to-day spending and depreciation against receipts) in surplus in 2029-30</li>
<li><strong>Investment rule</strong>: public sector net financial liabilities (PSNFL, financial liabilities less financial assets) falling as a share of GDP by 2029-30</li>
<li><strong>Headroom</strong> is the margin by which a rule is met in its target year. The table is our reading of the committed tables, not the OBR&rsquo;s published headroom</li>
</ul>
<div class="table-scroll rules-table"><table data-stack="no">
<caption>The EFO path, October 2026. 2029-30 is the year the Charter names; the current budget is in deficit in 2028-29, so the reading depends on the year tested</caption>
<thead><tr><th scope="col">Financial year</th><th scope="col">2026-27</th><th scope="col">2027-28</th><th scope="col">2028-29</th><th scope="col">2029-30</th><th scope="col">2030-31</th><th scope="col">2031-32</th></tr></thead>
<tbody>
<tr><th scope="row">Current budget, &pound;bn (surplus +)</th><td>&minus;40.6</td><td>&minus;17.5</td><td>&minus;7.8</td><td><strong>+14.5</strong></td><td>+21.7</td><td>+20.9</td></tr>
<tr><th scope="row">PSNFL, % of GDP (derived)</th><td>83.3</td><td>83.7</td><td>83.5</td><td><strong>82.6</strong></td><td>81.6</td><td>80.9</td></tr>
<tr><th scope="row">PSNFL change, pp of GDP (derived)</th><td>+1.34</td><td>+0.39</td><td>&minus;0.20</td><td><strong>&minus;0.86</strong></td><td>&minus;0.98</td><td>&minus;0.74</td></tr>
</tbody>
</table></div>
<div class="table-scroll rules-table"><table data-stack="yes">
<caption>What the model books for each example in its third year (2027, four quarters summed)</caption>
<thead><tr><th scope="col">Example</th><th scope="col">Receipts</th><th scope="col">Current spending</th><th scope="col">Net borrowing</th><th scope="col">What is and is not counted</th></tr></thead>
<tbody>
<tr><th scope="row">Spending up &pound;1.25bn a quarter</th><td>no change</td><td>+&pound;5.7bn</td><td>+&pound;5.7bn</td><td>The cash cost only; receipts do not respond to the higher GDP</td></tr>
<tr><th scope="row">1p on the basic rate</th><td>no change</td><td>no change</td><td>no change</td><td>The &pound;6.55bn a year costing is the microsimulation&rsquo;s input; it enters as lower household income, not as model receipts</td></tr>
<tr><th scope="row">Bank Rate up 1 point</th><td>no change</td><td>no change</td><td>no change</td><td>Debt interest is an input. Checked on the four-quarter run; the sustained run records no fiscal lines</td></tr>
<tr><th scope="row">Corporation tax up 5 points</th><td>no change</td><td>no change</td><td>no change</td><td>The rate moves the cost of capital; no receipts are booked</td></tr>
</tbody>
</table></div>
<p class="scen-note"><span class="chip chip-warn">Not a rule readout</span> Only the spending example moves the public finances in the model, by its cash cost, so it lowers the current budget by &pound;5.7bn in 2027. The hosted <code>obr_shock</code> returns none of these lines, and no run reaches 2029-30.</p>
<details class="xp">
<summary><span class="xp-ic"><svg class="i" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M3 12h.01"/><path d="M3 18h.01"/><path d="M3 6h.01"/><path d="M8 12h13"/><path d="M8 18h13"/><path d="M8 6h13"/></svg></span><span class="xp-t"><strong>The rules and the sources</strong><small>Charter wording, table derivations, what is missing</small></span><span class="xp-chev" aria-hidden="true"></span></summary>
<div class="xp-body">
<ul>
<li><strong>Source of the rules</strong>: HM Treasury, <a href="https://obr.uk/about-the-obr/legislation-and-related-material/"><em>Charter for Budget Responsibility: autumn 2025</em></a> (February 2026), paragraphs 3.6 and 3.7. The Charter calls them the fiscal mandate and a supplementary target; stability rule and investment rule are the names in common use.</li>
<li><strong>Target year</strong>: 2029-30, until 2029-30 becomes the third year of the forecast period; after that, the third year of the rolling forecast. The Charter text does not say which applies to an October 2026 forecast, so the table shows every year.</li>
<li><strong>Current budget</strong>: the &ldquo;Current budget deficit&rdquo; row of Table 6.5 with the sign reversed, from the <a href="https://github.com/PolicyEngine/obr-macroeconomic-model/blob/0e44ec87681eba0a1f61d634875f5431ac2344c8/obr_macro/_data/obr_efo_october_2026_aggregates.xlsx">October 2026 EFO aggregates workbook</a> in the model repository.</li>
<li><strong>PSNFL</strong>: not printed in the committed workbooks. Derived from Table 6.14 as minus (net worth less non-financial assets less unfunded pension liabilities). This is our subtraction, in percentage points of GDP only; no &pound;bn headroom is given.</li>
<li><strong>Examples</strong>: the <code>PSCR</code> (receipts), <code>PSCE</code> (current spending) and <code>PSNBNSA</code> (net borrowing) changes in <a href="https://github.com/PolicyEngine/obr-macroeconomic-model/blob/0e44ec87681eba0a1f61d634875f5431ac2344c8/results/demo_shocks.json"><code>results/demo_shocks.json</code></a>, rows <code>cgg</code>, <code>household_costing</code>, <code>bank_rate</code> and <code>corporation_tax_rate</code>. The current budget is receipts less current spending less depreciation.</li>
<li><strong>Missing</strong>: the OBR&rsquo;s own headroom figures, a model run to 2029-30 that records the current budget, and any response of receipts or debt interest to the economy (<a href="/obr/validation#caveats">limits</a>).</li>
</ul>
</div>
</details>
</section>

<section id="proof" class="band ov-proof">
<div class="band-head" data-icon="shield"><h2>How far to trust it</h2>
<p class="section-intro">Three checks, weakest included; each opens its evidence.</p></div>
Expand Down
32 changes: 32 additions & 0 deletions obr/methodology/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -160,6 +160,38 @@ <h4>Why it matters</h4>
<p>The snapshot ships inside the package, so there is no download step. It gives the circular fiscal and financial sub-blocks real balancing data rather than guessed starting values.</p>

</div>
</details>
<details class="xp" id="conventions">
<summary><span class="xp-ic"><svg class="i" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M3 12h.01"/><path d="M3 18h.01"/><path d="M3 6h.01"/><path d="M8 12h13"/><path d="M8 18h13"/><path d="M8 6h13"/></svg></span><span class="xp-t"><strong>OBR conventions: inherited, opt-in or absent</strong><small>Market paths, oil and gas, sterling, multipliers, judgement</small></span><span class="xp-chev" aria-hidden="true"></span></summary>
<div class="xp-body">
<p>A convention is a rule the OBR applies outside its equations, such as taking interest rates from financial markets. The emulator handles each in one of three ways.</p>
<ul>
<li><strong>Inherited</strong>: read as a fixed input path from the EFO&rsquo;s Table 1.9, &ldquo;Market-derived assumptions&rdquo;. The emulator applies no rule of its own.</li>
<li><strong>Opt-in overlay</strong>: imposed by a labelled switch on the model&rsquo;s <code>run_reform</code>, off by default.</li>
<li><strong>Absent</strong>: not reproduced, or loaded but used by no equation.</li>
</ul>
<div class="table-scroll"><table data-stack="yes">
<caption>OBR conventions and the emulator, October 2026 EFO, model pin 0e44ec8</caption>
<thead><tr><th scope="col">Convention</th><th scope="col">In the emulator</th><th scope="col">Status</th></tr></thead>
<tbody>
<tr><th scope="row">Bank Rate and gilt yields from market curves</th><td>Table 1.9 paths for Bank Rate (<code>R</code>) and the 20-year gilt yield (<code>RL</code>). No curve is built, and neither responds to a fiscal shock</td><td><span class="chip">inherited</span></td></tr>
<tr><th scope="row">Mortgage and deposit rates</th><td>Table 1.9 paths (<code>RMORT</code>, <code>RDEP</code>). <code>monetary_conditioning</code> moves the mortgage rate with Bank Rate (<a href="/obr/validation#bank-rate">Bank Rate limits</a>); the deposit rate, gilt yields, sterling and house prices stay fixed</td><td><span class="chip">inherited</span> <span class="chip">opt-in overlay</span></td></tr>
<tr><th scope="row">Oil price from futures</th><td>Table 1.9 path (<code>PBRENT</code>). Its note: Brent spot for outturn, ICE Brent futures over the forecast window</td><td><span class="chip">inherited</span></td></tr>
<tr><th scope="row">Gas price from futures</th><td>Table 1.9 path, loaded as <code>PGAS</code> but used by no equation in the listing, so it has no effect. Its note: one-month-forward gas price expectations averaged over the forecast window</td><td><span class="chip">absent</span></td></tr>
<tr><th scope="row">Exchange rate held flat</th><td>Table 1.9 path (<code>RX</code>): the sterling index is constant at 85.7 from 2026Q4 to 2032Q1. Sterling moves trade prices only, never volumes</td><td><span class="chip">inherited</span></td></tr>
<tr><th scope="row">Fiscal multipliers imposed by judgement, fading to zero over five years</th><td><code>published_conventions</code> imposes the OBR&rsquo;s impact multipliers on government consumption and investment (<a href="/obr/validation#multiplier">multiplier</a>, <a href="/obr/validation#capital">capital spending</a>). The straight-line fade between the two published points is our choice</td><td><span class="chip">opt-in overlay</span></td></tr>
<tr><th scope="row">Indirect taxes passed through to prices</th><td><code>price_passthrough</code>, for VAT and fuel duty shocks (<a href="/obr/validation#vat">VAT limits</a>)</td><td><span class="chip">opt-in overlay</span></td></tr>
<tr><th scope="row">Multiplier fade dated from the announcement</th><td>The fade starts at the shock start; the emulator has no announcement date</td><td><span class="chip">absent</span></td></tr>
<tr><th scope="row">Quarter-by-quarter forecast judgement</th><td>Recent add-factors are averaged and held flat (<a href="/obr/validation#caveats">limits</a>)</td><td><span class="chip">absent</span></td></tr>
<tr><th scope="row">Fresh market data between EFOs</th><td>The paths are those of the pinned EFO; no curve date or averaging window is applied or updated</td><td><span class="chip">absent</span></td></tr>
</tbody>
</table></div>
<ul>
<li><strong>Hosted tools</strong>: <code>obr_shock</code> exposes <code>price_passthrough</code> only. <code>published_conventions</code> and <code>monetary_conditioning</code> need the model package.</li>
<li><strong>What Table 1.9 shows and does not</strong>: it gives the paths and their sources, not the date or window the OBR sampled. Those are in the EFO text, which is not in the repository.</li>
<li><strong>Sources</strong>: Table 1.9 of the <a href="https://github.com/PolicyEngine/obr-macroeconomic-model/blob/0e44ec87681eba0a1f61d634875f5431ac2344c8/obr_macro/_data/obr_efo_october_2026_economy.xlsx">October 2026 EFO economy workbook</a>; <a href="https://github.com/PolicyEngine/obr-macroeconomic-model/blob/0e44ec87681eba0a1f61d634875f5431ac2344c8/obr_macro/published_conventions.py"><code>published_conventions.py</code></a>; <a href="https://github.com/PolicyEngine/obr-macroeconomic-model/blob/0e44ec87681eba0a1f61d634875f5431ac2344c8/docs/monetary_conditioning.md"><code>monetary_conditioning.md</code></a>; finding G14 of the <a href="https://github.com/PolicyEngine/obr-macroeconomic-model/blob/0e44ec87681eba0a1f61d634875f5431ac2344c8/docs/published_model_review.md">published-model review</a>.</li>
</ul>
</div>
</details>
</div>

Expand Down