⚡ SPDA Risk Assessment Tool

Lightning protection risk assessment, SPDA sizing and SPD zoning per ABNT NBR 5419:2026 (Parts 2, 3 and 4)

▶ Try the live demo

---

📸 Preview

---

🎯 The Problem

Risk assessment under NBR 5419-2 requires combining dozens of normative tables and structural/environmental parameters into a multi-step probability calculation. Commercial software for this is expensive, generic, and not built around how Brazilian engineers actually move through the standard section by section. Most practitioners fall back on spreadsheets that are error-prone and hard to audit.

✅ The Solution

A guided 11-module wizard that walks through the full NBR 5419 workflow: risk assessment per Part 2 (structure characterization through final risk comparison, R ≤ R_T), physical SPDA sizing per Part 3, surge protection measures (MPS) per Part 4, calculation memory and the final PDF report:

Feature	Description
🗺️ Automatic N_G lookup	Lightning flash density for any of Brazil's ~5,570 municipalities, sourced from the standard's official Table F.1 (Annex F)
🧮 Full calculation engine	Implements the standard's risk components (R1 to R4) and loss factors
🏗️ SPDA sizing (Part 3)	Physical dimensioning of the lightning protection system based on the selected protection level
🔌 Surge protection (Part 4)	Lightning protection zones (ZPR 0A, 0B, 1, 2) and SPD (DPS) specification
📑 Calculation memory	Step-by-step record of every input, table lookup and intermediate result
✏️ Auditable manual override	Any auto-calculated value can be manually adjusted. The original normative value is always preserved
💾 Offline-first persistence	Data saved locally via localStorage, with JSON export/import
🖨️ PDF report generation	Native browser print engine, no server round-trip

Note: the tool's interface is in Portuguese, as it implements a Brazilian regulatory standard (NBR 5419) for the Brazilian engineering market. Code identifiers and comments inside the engine also follow the standard's Portuguese terminology (for example calc_distanciaSeguranca, L_A, P_SPD), so each line can be checked against the clause it implements. Documentation is in English.

🛠️ Tech Stack

Vanilla HTML, CSS and JavaScript. No framework, no build step, no dependencies. The calculation engine is written as native ES modules that run unchanged in the browser and in Node; everything runs client-side.

🏗️ Architecture

The engine is separated from the interface. Every normative formula and table lives in src/engine, one module per part of the standard, and none of it touches the DOM. The interface reads the user's inputs, calls the engine and renders the results.

index.html                      markup and styles
src/
  main.js                       browser entry: imports the engine and exposes it to the interface
  engine/
    nbr5419-2.js                Part 2: Annexes A, B and C (N, P, L), risk components, tolerable risk
    nbr5419-2-anexo-d.js        Part 2, Annex D: economic risk R4 and cost-benefit of protection
    nbr5419-3.js                Part 3: protection angle, earth electrode, down conductors, k_c, separation distance
    nbr5419-4.js                Part 4: protection zones, Tables 1, A.1 and D.1, coordinated SPDs (Annex C)
    nbr5419-4-anexo-a.js        Part 4, Annex A: grid shields, magnetic field, induced loop voltages
    analise-risco.js            complete analysis (R1, R3, F) with its calculation memory, and R4
    mps.js                      SPD points and field evaluations from the surge protection module
    quantitativo-materiais.js   estimated bill of materials for the sized SPDA
    index.js                    single import point (used by the tests)
  data/
    municipios.js               N_G for 5,572 municipalities (Annex F, Table F.1)
js/app.js                       interface: 11-module wizard, persistence, report
test/                           node --test suites and the characterization baseline

flowchart LR
    U[Engineer] -->|wizard inputs| APP[js/app.js<br/>interface]
    APP -->|analysis state| AR[analise-risco.js]
    AR --> P2[nbr5419-2.js<br/>N, P, L, R]
    AR --> D[nbr5419-2-anexo-d.js<br/>R4, cost]
    APP --> P3[nbr5419-3.js<br/>SPDA sizing]
    APP --> MPS[mps.js]
    MPS --> P4[nbr5419-4.js<br/>SPD, Annex C]
    MPS --> A[nbr5419-4-anexo-a.js<br/>fields, Annex A]
    AR -->|results + memory| APP
    APP --> R[Report / PDF]

Design decisions

以上為 README 的開頭部分。其餘內容請閱讀原文。 檢視完整 README ↗