Weir Flow API

Weir flow maths for open-channel discharge measurement as an API, computed locally and deterministically. The rectangular endpoint computes the flow over a rectangular sharp-crested weir, Q = (2/3)·Cd·b·√(2g)·H^1.5, from the crest width and the head of water above the crest — and solves the head back from a known discharge. The vnotch endpoint computes the flow over a triangular V-notch weir, Q = (8/15)·Cd·√(2g)·tan(θ/2)·H^2.5, from the notch angle and head, the most accurate weir for small flows because the discharge varies with the head to the power 2.5. The broadcrested endpoint computes the flow over a broad-crested weir, Q = Cd·(2/3)^1.5·√g·b·H^1.5 ≈ Cd·1.705·b·H^1.5, the rugged field structure used for river gauging. Each device carries its standard discharge coefficient (rectangular 0.62, V-notch 0.58, broad-crested 0.85) which you can override, and each solves either the discharge from a measured head or the head required for a target discharge. Everything is computed locally and deterministically, so it is instant and private. Ideal for hydrology, irrigation and civil-engineering tools, flow gauging in channels and treatment plants, stormwater and water-resource apps, and fluid-mechanics education. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is weir overflow discharge; for uniform open-channel flow use a Manning API and for differential-pressure pipe metering use an orifice API.