{
  "capability_id": "electrical.rf.fspl",
  "tool_id": "fspl",
  "engine": "fspl",
  "calculation_version": "1.0.0",
  "generated_at": "2026-09-16T22:03:43.716Z",
  "engine_build": "2026-09-13",
  "test_count": 10,
  "passed": 10,
  "failed": 0,
  "tests_summary": {
    "golden": {
      "total": 2,
      "passed": 2
    },
    "boundary": {
      "total": 4,
      "passed": 4
    },
    "property": {
      "total": 4,
      "passed": 4
    }
  },
  "engine_tested": true,
  "expert_reviewed": true,
  "internally_reviewed": false,
  "review_kind": "expert",
  "source_checked": true,
  "reviewed_by": "CalculatorX electrical review",
  "reviewer_role": "electrical-engineer",
  "last_reviewed": "2026-08-08",
  "expert_review": {
    "status": "approved",
    "reviewer": {
      "name": "CalculatorX electrical review",
      "role": "electrical-engineer"
    },
    "reviewed_at": "2026-08-08",
    "scope": [
      "formula",
      "input semantics",
      "assumptions",
      "limitations",
      "sources",
      "tests"
    ],
    "kind": "expert"
  },
  "internal_review": {
    "status": "not_applicable",
    "reviewer": null
  },
  "page": "https://www.calculatorx.com/calc/electric/fspl",
  "api": "https://www.calculatorx.com/api/v1/calc/fspl",
  "schema_input": "https://www.calculatorx.com/schemas/electrical.rf.fspl.input.json",
  "schema_output": "https://www.calculatorx.com/schemas/electrical.rf.fspl.output.json",
  "assumptions": [
    "Ideal free space; isotropic reference for FSPL.",
    "c = 299792458 m/s.",
    "Friis free-space equation assumes far-field propagation. For electrically large antennas or short separations, verify that the antenna separation exceeds the applicable far-field distance."
  ],
  "limitations": [
    "Ideal free-space only — no atmosphere, multipath, or cable loss",
    "d_m/f_Hz ≤ 0 → VALUE_MUST_BE_POSITIVE"
  ],
  "boundary_conditions": [
    "Missing/≤0 d_m or f_Hz → MISSING_REQUIRED_INPUT / VALUE_MUST_BE_POSITIVE",
    "Non-finite → INVALID_NUMBER"
  ],
  "sources": [
    {
      "title": "Friis transmission equation",
      "section": "Free-space path loss form",
      "supports": "FSPL from distance and wavelength/frequency",
      "kind": "reference"
    },
    {
      "title": "ITU-R P.525-5 (11/2024), Calculation of free-space attenuation",
      "section": "Free-space basic transmission loss",
      "supports": "Standard FSPL formulation for radio links; version-locked recommendation",
      "kind": "standard"
    }
  ],
  "methods": [],
  "fingerprint": "sha256:c7a8b2174f78935dc58ed709b0e1449baaa02910ae4df9cb845a1c5cacf381d1",
  "tests": [
    {
      "id": "1km-2g4",
      "ok": true,
      "kind": "golden",
      "inputs": {
        "d_m": 1000,
        "f_Hz": 2400000000
      },
      "expect": {
        "fspl_dB": 100.05200805611548,
        "path_loss_dB": 100.05200805611548
      },
      "expectWarning": null,
      "actual": {
        "fspl_dB": 100.05200805611548,
        "path_loss_dB": 100.05200805611548,
        "wavelength_m": 0.12491352416666666,
        "d_m": 1000,
        "f_Hz": 2400000000,
        "Gt_dBi": 0,
        "Gr_dBi": 0
      },
      "tol": 1e-9
    },
    {
      "id": "with-gains",
      "ok": true,
      "kind": "golden",
      "inputs": {
        "d_m": 1000,
        "f_Hz": 2400000000,
        "Gt_dBi": 6,
        "Gr_dBi": 6
      },
      "expect": {
        "path_loss_dB": 88.05200805611548
      },
      "expectWarning": null,
      "actual": {
        "fspl_dB": 100.05200805611548,
        "path_loss_dB": 88.05200805611548,
        "wavelength_m": 0.12491352416666666,
        "d_m": 1000,
        "f_Hz": 2400000000,
        "Gt_dBi": 6,
        "Gr_dBi": 6
      },
      "tol": 1e-9
    },
    {
      "id": "missing-f",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "d_m": 1000
      },
      "expectError": "MISSING_REQUIRED_INPUT",
      "code": "MISSING_REQUIRED_INPUT",
      "error": "f_Hz is required"
    },
    {
      "id": "zero-d",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "d_m": 0,
        "f_Hz": 1000000000
      },
      "expectError": "VALUE_MUST_BE_POSITIVE",
      "code": "VALUE_MUST_BE_POSITIVE",
      "error": "d_m must be greater than zero"
    },
    {
      "id": "nan-d",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "d_m": "n/a",
        "f_Hz": 1000000000
      },
      "expectError": "INVALID_NUMBER",
      "code": "INVALID_NUMBER",
      "error": "d_m must be a finite number"
    },
    {
      "id": "boundary-1km-2g4",
      "ok": true,
      "kind": "boundary",
      "inputs": {
        "d_m": 1000,
        "f_Hz": 2400000000
      },
      "expect": {
        "fspl_dB": 100.05200805611548
      },
      "expectWarning": null,
      "actual": {
        "fspl_dB": 100.05200805611548,
        "path_loss_dB": 100.05200805611548,
        "wavelength_m": 0.12491352416666666,
        "d_m": 1000,
        "f_Hz": 2400000000,
        "Gt_dBi": 0,
        "Gr_dBi": 0
      },
      "tol": 1e-9
    },
    {
      "id": "property-fspl",
      "ok": true,
      "kind": "property",
      "detail": "1 km · 2.4 GHz",
      "expect": 100.05200805611548,
      "actual": 100.05200805611548
    },
    {
      "id": "property-6db",
      "ok": true,
      "kind": "property",
      "detail": "2×d → +20·log10(2) dB",
      "expect": 6.020599913279624,
      "actual": 6.020599913279625
    },
    {
      "id": "property-freq",
      "ok": true,
      "kind": "property",
      "detail": "2×f → +20·log10(2) dB",
      "expect": 6.020599913279624,
      "actual": 6.020599913279625
    },
    {
      "id": "property-gains",
      "ok": true,
      "kind": "property",
      "detail": "PL = FSPL−Gt−Gr",
      "expect": 94.05200805611548,
      "actual": 94.05200805611548
    }
  ],
  "tier": "expert_verified",
  "verification": {
    "tests": {
      "passed": 10,
      "total": 10,
      "golden": 2,
      "boundary": 4,
      "property": 4
    },
    "contract_checks": {
      "passed": 4,
      "total": 4
    }
  },
  "evidence_core_generated_at": "2026-09-13T01:10:14.255Z",
  "rendered_at": "2026-09-16T22:03:43.716Z",
  "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": "15a38c2c350af9df0aa158b3922ecbf7bb4ca0c425c2052715ea6b2091759591",
      "output_schema_sha256": "05956bcab131a871e415bc3b8b424c44a4a6abdc6b6b8841cc85cef1533e09ad",
      "evidence_sha256": "b73d10b5564f4c8890bb4f20f785a8c35a873cffb5c793cf9329d4cabb7152fe",
      "evidence_core_sha256": "b73d10b5564f4c8890bb4f20f785a8c35a873cffb5c793cf9329d4cabb7152fe",
      "capability_sha256": "9b52668bce6da2cca1a00549faa1689ee94f14d79266c31caf001c1ba89aab51",
      "engine_sha256": "c8d4ccdbfeaf61d7b024d4e1babb0c2ba3b324c1b37bd0cb456a526d8d2b1bd1",
      "mcp_contract_sha256": "863098b311a7b17dc4b229a6302b90b3545b175f716e5d84772c7be8e9716b86"
    },
    "contract_checks": {
      "total": 4,
      "passed": 4,
      "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"
        },
        {
          "id": "schema-rejects-incomplete-input",
          "status": "pass"
        }
      ]
    },
    "report": "https://www.calculatorx.com/.well-known/calculatorx-release-integrity.json"
  }
}
