This section describes the data sources, models, and assumptions behind the analysis presented in each dashboard.
pvmt.toml.The exact sources and endpoints used for a given example are listed in that example's Config tab.
Each road classification decays independently via
PCI(t) = PCI₀ · exp(−k · t)
where k is an annual decay constant that depends on the road
classification. Higher-class roads (motorway, trunk, primary) decay more
slowly than lower-class roads (residential, service) because they are
built to thicker, more rigorous design standards and typically receive
more frequent maintenance. Default values are derived from LTPP data
reported in FHWA-RD-01-156, Long-Term Pavement Performance and
ship as part of the forecast package; they are continental-US
averages and do not account for local climate, traffic, or
construction quality. A config may set a per-city decay_rate to tune
for local conditions (e.g. freeze/thaw or road salt); that override is
applied as the rate for a typical road and scales every road class
proportionally, so the per-class ordering (higher classes decay slower)
is preserved rather than flattened. Sidewalks
decay on a separate, slower track and are not treated as a highway class.
Treatment costs are banded by PCI: each band has a representative
$/sq m value, and costs between bands are linearly interpolated at the
tier midpoints, so the cost-versus-PCI curve is smooth rather than
step-shaped. Above the highest anchor (the midpoint of the preventive
tier) and below the lowest anchor (the midpoint of the reconstruction
tier), the cost is clamped to that anchor's value rather than
extrapolated. Default cost tiers are expressed in $/sq m and sourced
from FHWA treatment-selection guidance; they are calibration inputs, not
measurements, and local bid prices will differ. Roads and sidewalks use
independent cost tiers because the treatment economics differ
substantially.
PVMT ships with three comparison runs driven by annual funding level, all using the worst-first allocation strategy (budget is spent on the lowest-PCI segments first):
A do-nothing baseline (no spend, uncontrolled decay) is shown alongside the funded runs for comparison.
The forecast library also implements a preventive-first strategy (prioritize highest-PCI segments that are still in the preservation window), but the default UI comparisons do not exercise it. Preventive vs. worst-first allocation is governed by per-strategy efficiency multipliers; those multipliers are illustrative calibration constants chosen to reflect the direction and sign of the effect reported in FHWA-HIF-12-042, Pavement Preservation: Preserving our Investment — that $1 of preventive maintenance is reported to avoid $6–$10 of future reconstruction — not to reproduce that benefit-cost ratio as a single-year spending efficiency.
Optional compound annual growth applies to pavement area each year:
Area(y) = Area₀ · (1 + g)^y
where g is configured per city (default zero). This lets an example
model a city that is still expanding its street network; it does not
model demolition or removal.
The dashboard's Financials headline and the cross-city leaderboard report three solvency figures. They are computed on the roads/streets cohort only — the aggregate scenarios blend roads, parking, and sidewalks but cost the blend at road tiers, which would mis-price sidewalks, so an absolute dollar claim must be roads-only. They are derived from a worst-first run at the city's configured annual budget.
Insolvency year — the first forecast year in which the cumulative deferred backlog reaches one full year of network-treatment need (the year-1 need: the cost to treat the entire network once). Because the deferred backlog is a monotonically non-decreasing accumulator (see below), once a city is a whole network-treatment behind it does not recover within the model, so this is the "unrecoverable" threshold. A city whose backlog never reaches it is reported as solvent through the horizon. This is deliberately not "the first year need exceeds spend": year-1 need is the cost to treat the entire network, far above any real budget, so that test trips in year 1 for virtually every city and cannot distinguish a slightly-underfunded city from a badly- underfunded one. Reported only when a current budget is configured.
Hold-steady (break-even) budget — the smallest constant annual budget whose final deferred backlog is within a small relative tolerance (a fraction of year-1 need) of zero. Found by bisection over budget; the search's upper bound is the peak do-nothing annual need over the horizon, which is sufficient to fully fund every year.
Funding gap — (break-even − current budget) / current budget,
the primary cross-city ranking metric. Negative when a city already
budgets at or above its hold-steady level. Reported only when a current
budget is configured.
Three caveats apply to these figures specifically:
annual_spend series can exceed the configured budget. The
allocator routes leftover budget on a fully-funded cohort into extra
PCI recovery (a surplus branch), and that extra is counted as spend.
So an annual_spend above current_budget in early years is expected,
not an error.cost_tiers curve that violates this could make
the bisection overstate the break-even budget — a conservative
direction (it never understates the gap).docs/architecture.md
for the ingest and compute pipeline.# Greater Boston, MA — northeast metro with harsh winters
#
# Boston and its inner-ring neighbors share a severe freeze/thaw + road
# salt climate that accelerates pavement deterioration, so this config
# raises decay_rate and supplies a three-tier reconstruct/rehab/preventive
# cost schedule. The compact, dense cities (Cambridge, Somerville) drop to
# a finer hex grid for higher-resolution analysis.
#
# Techniques demonstrated:
# - Climate-tuned decay_rate (0.065) for salt + freeze/thaw.
# - Custom three-tier forecast cost schedule.
# - Per-city hex_edge_m overrides (60 m for compact Cambridge/Somerville).
#
# Overpass-only. Expect ~8 Nominatim + Overpass pulls for `pvmt all ingest`.
config_id = "greater-boston-ma"
[grid]
hex_edge_m = 100
[forecast]
decay_rate = 0.065
years = 15
[export]
title = "Greater Boston Pavement Analysis"
[[forecast.cost_tiers]]
min_pci = 0
max_pci = 40
cost_per_sqm = 175.0
label = "Reconstruct"
[[forecast.cost_tiers]]
min_pci = 40
max_pci = 70
cost_per_sqm = 90.0
label = "Rehabilitate"
[[forecast.cost_tiers]]
min_pci = 70
max_pci = 100
cost_per_sqm = 20.0
label = "Preventive"
[[cities]]
name = "Boston, MA"
#@cite Roadway Reconstruction & Resurfacing annual program, FY25-26 planned (capital + grant sources)
#@cite https://www.boston.gov/sites/default/files/file/2025/11/Streets%20Cabinet%20Capital.pdf (accessed 2026-06-14)
forecast.current_budget = 24000000.0
overpass = true
[[cities]]
name = "Cambridge, MA"
overpass = true
hex_edge_m = 60 # compact, dense — finer grid
[[cities]]
name = "Somerville, MA"
overpass = true
hex_edge_m = 60 # densest city in New England — finer grid
[[cities]]
name = "Quincy, MA"
overpass = true
[[cities]]
name = "Newton, MA"
#@cite Citywide overall PCI 73.3, Apr 2025 Mayor's Newton Update
#@cite https://www.newtonma.gov/home/showpublisheddocument/128379/638799968675100000 (accessed 2026-06-14)
forecast.initial_pci = 73
#@cite $95M/10yr Accelerated Pavement Mgmt Program = $9.5M/yr
#@cite https://www.apwa.org/resource/newton-ma-accelerated-pavement-management-program-how-public-works-made-it-happen/ (accessed 2026-06-14)
forecast.current_budget = 9500000.0
overpass = true
[[cities]]
name = "Medford, MA"
overpass = true
[[cities]]
name = "Malden, MA"
overpass = true
[[cities]]
name = "Waltham, MA"
overpass = true
[grid]
hex_edge_m = 100.0
[display]
units = "imperial"
min_hex_area = 100.0
[export]
title = "Greater Boston Pavement Analysis"
coordinate_decimals = 0
[forecast]
initial_pci = 85.0
decay_rate = 0.065
growth_rate = 0.0
years = 15
[[forecast.cost_tiers]]
min_pci = 0.0
max_pci = 40.0
cost_per_sqm = 175.0
label = "Reconstruct"
[[forecast.cost_tiers]]
min_pci = 40.0
max_pci = 70.0
cost_per_sqm = 90.0
label = "Rehabilitate"
[[forecast.cost_tiers]]
min_pci = 70.0
max_pci = 100.0
cost_per_sqm = 20.0
label = "Preventive"
[[cities]]
name = "Boston, MA"
overpass = true
arcgis_url = ""
hex_edge_m = 0.0
boundary_relation_id = 0
allow_private_arcgis = false
[cities.forecast]
initial_pci = 0.0
decay_rate = 0.0
growth_rate = 0.0
years = 0
current_budget = 2.4e+07
[[cities]]
name = "Cambridge, MA"
overpass = true
arcgis_url = ""
hex_edge_m = 60.0
boundary_relation_id = 0
allow_private_arcgis = false
[[cities]]
name = "Somerville, MA"
overpass = true
arcgis_url = ""
hex_edge_m = 60.0
boundary_relation_id = 0
allow_private_arcgis = false
[[cities]]
name = "Quincy, MA"
overpass = true
arcgis_url = ""
hex_edge_m = 0.0
boundary_relation_id = 0
allow_private_arcgis = false
[[cities]]
name = "Newton, MA"
overpass = true
arcgis_url = ""
hex_edge_m = 0.0
boundary_relation_id = 0
allow_private_arcgis = false
[cities.forecast]
initial_pci = 73.0
decay_rate = 0.0
growth_rate = 0.0
years = 0
current_budget = 9.5e+06
[[cities]]
name = "Medford, MA"
overpass = true
arcgis_url = ""
hex_edge_m = 0.0
boundary_relation_id = 0
allow_private_arcgis = false
[[cities]]
name = "Malden, MA"
overpass = true
arcgis_url = ""
hex_edge_m = 0.0
boundary_relation_id = 0
allow_private_arcgis = false
[[cities]]
name = "Waltham, MA"
overpass = true
arcgis_url = ""
hex_edge_m = 0.0
boundary_relation_id = 0
allow_private_arcgis = false