Wood Supply Simulation System (WS4)
Welcome to the Wood Supply Simulation System (ws4) documentation. WS4 is an
open-source, command-line-first forest estate model that treats space as first-class:
fragments are the decision units, blocks aggregate them at runtime, and adjacency, patch
structure, and road access are enforced inside simulation and optimization rather than
allocated after the fact.
Who Is This Documentation For?
New users — forest planners, students, and land managers running a first wood supply simulation. Start with Getting started.
Analysts and planners — people building scenarios, targeting even flow or patch size distributions, routing products to mills, accounting for carbon, or repeating and scaling runs. See How-to guides and Guides.
Researchers and policy analysts — people asking what the model assumes, where the evidence lives, and what a result does not claim. Start with Concepts, Carbon accounting and planning, and Limitations and boundaries.
Instructors and students — people learning forest estate modelling from a runnable, inspectable example. Start with Your first model and the Examples.
LLM coding agents — assistants that read and edit this repository. Follow
AGENTS.md,docs/llms.txt, and Reference for the contracts, invariants, and conventions to respect.