← Back to the grid

Research — Underground · Live

Underground vault and conduit engineering as deterministic tools — ported, not yet expert-reviewed.

The underground counterpart to the overhead pole harness. Vault and conduit-segment sessions sit behind an MCP server, and deterministic engines do the math: conduit fill, pulling tension, ampacity, vault sizing, fault current and duct bank. The README lists 76 tools; a stateless API exposes the stateless-compute ones.

Interactive demos

Harnesses in action

Scripted chat-and-viewer examples where this domain's harness is one of the tools. Illustrative, not live sessions.

All harness demos →

What it can do

  • calculate_conduit_fill

    NEC Chapter 9 fill percentage for cables in a conduit, with pass/fail against the allowed limit.

  • calculate_pulling_tension

    Cumulative cable pulling tension through bends and straight sections.

  • calculate_cable_ampacity

    Neher-McGrath ampacity with soil resistivity, burial depth, grouping and temperature corrections.

  • recommend_vault_size

    Selects an ANSI vault from conduit count and equipment needs.

  • calculate_arc_flash_energy

    IEEE 1584 arc flash energy, hazard category and PPE.

  • get_vault_topology

    Derives vault adjacency grouped by connected component, fresh per request.

  • propose_underground_fix

    For a failing jam-ratio, cable fault-withstand, concentric-neutral or clearance check, the next conduit or cable size or the vault dimension that passes the same check when re-run, with side effects such as changed conduit fill. Fault current, voltage and materials are never changed.

A worked case

Input

Three 350 kcmil aluminum EPR 15 kV cables in a 4-inch PVC Schedule 40 conduit.

Result

Fill is 37.3% against the 40% limit, so it passes, but the three identical cables fall inside the jam-risk band (jam ratio 2.84), so it reads as a pass with a jam warning. In a 2-inch conduit the same three cables fail at 142.3% fill. One cable allows 53.0% fill and two allow 31.0%.

Where this stands

Starting inventory, not a completed review. The calculation services were inherited as live code that predates the review process and have had no expert sign-off; ingestion of the NEC standards text has not started.

Open questions

  • First standards ingestion pass (NEC Chapter 9 conduit fill) has not started, and no reviewer is assigned.
  • No lineage service is deployed, so publishing a vault to the grid graph returns “not configured”.
  • The pole-to-vault riser transition is not yet derived.
All domains →