{
  "capability_id": "physics.fluid.trapezoid_critical_depth",
  "tool_id": "trapezoidal-critical-depth",
  "engine": "trapezoidal-critical-depth",
  "calculation_version": "1.0.0",
  "generated_at": "2026-09-18T23:14:09.774Z",
  "engine_build": "2026-09-18",
  "test_count": 5,
  "passed": 5,
  "failed": 0,
  "tests_summary": {
    "golden": {
      "total": 0,
      "passed": 0
    },
    "boundary": {
      "total": 0,
      "passed": 0
    },
    "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/trapezoidal-critical-depth",
  "api": "https://www.calculatorx.com/api/v1/calc/trapezoidal-critical-depth",
  "schema_input": "https://www.calculatorx.com/schemas/physics.fluid.trapezoid_critical_depth.input.json",
  "schema_output": "https://www.calculatorx.com/schemas/physics.fluid.trapezoid_critical_depth.output.json",
  "assumptions": [
    "Trapezoid critical depth: Fr=1 with A=(b+z yc) yc and T=b+2 z yc so Q² T = g A³; SI; default g=9.80665; z>0 is run/rise",
    "Critical speed vc = Q/A = √(g A/T) is reported, not an input; Fr=1 is the definition, not a Froude wrap",
    "Not rectangular yc=(q²/g)^{1/3}; not normal-depth yn; not specific energy E; not Manning n; not Q=Av"
  ],
  "limitations": [
    "Trapezoid critical depth: Fr=1 with A=(b+z yc) yc and T=b+2 z yc so Q² T = g A³; SI; default g=9.80665; z>0 is run/rise",
    "Unknown is yc (depth mode) or Q (discharge invert); vc=√(g A/T) is reported; Fr=1 is the definition, not a Froude wrap",
    "Not rectangular yc=(q²/g)^{1/3}; not normal-depth yn; not specific energy E; not Manning n; not Q=Av"
  ],
  "boundary_conditions": [
    "missing Q, b, z, or yc when required → MISSING_REQUIRED_INPUT",
    "Q, b, z, yc, or g ≤ 0 → VALUE_MUST_BE_POSITIVE",
    "z=0, q, n/S/yn, E, Fr/L, A/v, y1/M/Sc, B, theta → MIXED_INPUT_ENCODING",
    "z>10 or yc/b outside [0.01, 20] → VALUE_OUT_OF_RANGE",
    "unit_discharge, energy, or yn as mode → MIXED_INPUT_ENCODING or INVALID_MODE"
  ],
  "sources": [
    {
      "title": "ISO 80000-4 — Mechanics",
      "section": "Length, speed, acceleration",
      "url": "https://www.iso.org/standard/31895.html",
      "supports": "yc is a length; Q is volume flow; g is acceleration",
      "kind": "standard"
    },
    {
      "title": "Chow, V.T. Open-Channel Hydraulics",
      "section": "Critical flow in a trapezoidal section",
      "supports": "Fr=1 is Q² T = g A³. Rectangular yc=(q²/g)^{1/3} is the z=0 special case on a different page.",
      "kind": "reference"
    }
  ],
  "methods": [],
  "fingerprint": "sha256:04b6b32a5369c4d4788307b54a2e0847df16ddd1bd3702ec8af5e6be11f6d59b",
  "tests": [
    {
      "id": "property-tyc-Fr",
      "ok": true,
      "kind": "property",
      "detail": "Fr=1",
      "expect": 1,
      "actual": 1.000000000000014
    },
    {
      "id": "property-tyc-Q",
      "ok": true,
      "kind": "property",
      "detail": "Q²T=gA³",
      "expect": 2,
      "actual": 1.999999999999972
    },
    {
      "id": "property-tyc-not-rect",
      "ok": true,
      "kind": "property",
      "detail": "yc≠(q²/g)^{1/3}",
      "expect": 0.46718953723930495,
      "actual": 0.43297701238915787
    },
    {
      "id": "property-tyc-roundtrip-Q",
      "ok": true,
      "kind": "property",
      "detail": "Q roundtrip",
      "expect": 2,
      "actual": 1.999999999999972
    },
    {
      "id": "property-tyc-model",
      "ok": true,
      "kind": "property",
      "detail": "critical_depth_trapezoid",
      "expect": true,
      "actual": "critical_depth_trapezoid"
    }
  ],
  "tier": "engine_tested",
  "verification": {
    "tests": {
      "passed": 5,
      "total": 5,
      "golden": 0,
      "boundary": 0,
      "property": 5
    },
    "contract_checks": {
      "passed": 1,
      "total": 1
    }
  },
  "evidence_core_generated_at": "2026-09-18T22:05:44.918Z",
  "rendered_at": "2026-09-18T23:14:09.774Z",
  "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": "58e996e1feaef67c68521faa5e5cd2d87c403642356cdad1492611db45b3e669",
      "output_schema_sha256": "9ade55c11018764030d6a46206ad886218b0a973645928faf4a28da14fdd967c",
      "evidence_sha256": "78cffa2f1f3755995c42f07e6d26a8050cc653790caf45983dde5acb286ce19b",
      "evidence_core_sha256": "78cffa2f1f3755995c42f07e6d26a8050cc653790caf45983dde5acb286ce19b",
      "capability_sha256": "b8bf75573bf600e35833e7470a3073a5ff363323e77ae68db2e84c60bbc4b002",
      "engine_sha256": "ec5f90dd051e61e84416b6eff7f761d72ed59985452a88ec6879efdbe4060d42",
      "mcp_contract_sha256": "342ea877fa003c6c958ee3fafb7b71055adb29a20af849e5b2978f768e87b93e"
    },
    "contract_checks": {
      "total": 1,
      "passed": 1,
      "failed": 0,
      "items": [
        {
          "id": "release-artifacts-aligned",
          "status": "pass",
          "detail": "1.0.0"
        }
      ]
    },
    "report": "https://www.calculatorx.com/.well-known/calculatorx-release-integrity.json"
  }
}
