Reservoir-Flux Network¶
Core Idea¶
A reservoir-flux network decomposes a system into named reservoirs (stocks, compartments, pools) linked by fluxes (flows, transfer rates) under a conservation closure that holds the total content invariant except across a declared boundary. The closure is the discriminating feature — it is what separates the pattern from a bare graph and from a single isolated flow, and what makes mass-balance bookkeeping calculable.
How would you explain it like I'm…
Buckets and Pipes
Tanks That Never Leak
Stocks, Flows, and Conservation
Broad Use¶
- Biogeochemistry: the carbon cycle as atmosphere/ocean/biosphere/soil reservoirs linked by photosynthesis and respiration, total carbon conserved.
- Pharmacokinetics: compartmental PK/PD models with first-order rate constants and elimination, drug mass conserved minus clearance.
- Epidemiology: SIR/SEIR partition a population into Susceptible/Infected/Recovered reservoirs with conserved total.
- Macroeconomics: flow-of-funds and sectoral balances conserved by double-entry bookkeeping.
- System dynamics: the entire Forrester stock-and-flow discipline of stocks, rates, and equations.
- Ecology and hydrology: trophic energy budgets and watershed water balances under thermodynamic or hydrological closure.
Clarity¶
Separates a flow (one directed channel), a network (graph topology, silent on conservation), and a reservoir-flux network (graph plus stocks plus closure), and makes the closure boundary an explicit modelling choice whose misplacement a failed conservation check flags.
Manages Complexity¶
Compresses an arbitrarily complicated multi-substance system into a short specification — how many reservoirs, what fluxes, what rate laws, what total — from which steady states, residence times, and shock propagation follow, with conservation as an auditable identity.
Abstract Reasoning¶
The dynamics are coupled rate equations (each reservoir's change equals inflows minus outflows); steady states solve a linear system, perturbation response follows the Jacobian's eigenstructure, and looped topologies can oscillate where feed-forward ones relax monotonically.
Knowledge Transfer¶
- Pharmacokinetics → epidemiology: one- and two-compartment dosing solutions carry over to SIR-family models, both linear reservoir-flux networks.
- Macroeconomics → ecology: the sectoral-balance identity ("one sector's surplus is another's deficit") is the same closure that yields trophic energy budgets.
- System dynamics → climate/inventory: the "bathtub" result (a stock rises even as inflow levels off) transfers to atmospheric carbon and to backorders.
Example¶
The two-compartment PK model — central and peripheral compartments with rate constants k12, k21, and elimination k10 — makes the mass-balance identity numerically explicit: total drug equals both compartments plus what was eliminated, equal to the dose, and a failed balance points straight at a forgotten elimination flux.
Relationships to Other Abstractions¶
Current abstraction Reservoir-Flux Network Prime
Parents (1) — more general patterns this builds on
-
Reservoir-Flux Network presupposes Conservation Laws Prime
A Reservoir-Flux Network presupposes a conservation law that closes internal transfers over its declared boundary.
Children (6) — more specific cases that build on this
-
Biogeochemical Cycle Domain-specific is a kind of Reservoir-Flux Network
A biogeochemical cycle is the Earth-system specialization of a conserved reservoir-flux network, fixing the reservoirs and transformations to planetary bio-geo-chemical ones.
-
Lake ecosystem Domain-specific is a kind of Reservoir-Flux Network
The proposed strict upward parent is
prime:reservoir_flux_network. -
Ventricle (heart) Domain-specific is a kind of Reservoir-Flux Network
The proposed strict upward parent is
prime:reservoir_flux_network. -
WAFLEX Domain-specific is a kind of Reservoir-Flux Network
WAFLEX strictly specializes Reservoir-Flux Network.
-
Source-Sink Role Prime presupposes Reservoir-Flux Network
Assigning a source or sink role requires a bounded stock-flow account linking the component to a reference reservoir.
- Network Prime decompose Reservoir-Flux Network
Network is the framed or domain-specific realization of Reservoir-Flux Network; removing the local frame leaves the parent's structural relation intact.
Hierarchy path (1) — routes to 1 parentless root
- Reservoir-Flux Network → Conservation Laws → Invariance
Not to Be Confused With¶
- Reservoir-Flux Network is not a bare Network because it adds stocks and a conservation closure that license mass-balance reasoning, whereas a bare network carries only connectivity.
- Reservoir-Flux Network is not Turnover because turnover (and residence time) is one derived rate read off the structure, whereas the prime is the whole conserved system.
- Reservoir-Flux Network is not Equilibrium because the prime is the structure whose dynamics may or may not reach a resting state, whereas equilibrium is that state itself.