

This simulator is an educational model of underground electrical distribution. It provides simplified connectivity, loading and voltage-drop checks; it is not an engineered construction design or utility approval. Verify all values against the applicable utility standards and engineering requirements.
.dds project; Load restores it; Print / Export creates a 3-sheet drawing set. Your design is also backed up in this browser automatically. The status line beside the menu reminds you to save every 5 minutes and turns amber when it has been 5 minutes since your last save.| View | What it shows |
|---|---|
| X-ray underground X | Makes the city see-through and draws each conduit at its nominal depth inside a translucent trench, using the same layout as the trench cross-section. |
| Color by loading L | Conductors and the rings under transformers and SES turn green (<80%), amber (80–100%) or red (>100%). |
| Power flow F | Animated chevrons move from the source toward the loads on every energized circuit. |
| Single-line diagram D | An automatic one-line drawing of the configured network. Clicking a symbol selects it in 3D, and the reverse. |
| Labels N | Equipment names on / off. |
| Dimensions (Plan View) | Trench segment lengths on every trench; the button appears in plan view only. |
| Measure M | Click points on the ground; double-click or Enter finishes; Esc clears. |
| Existing / Proposed | Existing equipment is shown screened grey in 3D, the single-line diagram and printed sheets, marked (E). |
| V | Select tool | P | Plan / 3D view |
| 1–8 | Place cabinet, transformer, pull box, SES, traffic signal, streetlight J-box, streetlight, pole (number keys still work; the buttons no longer show them) | X | X-ray underground |
| T | Draw trench (from selected equipment) | L | Color by loading |
| O | Draw overhead line (from the selected pole) | F2 | Rename selected equipment |
| M | Measure | F | Power flow |
| G / R | Move / rotate selected equipment | D | Single-line diagram |
| Del | Delete selection (with undo) | N | Labels |
| Esc | Cancel / deselect | I | Issues list |
| Ctrl Z / Ctrl Y | Undo / redo | H | Reset view |
| Ctrl S | Save project | ← → | Rotate 5° while placing |
| Shift-click | Select a second piece of equipment to insert between | Shift while placing | Place without inserting into a trench |
| Right-click | Context menu for equipment, trenches, buildings, bends and ground (long-press on touch screens) | ||
| Term | Meaning in the simulator |
|---|---|
| Supply source | A switching cabinet or pole designated as a starting point for connectivity. A design may have several; each cabinet is analysed from its nearest source. |
| Transformer | Converts 12.47 kV primary to a secondary system: 120/240 V single-phase, or 208Y/120 V or 480Y/277 V three-phase. |
| SES | Service Entrance Section. Its service voltage must match its transformer: 120/240 V 1Φ ← 120/240 V transformer; 120/208 V 1Φ and 208Y/120 V 3Φ ← 208Y/120 V; 480Y/277 V 3Φ ← 480Y/277 V. Single SES or multi-pack (multi-meter) SES — chosen in the equipment panel; a multi-pack SES requires a three-phase transformer. |
| Pole | Wood distribution pole, 30–60 ft, class 1–6. Electrically a pass-through point, a pole-mounted transformer, or a supply source. Framing (tangent / angle / dead-end / junction) follows the primary line. |
| Span | An overhead section between two poles (or a pole and an SES: service drop). Carries ACSR primary/feeder (phases + neutral) or aluminum duplex/triplex/quadruplex secondary, service and streetlight wire. |
| Riser | A pole where a trench joins the overhead: conduit and U-guard down the pole; a primary riser has cutouts, arresters and cable terminators, and its cutout fuse protects the downstream side. |
| Down guy & anchor | Required where unbalanced line tension exceeds 25% of the largest span tension: dead-ends, angles over about 14°, junctions. |
| Streetlight J-box | A handhole on the lighting circuit. Lighting runs go transformer → J-box, J-box → J-box, and J-box → streetlight (one J-box per pole). |
| Streetlight | An LED fixture on a pole. Current = W ÷ 0.9 ÷ fixture voltage. Fixture voltage must be available from the feeding transformer: 120/240 V → 120 or 240 V; 208Y/120 V → 120 or 208 V; 480Y/277 V → 277 or 480 V. Lit = connected and passing. |
| Traffic signal | An intersection signal pole: one mast arm with three red / yellow / green heads and a streetlight on top of the mast. Four per intersection, each on the far side facing oncoming traffic. A lighting load fed through a J-box at the pole like a streetlight; default 400 W at 120 V. Energized signals cycle green → yellow → all red on each street in turn. |
| Transformer cable positions | Secondary cable positions on a transformer: single-phase 6; three-phase 6 up to 500 kVA and 10 from 750 kVA (pad-mount and pole-mount alike). Each Service or Lighting cable set ending at the transformer (per parallel set) uses one. |
| Segment | All groups of one system (Feeder, Primary, Service or Lighting) in one trench. They share the segment load and their capacity is combined. |
| Parallel sets | Entered independently; combined reference ampacity = per-conductor reference × sets. Phase completeness is not validated. |
| Energization indicator | Grey = not energized; blinking green = connected and passing; blinking amber = connected with a design issue. |
1Φ: kVA = V × A ÷ 1000 (V = 240 for 120/240, 208 for 120/208). 3Φ: kVA = √3 × VLL × A ÷ 1000.
3Φ: A = kVA ÷ (√3 × 12.47 kV). 1Φ: A = kVA ÷ 7.2 kV (line-to-neutral). A branch may mix single- and three-phase transformers: three-phase kVA splits over A, B and C, each single-phase unit loads its selected phase, and the branch current is the most heavily loaded phase. Primary and fuse loading use downstream transformer nameplate kVA; feeder segments sum every transformer fed from cabinets downstream.
Each service segment carries the total demand of every SES downstream of it (for example, a transformer → pull box run feeding two SES).
VD% = k × I × R × L ÷ 1000 ÷ V × 100, with k = 2 (1Φ) or √3 (3Φ), R = DC resistance of aluminum at 75 °C (Ω/1000 ft, divided by parallel sets), L = route length in ft. Accumulated transformer → SES, and transformer → streetlight. ≤3% recommended; >5% fails. Reactance and transformer impedance are ignored.
Pole setting depth = 10% of height + 2 ft; primary attaches 1 ft below the top, neutral 3 ft lower, secondary 5 ft below primary. With feeder and primary on one pole the feeder takes the top arm and the primary is underbuilt 4 ft below it (neutral and secondary move down with it). Sag = w·L² ÷ (8·T) with T = 15% of rated breaking strength (final). Minimum clearance: primary 18.5 ft over roads, 14.5 ft elsewhere; secondary/service/lighting 16 ft over roads, 12 ft elsewhere. Max span: primary/feeder 300 ft, secondary 150 ft, lighting 200 ft, service drop 100 ft. Unbalanced tension = vector sum of span tensions; guy required above 25% of the largest. Pole-transformer cutout: full-load primary current ≤ fuse ≤ 3× (min 3 A). Riser cutout: downstream transformer nameplate current ≤ fuse ≤ 3× (min 10 A). Overhead ampacity: bare ACSR at 75 °C conductor, 25 °C ambient, 2 ft/s wind. Training values, not NESC design; no pole-strength calculation.
Fixture VA = W ÷ 0.9. Fixture current = VA ÷ fixture voltage. Each lighting segment carries the sum of the currents of the streetlights downstream of it (single-phase, 2-wire). Lighting kVA is added to the feeding transformer’s loading. Defaults: 150 W LED at 240 V, #6 AL duplex in 1.5 in conduit at 24 in cover. No photocell, contactor or branch-fuse modelling.
4 quadrants × 3 positions = 12. Every feeder way (incoming, outgoing, or the source feed at a supply-source cabinet) takes a whole quadrant, allocated from Q4 down. A three-phase primary branch takes a whole free quadrant; single-phase branches take single positions from Q1 up and share quadrants. A source pole keeps a 6-position breaker / branch-fuse panel.
Fuse ≥ branch current, ≤ smallest primary conductor reference ampacity on the branch, and flagged as oversized above 3× branch current (minimum 10 A). Not a coordination study.
Trench lengths use 3 ft per model unit (300 ft × 300 ft blocks). Cross-section cover (primary 36 in, service and lighting 24 in) is a nominal training value. No derating, conduit fill, short-circuit or code-compliance checks.
If a building stays dark, open the Issues list or select the building — it states the first reason. Common causes: no supply source, an incomplete group, a voltage mismatch between SES and transformer, a missing or oversized fuse, or excessive voltage drop. If the city does not load, confirm the assets/environment folder is beside index.html, and make sure the device has internet access for the 3D rendering library. A streetlight that stays dark: select it — it states the first reason (not fed, fixture voltage not available from its transformer, voltage drop, or an upstream problem).