{
  "capability_id": "electrical.mosfet.vth",
  "tool_id": "mosfet-vth",
  "engine": "mosfet-vth",
  "calculation_version": "1.3.1",
  "generated_at": "2026-11-10T05:18:41.899Z",
  "engine_build": "2026-09-10",
  "test_count": 26,
  "passed": 26,
  "failed": 0,
  "tests_summary": {
    "golden": {
      "passed": 10,
      "total": 10
    },
    "boundary": {
      "passed": 5,
      "total": 5
    },
    "property": {
      "passed": 11,
      "total": 11
    }
  },
  "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-17",
  "expert_review": {
    "status": "approved",
    "reviewer": {
      "name": "CalculatorX electrical review",
      "role": "electrical-engineer"
    },
    "reviewed_at": "2026-08-17",
    "scope": [
      "formula",
      "input semantics",
      "assumptions",
      "limitations",
      "sources",
      "tests"
    ],
    "kind": "expert"
  },
  "internal_review": {
    "status": "not_applicable",
    "reviewer": null
  },
  "page": "https://www.calculatorx.com/calc/electric/mosfet-vth",
  "api": "https://www.calculatorx.com/api/v1/calc/mosfet-vth",
  "schema_input": "https://www.calculatorx.com/schemas/electrical.mosfet.vth.input.json",
  "schema_output": "https://www.calculatorx.com/schemas/electrical.mosfet.vth.output.json",
  "assumptions": [
    "Ideal long-channel square-law NMOS model. Not BSIM, velocity saturation, or short-channel.",
    "Vth is the model threshold parameter, not datasheet VGS(th) and not recommended gate drive.",
    "kn = μn·Cox·W/L such that Id_sat = ½·kn·Vod². The ½ factor is not included in kn.",
    "When Vds is omitted, Id uses the saturation equation and region is above_threshold or cutoff.",
    "When Vds is provided: cutoff if Vod≤0; linear if 0≤Vds<Vod; saturation if Vds≥Vod.",
    "Vod > 0 means above the model threshold, not strong inversion.",
    "Cutoff returns Id = 0 A. Subthreshold current is not modeled.",
    "Solve-Vth always uses the saturation extract Vth=Vgs−√(2Id/kn) at the measurement temperature.",
    "Linear Vth(Tj) does not scale kn or μ(T).",
    "Default α = −0.002 V/°C is a Si planning value, not a datasheet TCV of VGS(th)."
  ],
  "limitations": [
    "Long-channel square-law only — not BSIM, velocity saturation, or short-channel",
    "Vth is the model threshold parameter, not datasheet VGS(th) and not recommended gate drive",
    "kn = μn·Cox·W/L such that Id_sat = ½·kn·Vod²; the ½ is not included in kn",
    "Without Vds, Id uses the saturation equation; with Vds, region is cutoff / linear / saturation",
    "Cutoff returns Id = 0 A; subthreshold leakage is not modeled",
    "Linear Vth(Tj) does not scale kn / μ(T); default α = −0.002 V/°C is a Si planning value, not datasheet TCV"
  ],
  "boundary_conditions": [
    "Unknown mode or temperature_model → INVALID_MODE",
    "Missing Vgs / Vth / Id / kn / Tj when required → MISSING_REQUIRED_INPUT",
    "Non-finite → INVALID_NUMBER",
    "Id or kn ≤ 0 → VALUE_MUST_BE_POSITIVE",
    "Vds < 0 → VALUE_MUST_BE_NON_NEGATIVE",
    "Tj or Tref < −273.15 °C → VALUE_OUT_OF_RANGE",
    "id mode Vgs ≤ Vth_used → Id_A=0, region=cutoff, warning SUBTHRESHOLD_NOT_MODELED (CUTOFF_NOT_MODELED deprecated alias)",
    "0 < Vod < 0.1 V → warning NEAR_THRESHOLD",
    "Every success includes warning MODEL_VTH_NOT_DATASHEET_VGS_TH",
    "id/vth with Vds omitted and Vod>0 → warning SATURATION_ASSUMED",
    "Vds < Vod and Vod>0 → region=linear, warning LINEAR_REGION (id) or SATURATION_EXTRACT_ASSUMED (vth)",
    "linear with omitted α → warning VTH_TEMP_COEFF_DEFAULT",
    "temperature_model=none with Tj/α present → warning TEMPERATURE_NOT_APPLIED",
    "linear id/vth → warning KN_TEMP_NOT_MODELED",
    "α > 0 → warning VTH_TEMP_COEFF_POSITIVE"
  ],
  "sources": [
    {
      "title": "Sedra/Smith — Microelectronic Circuits",
      "section": "MOSFET DC / square-law saturation and Vth(T)",
      "supports": "Id_sat=½ kn (Vgs−Vth)² and Id_lin=kn[(Vgs−Vth)Vds−Vds²/2]; Vth typically falls with T (~−2 mV/°C planning scale)",
      "kind": "reference"
    },
    {
      "title": "Toshiba — Power MOSFET Electrical Characteristics",
      "section": "Gate threshold voltage VGS(th)",
      "url": "https://toshiba.semicon-storage.com/info/docget.jsp?did=13415",
      "supports": "Datasheet VGS(th) is measured at a specified drain current; onset of conduction, not recommended gate drive",
      "kind": "reference",
      "accessed": "2026-08-16"
    },
    {
      "title": "Nexperia AN11158 — Understanding power MOSFET data sheet parameters",
      "section": "Threshold voltage",
      "url": "https://assets.nexperia.com/documents/application-note/AN11158.pdf",
      "supports": "Datasheet VGS(th) definition differs from the textbook device-physics threshold parameter; TCV of VGS(th) is not model Vth(T)",
      "kind": "reference",
      "accessed": "2026-08-16"
    },
    {
      "title": "Texas Instruments SLUA618 — Fundamentals of MOSFET and IGBT Gate Driver Circuits",
      "section": "Gate drive versus threshold",
      "url": "https://www.ti.com/lit/pdf/slua618",
      "supports": "VGS(th) indicates the start of conduction; it is not the gate voltage for full enhancement",
      "kind": "reference",
      "accessed": "2026-08-16"
    }
  ],
  "methods": [],
  "fingerprint": "sha256:62d830442da390bacca788207a7c0cde30c1f11982f6a67aa61d54533e60497a",
  "tier": "expert_verified",
  "verification": {
    "tests": {
      "passed": 26,
      "total": 26,
      "golden": 10,
      "boundary": 5,
      "property": 11
    },
    "contract_checks": {
      "passed": 12,
      "total": 12
    }
  },
  "evidence_core_generated_at": "2026-09-05T02:35:39.217Z",
  "rendered_at": "2026-11-10T05:18:41.899Z",
  "release_integrity": {
    "status": "verified",
    "scope": "workspace",
    "production_attestation_required": true,
    "calculation_version": "1.3.1",
    "artifacts": {
      "engine": "1.3.1",
      "page": "1.3.1",
      "capability": "1.3.1",
      "evidence": "1.3.1",
      "input_schema": "1.3.1",
      "output_schema": "1.3.1",
      "mcp_contract": "1.3.1"
    },
    "digests": {
      "input_schema_sha256": "8aaf0a70ca3197d145c41aebca84830791334284c7830b197771ba8e83f8178e",
      "output_schema_sha256": "07ec52f59e9a4a0172410ab1152a5879545b7d79b2f2a48a1355a4135ea860cf",
      "evidence_sha256": "29633fbdc8c84fec7478d4423d525648fce0182a3440bceb65004a746e1db356",
      "evidence_core_sha256": "29633fbdc8c84fec7478d4423d525648fce0182a3440bceb65004a746e1db356",
      "capability_sha256": "52e14e744df865fd90b46da7b9dda15a44fad5daca1ed925772d0226044d9275",
      "engine_sha256": "c6ebd8436f08b413e1ac6317b2d48550f2e6639a90dff254244e3aa562158b8d",
      "mcp_contract_sha256": "eb3e39ad4a95ed263415b4932f185d5edfe00a2403267b7c5ed5f718d1ff6da3"
    },
    "contract_checks": {
      "total": 12,
      "passed": 12,
      "failed": 0,
      "items": [
        {
          "id": "contract-page-version",
          "status": "pass",
          "detail": "1.3.1"
        },
        {
          "id": "contract-capability-version",
          "status": "pass",
          "detail": "1.3.1"
        },
        {
          "id": "contract-input-schema-version",
          "status": "pass",
          "detail": "1.3.1"
        },
        {
          "id": "contract-output-schema-version",
          "status": "pass",
          "detail": "1.3.1"
        },
        {
          "id": "evidence-version-matches-manifest",
          "status": "pass",
          "detail": "1.3.1"
        },
        {
          "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": "subthreshold-warning-codes",
          "status": "pass",
          "detail": "MODEL_VTH_NOT_DATASHEET_VGS_TH, SUBTHRESHOLD_NOT_MODELED, CUTOFF_NOT_MODELED (deprecated alias of SUBTHRESHOLD_NOT_MODELED), SATURATION_ASSUMED, LINEAR_REGION, SATURATION_EXTRACT_A"
        },
        {
          "id": "cutoff-id-zero-subthreshold-warning",
          "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"
  }
}
