What was checked and how it came out, what was found wrong and fixed, and the files and commands that rebuild every figure.
"Pass" means the check ran and met its stated criterion. "Bounded" means the question stays open but a test brackets how much it can move the answer. "Stated" means a limit is named and not tested. "Open" means the evidence disagrees or is missing.
| Status | Check | Result | Part |
|---|---|---|---|
| pass | Road model on bus services it was not fitted to | Whole services held out, five folds: 18% error in running time, against 30% for a distance-only model fitted the same way (171,838 live LTA arrival estimates, 10:00–13:00) | 1 |
| pass | Road model at other hours | Scored without refitting on 13:00–14:59: observed ÷ predicted 1.00 | 1 |
| pass | Observed bus GPS movement | Chained positions of the same bus, about 5 minutes apart: observed ÷ modelled time 0.99 at midday (3,355 pairs). Same feed and day as the fit, but observed positions, not LTA's estimates | 1 |
| open | Evening peak road speeds | The measures disagree: LTA's estimates imply buses 1.10× slower than the midday model, bus GPS shows 1.02× (95 % interval 0.98–1.07). A sensitivity case applies the evening calibration all day | 1 |
| open | Morning peak road speeds | Not observed: live data were collected 10:00–15:00 and 17:30–19:30. The capacity threshold is set in the morning rush | 1 |
| pass | Road network against LTA's route distances | 268 consecutive stop pairs: routed ÷ published distance has a median of 1.02 (IQR 0.95–1.09); segments off by more than 40 % are left out of the calibration | 1 |
| pass | Demand months agree | July and August 2026 within 0.1 % per weekday; September 3.5 % lower, as its school-holiday week predicts | 1 |
| pass | Dispatch kernel against brute force | Same optimal cost as an explicit enumeration of every insertion on 400 random schedules | 1 |
| pass | Simulator invariants | Exact times on a grid, capacity never exceeded, continuous legs, kilometres that add up, berth limits held; randomized fleets, capacities and demand (tests/test_sim.py) | 1 |
| pass | Fleet search assumptions | The bisection assumes more vehicles never hurt: 126 evaluated fleets checked, no violations | 1 |
| bounded | Assumptions behind the fleet | Across 18 alternative assumptions, pushing both ways, the all-day 10-seat fleet ranges 375–550 (base 450). See the chart below | 1 |
| pass | Same riders in every option | Ride counts, rides without a bus option and today's passenger-hours are identical across options on every simulated day | 2 |
| pass | Rule C uses only what is known in advance | Eligibility comes from the published timetable before anyone travels; tripling the simulated bus waits leaves the set of offered rides unchanged (tests/test_phase2.py) | 2 |
| pass | Results rebuild from the committed runs | The summary, the page data and the results tables equal a fresh build from the run files (tests/test_phase2_outputs.py); every grid ran on a clean, committed tree | 2 |
| bounded | Bus times on the rides C selects | C targets exactly the pairs where the modelled bus is slow, so model error there is selected for. If bus times on those rides were 20 % too high, the saving of C (θ 8 min with 175 shuttles) would fall from 6,729 to 3,911 passenger-hours a day. Checking those rides against GPS or tap-out times is the most important missing evidence | 2 |
| bounded | Cost inputs | Every one of 36 cost parameters has a low, central and high value from a register of 247 sourced rows; one-at-a-time swings and joint low and high cases are reported (chart below) | 2 |
Smallest fixed fleet of 10-seat shuttles that keeps up with the bus in every hour on all three simulated days, when one assumption changes. The base case is the vertical line; fleets are searched on a 25-vehicle grid.
Cost per passenger-hour saved when one cost parameter moves to its low or high value, the others central, for each staffing case, as a change from that case's central value. One axis for all three, so bar lengths compare.
These static charts are drawn with matplotlib by python -m yishun.phase2.charts from data/processed/phase2/summary.json, the same file the interactive charts read. They show the whole data set where the study page shows the headline, so a figure here can be checked against a point on the page. Select a chart to open it at full size.







Part 2 was reviewed by a reviewer who had not built it, who read the code and outputs, recomputed costs by hand, rebuilt the summary and re-ran a recorded simulation. Every result on the study page comes from the runs made after these fixes.
| Status | Finding | What was done |
|---|---|---|
| fixed | R1 · material. The bus model boarded riders at the first visit of a stop on a line. Feeder 812 is a figure of eight through Yishun Interchange, so a rider for its second loop was timed riding the first loop as well: today's bus times were too long on exactly the rides the combined service selects. | Riders board at whichever visit gives the shortest ride, tested on a figure-of-eight line and checked against brute force on every real line that revisits a stop. Model, both parts' experiments and every table re-run. |
| fixed | R2 · material. "The combined service buys time more cheaply than any full replacement" holds only with every bus kept. | The claim is qualified, and full replacement with the internal-only services withdrawn is reported with its cost per hour saved. |
| fixed | R3 · material. The stress tests compared two service designs: full replacement accepted 45-minute pickups with no bus to fall back on, the combined service declined after 15 minutes and the rider took the bus. | Every stress now also runs full replacement under the combined service's rule; the base row uses the same three days as the stress rows; "realistic kerb limits" became test values. |
| stated | R4. No rider times their arrival with live bus information. | Added to the limits; the reviewer's first-order estimate is that savings fall by about a fifth if only bus riders did. |
| stated | R5. No relief or spare staff; unlimited kerb in the base case. | Added to the limits; a 10–15 % relief factor would add about 4–7 % to on-board costs without changing the ranking. |
| fixed | R6. The full bus cost per bus-km may count LTA's assets twice. | Avoidable bus cost reported at the full cost and at the operator fee only. |
| fixed | R7. LTA's route, service and stop files were not pinned. | Committed with checksums; make data restores them. |
| fixed | R8. Report statements stronger than the outputs, one of them wrong (4-seat vehicles are also cheaper per hour with an operator on board). | Report rewritten from the re-run results. |
| fixed | R9. Defects in generated tables and charts (blank subzone names, an axis showing 7,500 as "8k"). | Fixed in the generators. |
The review in full: docs/phase2/review.md. Part 1's own red-team reviews and their fixes: docs/validation.md.
| Limit | Flatters | How it is handled |
|---|---|---|
| Morning-peak road speeds not observed | uncertain | Evening-peak calibration all day as a sensitivity case |
| No congestion feedback: added shuttles slow nothing | shuttles | Speed stresses (slower roads; shuttles 25 % slower) bound it; not a congestion model |
| Unlimited kerb space in the base case | shuttles, most of all full replacement | Kerb limits of 10 and 7 shuttles per station tested (test values) |
| Demand fixed: no riders attracted by faster trips, no fare effects | uncertain | Stated; time savings never counted as revenue |
| Bus crowding and denied boarding not modelled | buses | Stated; the combined service's relief of crowded buses is not counted |
| Riders do not time their arrival with live bus information | shuttles | Stated in Part 2; Part 1 tests arrival-app riders |
| Simple dispatcher with exact travel times | buses (a better dispatcher needs fewer vehicles) | Wider dispatcher searches tested: 375–400 vehicles instead of 450 |
| A fixed fleet in service all day | buses (raises shuttle cost) | Hourly fleet needs reported as lower bounds |
| Remote supervision without anyone on board is not permitted today | shuttles, in the remote cases | Three staffing cases reported separately, today's requirement first |
| Vehicle prices without COE and registration taxes | shuttles, most of all 4-seat vehicles | Stated; listed as evidence needed |
Every limit of Part 2, with its treatment: docs/phase2/limits.md.
Raw LTA files are not redistributed, except the three static bus files the results depend on. Everything derived is in the repository.
| File | What is in it | Format |
|---|---|---|
| results.json | Part 1: every figure, curve and table on the study page, with the provenance of the experiments | JSON |
| phase2.json | Part 2: every configuration's time, cost and service, per staffing and cost case | JSON |
| summary.json | Part 2: the full summary the page and report are built from | JSON |
| phase2/<grid>/runs.parquet | Part 2: one row per simulated day (510 in all, stress tests included), with hourly and group tables beside it | Parquet |
| internal_od_202607_202608.csv.gz | Observed demand: average-weekday rides between every pair of Yishun stops by hour | CSV |
| calibration.json | Fitted road speed, signal delay, bus dwell and headway regularity, with bootstrap intervals | JSON |
| gps_check.json | Observed bus GPS movement against the model | JSON |
| cost_cases.json · cost_register.csv | Part 2 cost parameters (low, central, high) and the 247 sources behind them | JSON, CSV |
| lta/ · osm/ | Pinned LTA bus stops, services and routes, and the OpenStreetMap extract, with checksums | xz |
| Dataset | Provider | Used for | Licence |
|---|---|---|---|
| Passenger Volume by Origin Destination Bus Stops (July, August, September 2026) | LTA DataMall | Observed demand; who uses Yishun's buses | Singapore Open Data Licence v1.0 |
| Bus Stops, Bus Services, Bus Routes; live Bus Arrival (v3) | LTA DataMall | Bus network; calibration; GPS check | Singapore Open Data Licence v1.0 |
| HDB Property Information; HDB Existing Building | HDB via data.gov.sg | Block heights and footprints | Singapore Open Data Licence v1.0 |
| Master Plan 2019 planning areas, subzones, land use | URA via data.gov.sg | Study area; base map | Singapore Open Data Licence v1.0 |
| Census of Population 2020, residents by subzone and age | SingStat via data.gov.sg | Age profile | Singapore Open Data Licence v1.0 |
| Roads, signals, buildings, rail | OpenStreetMap contributors | Road network; context | ODbL 1.0 |
With a free LTA DataMall key in LTA_DATAMALL_KEY. The live bus data of 15 October 2026 cannot be downloaded again, so the calibration fitted on it is committed and used; DataMall serves fare-card months for three months only, so the Yishun OD table is committed too.
make setup # Python 3.12 environment, pinned packages make data # LTA, data.gov.sg; restores the pinned OSM and LTA bus files make reproduce-core-results # Part 1: experiments, sensitivity, page data, tests (about 2.5 h on 4 cores) make phase2-allocation # Part 2: who uses Yishun's bus-km (needs the July and August OD files) make phase2-experiments # Part 2: options A, B and C on shared simulated days (about 1.5 h) make phase2-results # Part 2: summary, page data, report charts and results tables make web && make serve # this site at http://localhost:8000