Home Developers Capabilities Ogee spillway

CVP verified calculation capability

Ogee spillway Calculation Capability

USBR high-overflow ogee Q from crest L, head H, and design head Hd. Not thin-plate weir, not broad-crested weir, not sluice, not Manning, not Q=Av.

Physics · Fluid Capability ID physics.fluid.ogee_spillway version 1.0.0 CVP VERIFIED CURRENT Engineering

Model

Discharge

Modes: flow · head

Inputs / Outputs

Canonical symbols for this capability. Agent schemas remain the contract.

SymbolQuantityUnitRole
LCrest length in m—input / output
HUpstream head above the crest in m—input / output
HdDesign head in m—input / output
QVolume flow in m³/s—input / output
POptional spillway height in m—input / output
C——output
model——output

Assumptions / Validity

Declared scope for this capability. Do not use it outside this domain.

Assumptions

Not supported

Example

One numerical check. The calculator page holds worked steps and FAQ.

L=1 H=1 Hd=1 → Q≈2.19731

Open this example in the calculator

Trust

CVP VERIFIED · CVP protocol 1.0.0-proposed · Engineering assurance · USBR high-overflow ogee Q_cfs=C L_ft H_ft^{3/2} with C=3.98 (H/Hd)^{0.12}, + O3 mpmath tabulated Q.. Computational verification is defined by CVP. Supplemental domain review (internal) and named expert review are defined by the Review policy and do not by themselves determine CVP conformance.

CVP
CVP VERIFIED · CVP protocol 1.0.0-proposed · Engineering assurance · USBR high-overflow ogee Q_cfs=C L_ft H_ft^{3/2} with C=3.98 (H/Hd)^{0.12}, + O3 mpmath tabulated Q.· View Manifest · CVP overview · Specification
Verified scope
USBR high-overflow ogee Q_cfs=C L_ft H_ft^{3/2} with C=3.98 (H/Hd)^{0.12}, + O3 mpmath tabulated Q.
Assurance
Engineering
Declared partition coverage
PASS · 5/5 declared partitions (flow, alias, awkward, tall, invalid-domain)
Deferred
Not thin-plate (2/3)Cd, not broad-crested, not sluice, not Manning, not submerged, not Q=Av.
Calculation version
1.0.0
Verification
6/6 calculation tests · 1/1 legacy golden · 0/0 legacy boundary · 5/5 legacy property
Production surface contract
6/6
Versions
Calculation 1.0.0 · CVP protocol 1.0.0-proposed · Evidence 2026-09-26.o2-o3
Verification revision
2026-09-26.o2-o3 · 1/1 property · digest c52bed685698
Reference
O1 model · O3 expected_values · O3 numerical_behavior · O2 expected_values · O2 numerical_behavior
Numerical scope
O2: USBR high-overflow ogee vs a separate-module identity (≤2 ULP). Not thin-plate, not broad-crested, not sluice, not Manning, and not Q=Av. ≤2 ULP vs O3 applies only to the published tabulated ogee vectors. Not thin-plate, not broad-crested, not sluice, not Manning, and not Q=Av.
Interfaces
PASS · UI (SSR) / REST / MCP
ui-ssr is query-result HTML, not a live browser session. Error-path engine·REST·MCP 1/1 (status, code, calculation_version). SSR compared on URL-canonical requested calculations; empty query is idle (not an error) and JSON-typed object/array inputs are REST/MCP-only.
CVP suite
4/4 golden · 1/1 CVP boundary · 3/3 invalid · 1/1 property · 1/1 metamorphic · 8/8 O3 · 2/2 cross-interface · 6/6 CVP contract
Supplemental domain review
Not performed
Named expert review
Not performed
Version lock
Supported (409 VERSION_MISMATCH)
Artifact consistency
Build verified · 1.0.0 (workspace artifacts agree)
Review-policy tier
Engine tested — catalog token engine_tested; supplemental; not CVP status
This calculator CURRENT · Public schema 1.0.0 matches · Semantic contract ✓ · Production attested · Public/cache ✓ · Origin ✓

Call this capability

Human page, REST, and MCP share the same engine and calculation_version. Build verified hashes workspace artifacts only. After deploy, attest:production GETs canonical URLs twice — the public/cached view an Agent actually hits, and origin — including every /capabilities/{id} HTML page. Public Capability HTML version must match catalog before production attestation passes. Live Trust rows above fetch /.well-known/calculatorx-production-attestation.json and the output schema const. Build hashes: release integrity. That proves currently published page / engine / schema / evidence / MCP agree — not that a historical version is independently immutable. Reference Calculation Standard — Production surface contract 6/6.

curl -sS -X POST 'https://www.calculatorx.com/api/v1/calc/ogee-spillway' \
  -H 'Content-Type: application/json' \
  -d '{"inputs":{"L":1,"H":1,"Hd":1,"P":2},"calculation_version":"1.0.0"}'

POST /api/v1/calc/ogee-spillway. This is a POST calculate endpoint — do not GET it.

Full REST contract: REST API docs.

Tool id
ogee-spillway
Engine
ogee-spillway
REST
POST /api/v1/calc/ogee-spillway
MCP
execute_calculation with capability_id: "physics.fluid.ogee_spillway"
Agent input schema
Canonical (MCP / Agent)
Output schema
JSON Schema (latest)
Versioned input schema
Immutable pin (1.0.0)
Versioned output schema
Immutable pin (1.0.0)

References

Human-readable sources plus CVP reference evidence classes.

Sources

Reference evidence classes: O1 model · O3 expected_values · O3 numerical_behavior · O2 expected_values · O2 numerical_behavior

Try with an agent

Inspect, then execute. Same engine as REST and the human calculator.

curl -sS -X POST 'https://www.calculatorx.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/call' \
  -H 'Mcp-Name: inspect_capability' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"inspect_capability","arguments":{"capability_id":"physics.fluid.ogee_spillway"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"calculatorx-docs-example","version":"1.0.0"},"io.modelcontextprotocol/clientCapabilities":{}}}}'

Pin calculation_version (1.0.0) when the result must stay reproducible.

Inspect the trust tier and required assurance level before execution. Full protocol notes: MCP docs.