{
  "capability_id": "physics.fluid.trapezoid_specific_energy",
  "tool_id": "trapezoidal-specific-energy",
  "engine": "trapezoidal-specific-energy",
  "calculation_version": "1.0.0",
  "generated_at": "2026-11-10T05:18:41.988Z",
  "engine_build": "2026-09-24",
  "test_count": 6,
  "passed": 6,
  "failed": 0,
  "tests_summary": {
    "golden": {
      "passed": 1,
      "total": 1
    },
    "boundary": {
      "passed": 0,
      "total": 0
    },
    "property": {
      "passed": 5,
      "total": 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-specific-energy",
  "api": "https://www.calculatorx.com/api/v1/calc/trapezoidal-specific-energy",
  "schema_input": "https://www.calculatorx.com/schemas/physics.fluid.trapezoid_specific_energy.input.json",
  "schema_output": "https://www.calculatorx.com/schemas/physics.fluid.trapezoid_specific_energy.output.json",
  "assumptions": [
    "Trapezoid specific energy: E=y+Q²/(2g A²) with A=(b+z y)y; SI; default g=9.80665; z>0 is run/rise",
    "Unknown is E (energy mode) or Q (discharge invert); v=Q/A is reported; not y invert (that is alternate depth)",
    "Not rectangular E=y+v²/(2g); not trapezoid yc; not trapezoid yn; not Manning A,R; not Q=Av"
  ],
  "limitations": [
    "Trapezoid specific energy: E=y+Q²/(2g A²) with A=(b+z y)y; SI; default g=9.80665; z>0 is run/rise",
    "Unknown is E (energy mode) or Q (discharge invert); v=Q/A is reported; not y invert (that is alternate depth)",
    "Not rectangular E=y+v²/(2g); not trapezoid yc; not trapezoid yn; not Manning A,R; not Q=Av"
  ],
  "boundary_conditions": [
    "missing y, Q, b, z, or E when required → MISSING_REQUIRED_INPUT",
    "y, Q, b, z, E, or g ≤ 0 → VALUE_MUST_BE_POSITIVE",
    "E ≤ y → VALUE_OUT_OF_RANGE",
    "z=0, v, A, yc/q, n/S/yn, Fr/L, M, y_sub → MIXED_INPUT_ENCODING",
    "z>10 or y/b outside [0.01, 20] → VALUE_OUT_OF_RANGE",
    "depth, velocity, or depths as mode → MIXED_INPUT_ENCODING or INVALID_MODE"
  ],
  "sources": [
    {
      "title": "ISO 80000-4 — Mechanics",
      "section": "Energy, length, speed",
      "url": "https://www.iso.org/standard/31895.html",
      "supports": "E and y are lengths; Q is volume flow; g is acceleration",
      "kind": "standard"
    },
    {
      "title": "Chow, V.T. Open-Channel Hydraulics",
      "section": "Specific energy in a trapezoidal section",
      "supports": "E = y + Q²/(2g A²) with A=(b+z y)y. Rectangular E=y+v²/(2g) is a different page.",
      "kind": "reference"
    }
  ],
  "methods": [],
  "fingerprint": "sha256:1263b07a55e8ce2e4921b6ae6904ceab1a610201ee2044ff0ed5b39c5f535134",
  "tier": "engine_tested",
  "verification": {
    "tests": {
      "passed": 6,
      "total": 6,
      "golden": 1,
      "boundary": 0,
      "property": 5
    },
    "contract_checks": {
      "passed": 6,
      "total": 6
    }
  },
  "evidence_core_generated_at": "2026-09-24T02:12:38.088Z",
  "rendered_at": "2026-11-10T05:18:41.988Z",
  "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": "82759d8a740a667c38e376fb92367ac4bd5b8d4d4971f58f56e6f67a88ec8013",
      "output_schema_sha256": "67caad0194ecb7b65170797f8edc5f955455b6899c7cfbced9588f827e740443",
      "evidence_sha256": "ee574d3f2ead0fb9e327cda269ee655346d4b6b8c4bc9bacf6fc441c2154dbf6",
      "evidence_core_sha256": "ee574d3f2ead0fb9e327cda269ee655346d4b6b8c4bc9bacf6fc441c2154dbf6",
      "capability_sha256": "7ac6cbaf07d704ea768d15a590c86e96ca0ad44f0852be76766b97a885cc4ade",
      "engine_sha256": "c6ebd8436f08b413e1ac6317b2d48550f2e6639a90dff254244e3aa562158b8d",
      "mcp_contract_sha256": "eb3e39ad4a95ed263415b4932f185d5edfe00a2403267b7c5ed5f718d1ff6da3"
    },
    "contract_checks": {
      "total": 6,
      "passed": 6,
      "failed": 0,
      "items": [
        {
          "id": "release-artifacts-aligned",
          "status": "pass",
          "detail": "1.0.0"
        },
        {
          "id": "schema-output-required-declared",
          "status": "pass"
        },
        {
          "id": "schema-valid-input-executes",
          "status": "pass"
        },
        {
          "id": "engine-success-output-validates-schema",
          "status": "pass"
        },
        {
          "id": "schema-rejects-incomplete-input",
          "status": "pass"
        },
        {
          "id": "rest-success-payload-validates-schema",
          "status": "pass"
        }
      ]
    },
    "report": "https://www.calculatorx.com/.well-known/calculatorx-release-integrity.json"
  },
  "tests": [],
  "disclosure": {
    "policy": "calculatorx-public-evidence-v1",
    "full_validation": "private",
    "representation": "summary"
  }
}
