{
  "capability_id": "physics.fluid.cavitation",
  "tool_id": "cavitation-number",
  "engine": "cavitation-number",
  "calculation_version": "1.0.0",
  "generated_at": "2026-09-17T12:57:09.948Z",
  "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/cavitation-number",
  "api": "https://www.calculatorx.com/api/v1/calc/cavitation-number",
  "schema_input": "https://www.calculatorx.com/schemas/physics.fluid.cavitation.input.json",
  "schema_output": "https://www.calculatorx.com/schemas/physics.fluid.cavitation.output.json",
  "assumptions": [
    "Cavitation number σ = (p − p_v) / (½ ρ v²); default ρ=1000 kg/m³; p and p_v absolute Pa",
    "Not NPSH head, not Thoma σ_Th=NPSH/H, not Weber We=ρv²L/σ, not Euler Eu=Δp/(ρ v²)",
    "Not Reynolds, not capillary Ca=μv/σ, not Q=Av"
  ],
  "limitations": [
    "Cavitation number σ = (p − p_v) / (½ ρ v²); default ρ=1000 kg/m³; p and p_v absolute Pa",
    "Not NPSH head, not Thoma σ_Th=NPSH/H, not Weber We=ρv²L/σ, not Euler Eu=Δp/(ρ v²)",
    "Not Reynolds, not capillary Ca=μv/σ, not Q=Av"
  ],
  "boundary_conditions": [
    "missing p, p_v, v, or σ when required → MISSING_REQUIRED_INPUT",
    "p, v, ρ, or σ ≤ 0 → VALUE_MUST_BE_POSITIVE",
    "p ≤ p_v → VALUE_OUT_OF_RANGE",
    "NPSH/z/hf/H/g, We/L, Re/μ, Eu/Δp, A/Q → MIXED_INPUT_ENCODING",
    "npsh, thoma, weber, or euler as mode → INVALID_MODE"
  ],
  "sources": [
    {
      "title": "ISO 80000-11 — Characteristic numbers",
      "section": "Cavitation number",
      "supports": "σ = (p − p_v) / (½ ρ v²); inertia vs vapor-pressure deficit, not NPSH head",
      "kind": "standard"
    },
    {
      "title": "ISO 80000-4 — Mechanics",
      "section": "Pressure",
      "url": "https://www.iso.org/standard/31895.html",
      "supports": "p and p_v are absolute pressures; ½ ρ v² is a dynamic pressure",
      "kind": "standard"
    }
  ],
  "methods": [],
  "fingerprint": "sha256:e3a671d157787e92a9fd358d26c296bd4973b85bb67f82eee6af140f281bd7b5",
  "tests": [
    {
      "id": "golden-cav-sigma",
      "ok": true,
      "kind": "golden",
      "inputs": {
        "p": 150000,
        "p_v": 50000,
        "v": 10
      },
      "expect": {
        "sigma": 2,
        "p": 150000,
        "p_v": 50000,
        "rho": 1000,
        "v": 10,
        "mode": "number",
        "model": "cavitation"
      },
      "expectWarning": null,
      "actual": {
        "mode": "number",
        "sigma": 2,
        "p": 150000,
        "p_v": 50000,
        "rho": 1000,
        "v": 10,
        "model": "cavitation"
      },
      "tol": 1e-12
    },
    {
      "id": "golden-cav-p",
      "ok": true,
      "kind": "golden",
      "inputs": {
        "mode": "pressure",
        "sigma": 2,
        "p_v": 50000,
        "v": 10
      },
      "expect": {
        "p": 150000,
        "model": "cavitation"
      },
      "expectWarning": null,
      "actual": {
        "mode": "pressure",
        "sigma": 2,
        "p": 150000,
        "p_v": 50000,
        "rho": 1000,
        "v": 10,
        "model": "cavitation"
      },
      "tol": 1e-12
    },
    {
      "id": "boundary-cav-v",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "mode": "velocity",
        "sigma": 2,
        "p": 150000,
        "p_v": 50000
      },
      "expect": {
        "v": 10,
        "model": "cavitation"
      },
      "expectWarning": null,
      "actual": {
        "mode": "velocity",
        "sigma": 2,
        "p": 150000,
        "p_v": 50000,
        "rho": 1000,
        "v": 10,
        "model": "cavitation"
      },
      "tol": 1e-12
    },
    {
      "id": "boundary-cav-missing",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "p": 150000,
        "p_v": 50000
      },
      "expectError": "MISSING_REQUIRED_INPUT",
      "code": "MISSING_REQUIRED_INPUT",
      "error": "v is required"
    },
    {
      "id": "boundary-cav-npsh",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "p": 150000,
        "p_v": 50000,
        "v": 10,
        "NPSH": 10
      },
      "expectError": "MIXED_INPUT_ENCODING",
      "code": "MIXED_INPUT_ENCODING",
      "error": "Cavitation number is not NPSH head. That is /calc/physics/npsh"
    },
    {
      "id": "boundary-cav-We",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "p": 150000,
        "p_v": 50000,
        "v": 10,
        "We": 1000
      },
      "expectError": "MIXED_INPUT_ENCODING",
      "code": "MIXED_INPUT_ENCODING",
      "error": "Cavitation number does not take Weber We, L, or σ as N/m. That is /calc/physics/weber-number"
    },
    {
      "id": "boundary-cav-Re",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "p": 150000,
        "p_v": 50000,
        "v": 10,
        "Re": 100000
      },
      "expectError": "MIXED_INPUT_ENCODING",
      "code": "MIXED_INPUT_ENCODING",
      "error": "Cavitation number does not take Re, μ, ν, or Fr. Not Reynolds, not capillary Ca=μv/σ"
    },
    {
      "id": "boundary-cav-A",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "p": 150000,
        "p_v": 50000,
        "v": 10,
        "A": 1
      },
      "expectError": "MIXED_INPUT_ENCODING",
      "code": "MIXED_INPUT_ENCODING",
      "error": "Cavitation number does not take Q=Av A/Q. That is /calc/physics/flow-rate"
    },
    {
      "id": "boundary-cav-dP",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "p": 150000,
        "p_v": 50000,
        "v": 10,
        "dP": 100000
      },
      "expectError": "MIXED_INPUT_ENCODING",
      "code": "MIXED_INPUT_ENCODING",
      "error": "Cavitation number is not Euler Eu=Δp/(ρ v²). Send p and p_v, not a single Δp"
    },
    {
      "id": "boundary-cav-mode",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "p": 150000,
        "p_v": 50000,
        "v": 10,
        "mode": "npsh"
      },
      "expectError": "INVALID_MODE",
      "code": "INVALID_MODE",
      "error": "mode must be number|pressure|vapor|velocity. Not NPSH, Thoma, Weber, Euler, or Q=Av"
    },
    {
      "id": "boundary-cav-zero",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "p": 150000,
        "p_v": 50000,
        "v": 0
      },
      "expectError": "VALUE_MUST_BE_POSITIVE",
      "code": "VALUE_MUST_BE_POSITIVE",
      "error": "v must be greater than zero"
    },
    {
      "id": "boundary-cav-margin",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "p": 50000,
        "p_v": 50000,
        "v": 10
      },
      "expectError": "VALUE_OUT_OF_RANGE",
      "code": "VALUE_OUT_OF_RANGE",
      "error": "Cavitation number needs p > p_v"
    },
    {
      "id": "property-cav-sigma",
      "ok": true,
      "kind": "property",
      "detail": "σ=(p−p_v)/(½ρv²)",
      "expect": 2,
      "actual": 2
    },
    {
      "id": "property-cav-roundtrip-p",
      "ok": true,
      "kind": "property",
      "detail": "p invert",
      "expect": 150000,
      "actual": 150000
    },
    {
      "id": "property-cav-roundtrip-v",
      "ok": true,
      "kind": "property",
      "detail": "v invert",
      "expect": 10,
      "actual": 10
    },
    {
      "id": "property-cav-rho",
      "ok": true,
      "kind": "property",
      "detail": "ρ default 1000",
      "expect": 1000,
      "actual": 1000
    },
    {
      "id": "property-cav-model",
      "ok": true,
      "kind": "property",
      "detail": "cavitation",
      "expect": true,
      "actual": "cavitation"
    }
  ],
  "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-17T10:13:14.968Z",
  "rendered_at": "2026-09-17T12:57:09.948Z",
  "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": "795dfff7a79de93cdcd92535f6e6e8f07209e56ed5c2831270aa10f8f8ca175c",
      "output_schema_sha256": "d479c5fa0300f2187cb9e7753be40e05cba41ee98001875e9659d2cc1f2a611d",
      "evidence_sha256": "af9b387198b5432a1238d6014cdf1d9856183a20b2059ff75dabfac4273b0b15",
      "evidence_core_sha256": "af9b387198b5432a1238d6014cdf1d9856183a20b2059ff75dabfac4273b0b15",
      "capability_sha256": "675e2d0560940b9f05fe2c6221d980f048d99afe182ad4e888b5967fa70da479",
      "engine_sha256": "3a274e9526e8ef09a42dd9a5a2173db0d5ed2458a9b92192df103930b4e43523",
      "mcp_contract_sha256": "c77a372e41c0e20baf484d40ec69bc5e915f0921b6c896f8723c29434c676171"
    },
    "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"
  }
}
