- Home
- Documentation
- Protection coordination
Protection Coordination Study
pandapower
Protection coordination checks whether devices operate in the right order for a chosen fault. Electrisim runs IEC 60909 short-circuit, then evaluates fuses and overcurrent (and related) devices. You get trip or melt times, complete time-current (TCC) curves, and miscoordination warnings.
Simulate → Protection Coordination. Devices are assigned on the Protection tab of each Switch.
When to use
- Fuse melt and relay trip times for a fault at a bus or along a line
- Time-current grading between upstream and downstream devices (complete OCR TCC for DTOC, IDMT, and IDTOC)
- A first miscoordination screen on a radial feeder
Fuse; OCR DTOC / IDMT / IDTOC (IEC and IEEE/ANSI); earth-fault OCR; directional OCR; differential (87) and distance (21). Fuse currents near transformers follow pandapower short-circuit limits.
How to run
- Place switches on lines, transformers, or bus connections in your diagram (switches are required for protection assignment).
- Open each switch’s dialog → Protection tab. Choose Fuse (library or custom I–t curve) or OC relay (DTOC, IDMT, or IDTOC). For OCR, set subtype, inverse curve, trip times, and automatic or manual pickup currents (manual values are in amperes).
- Click Simulate → Protection Coordination.
- In the dialog, choose fault location (along a line or at a busbar), fault type (3ph / 2ph / 1ph), and case (max / min). Configure grading defaults on the Grading tab if switches leave fields empty.
- Review the results dialog: short-circuit summary, tripping table (including melting time for fuses), complete I–t / TCC chart, and miscoordination list. Optionally export a
.txtreport.
Fault location modes
| Mode | Description |
|---|---|
| Along a line | pandapower create_sc_bus inserts an intermediate fault bus on the selected line at fraction 0–1 (0.5 = mid-line). Set sc_line_id to a line index or all to sweep every in-service line. |
| At selected busbar | sc.calc_sc runs directly at the chosen bus with branch_results=True so fuse currents are available on adjacent branches. |
Dialog parameters
These fields are sent as ProtectionCoordinationPandaPower in the POST body together with network elements.
| Parameter | Description |
|---|---|
fault_location_mode |
line or bus |
fault_bus_id |
Diagram cell ID of the fault busbar (required when mode is bus) |
sc_line_id, sc_fraction |
Line index (or all) and fault position 0–1 (line mode) |
fault_type, case |
3ph / 2ph / 1ph and max / min short-circuit case |
grading_mode |
auto (pandapower topological grading) or manual (per-switch t_g / t_gg / tms / t_grade from the Switch dialog; supported for DTOC, IDMT, and IDTOC) |
curve_type, tms, t_grade, t_g, t_gg, t_diff |
Default IEC 60255 or IEEE C37.112 inverse curve and timing settings for relays without explicit values |
overload_factor, ct_current_factor, safety_factor |
Defaults for automatic OCR pickup current calculation |
show_curves, show_table, show_miscoordination, export_results |
Results display and export options |
Switch protection settings
Per-switch parameters are configured on the Switch dialog Protection tab (see also Switch):
- Fuse — library type (e.g. Siemens NH-2 series) or custom JSON curve (
t_min,t_total,x_min,x_total) plus rated current. - OC relay — DTOC, IDMT, or IDTOC; IEC or IEEE inverse curve; TMS, grading delay, instantaneous and backup trip times; automatic or manual pickup currents in amperes. See Overcurrent relays (OCR).
- Earth-fault OCR (50N/51N), directional OCR (67), differential (87), and distance (21) — configured on the same tab; 87 and 21 use Electrisim evaluators on the short-circuit results.
At least one switch with a protection device assigned is required; otherwise the study returns an error.
Overcurrent relays (OCR)
Assign Overcurrent Relay (OCR) on the Switch Protection tab. Subtype, curve, times, and pickups are taken from that switch; empty timing fields inherit the study Grading tab defaults.
| Subtype | Characteristic | Main settings |
|---|---|---|
| DTOC | Definite time: I>> trips at t_gg, I> trips at t_g |
I_g_a, I_gg_a (A); t_g, t_gg (s) |
| IDMT | Inverse time (IEC 60255 or IEEE C37.112) | I_s_a (A); tms, t_grade; curve_type |
| IDTOC | Combined: inverse segment up to I>, then definite I> / I>> steps | IDMT pickups and times plus DTOC I> / I>> settings |
- Time grading —
autouses pandapower topological grading.manualuses the per-switch times from the Switch dialog (t_g,t_gg,tms,t_grade). Manual grading is supported for DTOC, IDMT, and IDTOC, including a complete IDTOC TCC. - Pickup current —
autoderives pickups from line ratings and the overload / CT / safety factors.manualusesI_s_a,I_g_a, andI_gg_ain amperes (not kA). - Inverse curves — IEC 60255: standard, very, extremely, and long inverse (native pandapower OCRelay). IEEE C37.112 moderately / very / extremely inverse are evaluated by Electrisim from the same short-circuit results; trip times and TCC points are still returned.
- Evaluating engine — each relay is reported once, and the settings table shows whether it was solved by pandapower or the Electrisim evaluator. Electrisim takes over when pandapower cannot build the relay — most often because pandapower’s topological time grading requires every closed switch to sit on a line, so bus-bus ties or transformer switches make it fail. The reason is listed under Evaluation notes in the results dialog and in the
.txtreport.
Outputs
- Short-circuit summary — e.g. Ikss at the fault bus (kA).
- Tripping table — per switch: device type, tripped/melted flag, activation current (
activation_parameter_value, kA), trip/melt time (trip_melt_time_s, s). - Time-current chart — log-log TCC (Chart.js): complete relay/fuse characteristic (inverse segment and definite-time steps for IDTOC/DTOC) plus fault trip points.
- Miscoordination warnings — pairs of devices whose trip times are closer than the grading margin (
t_diff). - Export — optional
.txtdownload with the same summary fields.
Prerequisites and tips
- Valid network topology with external grid (or slack) and in-service switches on protected branches.
- For results comparable to pandapower fuse examples, match fuse types per feeder, avoid duplicate fuses on both ends of the same line unless intended, and align external-grid short-circuit strength (
s_sc_max_mva) with your reference case. - OCR relays require matplotlib in the backend environment (
pip install matplotlib).
Limitations
- Primary path is short-circuit based; overload (
scenario=pp) is optional when enabled in the study dialog. For motor-start voltage dip studies, use Motor Starting Analysis. - IEEE inverse curves, earth-fault OCR, directional OCR, differential (87), and distance (21) use Electrisim evaluators on SC results (not native pandapower device classes). DTOC, IDMT, and IDTOC with IEC curves use pandapower
OCRelaywhere the network allows it, otherwise the Electrisim evaluator with the same Switch dialog settings. - Line-end duplicate switches report identical branch currents by design.
- Subscription required in the cloud app (same gating as other premium analyses).
Technical references
Last updated: October 2026