{
  "capability_id": "physics.fluid.hydraulic_jump",
  "tool_id": "hydraulic-jump",
  "engine": "hydraulic-jump",
  "calculation_version": "1.0.0",
  "generated_at": "2026-09-17T08:49:50.939Z",
  "engine_build": "2026-09-17",
  "test_count": 17,
  "passed": 17,
  "failed": 0,
  "tests_summary": {
    "golden": {
      "total": 2,
      "passed": 2
    },
    "boundary": {
      "total": 10,
      "passed": 10
    },
    "property": {
      "total": 5,
      "passed": 5
    }
  },
  "engine_tested": true,
  "expert_reviewed": false,
  "internally_reviewed": false,
  "review_kind": null,
  "source_checked": true,
  "reviewed_by": null,
  "reviewer_role": null,
  "last_reviewed": null,
  "expert_review": {
    "status": "optional_not_performed",
    "reviewer": null,
    "scope": [
      "formula",
      "input semantics",
      "assumptions",
      "limitations",
      "sources",
      "tests"
    ],
    "note": "Domain expert review is optional under CVP (CVP-EXP-01). Absence does not block CVP Verified. See Review policy for supplemental domain assurance."
  },
  "internal_review": {
    "status": "not_applicable",
    "reviewer": null
  },
  "page": "https://www.calculatorx.com/calc/physics/hydraulic-jump",
  "api": "https://www.calculatorx.com/api/v1/calc/hydraulic-jump",
  "schema_input": "https://www.calculatorx.com/schemas/physics.fluid.hydraulic_jump.input.json",
  "schema_output": "https://www.calculatorx.com/schemas/physics.fluid.hydraulic_jump.output.json",
  "assumptions": [
    "Rectangular hydraulic jump: y2/y1 = (√(1+8 Fr₁²) − 1)/2; Fr₁ > 1",
    "ΔE = (y2 − y1)³ / (4 y1 y2); Fr₂ = Fr₁ / (y2/y1)^{3/2}",
    "Not a Froude wrap, not Manning, not Chezy, not a weir, not Q=Av"
  ],
  "limitations": [
    "Rectangular hydraulic jump: y2/y1 = (√(1+8 Fr₁²) − 1)/2; Fr₁ > 1",
    "ΔE = (y2 − y1)³ / (4 y1 y2); Fr₂ = Fr₁ / (y2/y1)^{3/2}",
    "Not a Froude wrap, not Manning, not Chezy, not a weir, not Q=Av"
  ],
  "boundary_conditions": [
    "missing y₁, Fr, or v when required → MISSING_REQUIRED_INPUT",
    "Fr₁ ≤ 1 → VALUE_OUT_OF_RANGE",
    "y, Fr, v, or g ≤ 0 → VALUE_MUST_BE_POSITIVE",
    "Re/ρ/μ, We/σ, n, A/Q, L, H/C_d → MIXED_INPUT_ENCODING",
    "froude, manning, or weir as mode → INVALID_MODE"
  ],
  "sources": [
    {
      "title": "ISO 80000-11 — Characteristic numbers",
      "section": "Froude number Fr",
      "supports": "Fr = v / √(l g) used as Fr₁ in the sequent-depth relation",
      "kind": "standard"
    },
    {
      "title": "Chow, V.T. Open-Channel Hydraulics",
      "section": "Hydraulic jump",
      "supports": "Bélanger sequent depths and ΔE = (y2 − y1)³ / (4 y1 y2) for a rectangular jump",
      "kind": "reference"
    }
  ],
  "methods": [],
  "fingerprint": "sha256:abbd973162745910af65ab983225e0061f8c9bcf5ea59239e954426a3755269e",
  "tests": [
    {
      "id": "golden-hj-fr",
      "ok": true,
      "kind": "golden",
      "inputs": {
        "y1": 1,
        "Fr": 2
      },
      "expect": {
        "y1": 1,
        "y2": 2.3722813232690143,
        "Fr1": 2,
        "mode": "sequent",
        "model": "hydraulic_jump"
      },
      "expectWarning": null,
      "actual": {
        "mode": "sequent",
        "y1": 1,
        "y2": 2.3722813232690143,
        "Fr1": 2,
        "Fr2": 0.5473696470780532,
        "v1": 6.2631142413339385,
        "v2": 2.640122897693828,
        "dE": 0.27233488537882894,
        "g": 9.80665,
        "model": "hydraulic_jump"
      },
      "tol": 1e-12
    },
    {
      "id": "golden-hj-v",
      "ok": true,
      "kind": "golden",
      "inputs": {
        "y1": 1,
        "v": 6.2631142413339385
      },
      "expect": {
        "y2": 2.3722813232690143,
        "Fr1": 2,
        "model": "hydraulic_jump"
      },
      "expectWarning": null,
      "actual": {
        "mode": "sequent",
        "y1": 1,
        "y2": 2.3722813232690143,
        "Fr1": 2,
        "Fr2": 0.5473696470780532,
        "v1": 6.2631142413339385,
        "v2": 2.640122897693828,
        "dE": 0.27233488537882894,
        "g": 9.80665,
        "model": "hydraulic_jump"
      },
      "tol": 1e-12
    },
    {
      "id": "boundary-hj-y1",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "mode": "upstream",
        "y2": 2.3722813232690143,
        "Fr": 2
      },
      "expect": {
        "y1": 1,
        "model": "hydraulic_jump"
      },
      "expectWarning": null,
      "actual": {
        "mode": "upstream",
        "y1": 1,
        "y2": 2.3722813232690143,
        "Fr1": 2,
        "Fr2": 0.5473696470780532,
        "v1": 6.2631142413339385,
        "v2": 2.640122897693828,
        "dE": 0.27233488537882894,
        "g": 9.80665,
        "model": "hydraulic_jump"
      },
      "tol": 1e-12
    },
    {
      "id": "boundary-hj-dE",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "mode": "energy",
        "y1": 1,
        "y2": 2.3722813232690143
      },
      "expect": {
        "dE": 0.27233488537882894,
        "model": "hydraulic_jump"
      },
      "expectWarning": null,
      "actual": {
        "mode": "energy",
        "y1": 1,
        "y2": 2.3722813232690143,
        "Fr1": 2,
        "Fr2": 0.5473696470780532,
        "v1": 6.2631142413339385,
        "v2": 2.640122897693828,
        "dE": 0.27233488537882894,
        "g": 9.80665,
        "model": "hydraulic_jump"
      },
      "tol": 1e-12
    },
    {
      "id": "boundary-hj-missing",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "y1": 1
      },
      "expectError": "MISSING_REQUIRED_INPUT",
      "code": "MISSING_REQUIRED_INPUT",
      "error": "Fr or v is required"
    },
    {
      "id": "boundary-hj-fr1",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "y1": 1,
        "Fr": 1
      },
      "expectError": "VALUE_OUT_OF_RANGE",
      "code": "VALUE_OUT_OF_RANGE",
      "error": "Hydraulic jump needs supercritical Fr > 1"
    },
    {
      "id": "boundary-hj-fr05",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "y1": 1,
        "Fr": 0.5
      },
      "expectError": "VALUE_OUT_OF_RANGE",
      "code": "VALUE_OUT_OF_RANGE",
      "error": "Hydraulic jump needs supercritical Fr > 1"
    },
    {
      "id": "boundary-hj-Re",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "y1": 1,
        "Fr": 2,
        "Re": 200000
      },
      "expectError": "MIXED_INPUT_ENCODING",
      "code": "MIXED_INPUT_ENCODING",
      "error": "Hydraulic jump does not take Reynolds Re/ρ/μ or Weber We/σ"
    },
    {
      "id": "boundary-hj-n",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "y1": 1,
        "Fr": 2,
        "n": 0.013
      },
      "expectError": "MIXED_INPUT_ENCODING",
      "code": "MIXED_INPUT_ENCODING",
      "error": "Hydraulic jump does not take Manning n or Chezy C/R/S"
    },
    {
      "id": "boundary-hj-A",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "y1": 1,
        "Fr": 2,
        "A": 1
      },
      "expectError": "MIXED_INPUT_ENCODING",
      "code": "MIXED_INPUT_ENCODING",
      "error": "Hydraulic jump does not take Q=Av A/Q or Froude L. Use y1/y2"
    },
    {
      "id": "boundary-hj-L",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "y1": 1,
        "Fr": 2,
        "L": 1
      },
      "expectError": "MIXED_INPUT_ENCODING",
      "code": "MIXED_INPUT_ENCODING",
      "error": "Hydraulic jump does not take Q=Av A/Q or Froude L. Use y1/y2"
    },
    {
      "id": "boundary-hj-froude",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "y1": 1,
        "Fr": 2,
        "mode": "froude"
      },
      "expectError": "INVALID_MODE",
      "code": "INVALID_MODE",
      "error": "mode must be sequent|upstream|energy. Not Froude, Manning, Chezy, or a weir"
    },
    {
      "id": "property-hj-y2",
      "ok": true,
      "kind": "property",
      "detail": "Bélanger y2",
      "expect": 2.3722813232690143,
      "actual": 2.3722813232690143
    },
    {
      "id": "property-hj-Fr2",
      "ok": true,
      "kind": "property",
      "detail": "Fr2",
      "expect": 0.5473696470780532,
      "actual": 0.5473696470780532
    },
    {
      "id": "property-hj-dE",
      "ok": true,
      "kind": "property",
      "detail": "ΔE",
      "expect": 0.27233488537882894,
      "actual": 0.27233488537882894
    },
    {
      "id": "property-hj-roundtrip-y1",
      "ok": true,
      "kind": "property",
      "detail": "y1 invert",
      "expect": 1,
      "actual": 1
    },
    {
      "id": "property-hj-model",
      "ok": true,
      "kind": "property",
      "detail": "hydraulic_jump",
      "expect": true,
      "actual": "hydraulic_jump"
    }
  ],
  "tier": "engine_tested",
  "verification": {
    "tests": {
      "passed": 17,
      "total": 17,
      "golden": 2,
      "boundary": 10,
      "property": 5
    },
    "contract_checks": {
      "passed": 3,
      "total": 3
    }
  },
  "evidence_core_generated_at": "2026-09-17T07:22:11.551Z",
  "rendered_at": "2026-09-17T08:49:50.939Z",
  "release_integrity": {
    "status": "verified",
    "scope": "workspace",
    "production_attestation_required": true,
    "calculation_version": "1.0.0",
    "artifacts": {
      "engine": "1.0.0",
      "page": "1.0.0",
      "capability": "1.0.0",
      "evidence": "1.0.0",
      "input_schema": "1.0.0",
      "output_schema": "1.0.0",
      "mcp_contract": "1.0.0"
    },
    "digests": {
      "input_schema_sha256": "9c041efc9c0f603cf0325801f10b8f90e03e49ef0f7fa74f39df5593b1e6ce4f",
      "output_schema_sha256": "292f0bd466be0e5ea6c0ecf6289c63deeafed233e31469d519403ce700c6e9ab",
      "evidence_sha256": "ba4f9a18ad4367d57c0acfaed7eb81ed1afe06d8c2742a6108f64b42c4313cfb",
      "evidence_core_sha256": "ba4f9a18ad4367d57c0acfaed7eb81ed1afe06d8c2742a6108f64b42c4313cfb",
      "capability_sha256": "cf1c8a10c4737fda48168de6c8ed953d73e19e39c8c8a812bcde53b713d7b20c",
      "engine_sha256": "0c0851fab70abbeebfe07916fc4e23f4718babe41882681bdfec8e4f0768b97f",
      "mcp_contract_sha256": "e444fb05e9379f4f2492792d89493686e8dd71c0a104ae00acbe73364b370c5c"
    },
    "contract_checks": {
      "total": 3,
      "passed": 3,
      "failed": 0,
      "items": [
        {
          "id": "release-artifacts-aligned",
          "status": "pass",
          "detail": "1.0.0"
        },
        {
          "id": "schema-valid-input-executes",
          "status": "pass"
        },
        {
          "id": "engine-success-output-validates-schema",
          "status": "pass"
        }
      ]
    },
    "report": "https://www.calculatorx.com/.well-known/calculatorx-release-integrity.json"
  }
}