Harvested wood product lifecycle
FEMIC owns the public HWP parameter set and the producer-side provenance. WS4 owns the run-time product ledger. This page explains the assumptions, the equations, and the boundary between the two repositories.
The parameter file is config/carbon/hwp.bc.yaml. It is a scenario input, not a
calibrated estimate of the single true half-life or displacement factor. A study should
run a range over plausible values and report the range.
Public assumptions
The default file records the corrected public accounting used in the UBC-FRESH forest-sector carbon work:
utilization rate: 0.85 of merchantable carbon becomes utilized product;
utilized fibre split: 50% paper, 50% solid wood;
paper half-life: 2 years;
solid-wood half-life: a scenario parameter (the public config uses 100 years as a representative value);
solid-wood displacement factor: a scenario parameter (the public config uses 1.0 tC avoided per tC product);
paper displacement factor: 0 tC avoided per tC product;
decay convention: exact per-period survival
2 ** (-period_length / half_life);end-of-life convention: product decay is emitted to the atmosphere.
The full scenario grid in the public fresh-yan records varies solid-wood half-life and
displacement factor. The thesis and fresh-yan are the method references; the config
file is the stable input surface.
Accounting
For one period, WS4 reads the merchantable carbon that a disturbance transfers to the product pool and computes:
inflow = merchantable carbon transferred × utilization_rate
solid_in = inflow × proportion_solid_wood
paper_in = inflow × (1 - proportion_solid_wood)
solid_t = solid_{t-1} × survival_solid + solid_in
paper_t = paper_{t-1} × survival_paper + paper_in
survival = 2 ** (-period_length / half_life)
decay = solid_{t-1} × (1 - survival_solid)
+ paper_{t-1} × (1 - survival_paper)
displacement = (solid_in × df_solid + paper_in × df_paper) × credit
system = ecosystem + solid_t + paper_t
net emission = (ecosystem_{t-1} - ecosystem_t)
+ (HWP_{t-1} - HWP_t)
- displacement
The carbon terms are in tC and are converted to tCO2e with 44/12. The identity
telescopes to ecosystem_start - ecosystem_end - HWP_end - sum(displacement), so the
product transfer is counted once and HWP decay is not double-counted as a second
ecosystem emission.
What the model does not represent
Landfill and inert long-lived product pools are not separate pools in this first version; product decay is immediate end-of-life emission.
The paper/solid split is a public scenario assumption, not a mill-level product allocation.
Displacement is a credit on product inflow. It is not a market model and does not establish that the displaced material would otherwise have been produced.
The HWP parameters are uncertain. A single run is a scenario, not a confidence interval.
Run it in WS4
WS4 consumes the same public config:
ws4 carbon \
--dataset output/ws4/tsa24/compiled \
--package output/carbon/tsa24 \
--schedule schedules/baseline.csv \
--hwp-config config/carbon/hwp.bc.yaml \
--out out/carbon/tsa24-hwp
ws4 optimize \
--dataset output/ws4/tsa24/compiled \
--targets targets/tsa24-system.yaml \
--carbon-package output/carbon/tsa24 \
--carbon-hwp config/carbon/hwp.bc.yaml \
--out out/ws4/tsa24-system-search
The run adds product, end-of-life, displacement, and whole-system accounts to
carbon_accounts.csv. Examples of system targets are carbon.system.total (maximum
stock) and carbon.co2e.system.emissions.cumulative (minimum net emissions). See the
WS4 docs/reference/carbon page for the full account list.
Curve relationship
The HWP ledger is separate from the carbon yield curves. The curves supply ecosystem and merchantable-carbon trajectories per track; the HWP ledger turns the harvest inflow into product pools and emissions. WS4 can compile both from the same package and dataset, but the exact optimizer path remains the block-level libcbm ledger.