Docs Menu
Engineering Study Types Reference
Choose the calculation, supply its electrical inputs, and review the method and limits of the returned result.
Choose a Study
In Setup & Run, choose Study, then Engine. Changing the study selects its default engine. Auto lets the service select the engine. Check Engine Status before submitting a run.
Map Scope uses captured map features. Selected Assets narrows that scope. Circuit Revision uses a published revision from the selected project. This panel enables circuit revisions for Model Quality, Power Flow, Contingency Analysis, the sensitivity studies, and Cross-check. Use map-derived inputs for the other study types in this panel.
Study Catalogue
| Study | Default engine | Purpose |
|---|---|---|
| Model Quality | pandapower | Check topology and engineering-data completeness. |
| Connection Readiness | OpenDSS | Review the connection point and screen added generation. |
| Power Flow | pandapower | Calculate steady-state voltages, flows and loading. |
| Hosting Capacity | OpenDSS | Test added generation in steps. |
| Contingency Analysis | pandapower | Check outage cases for supply loss and electrical violations. |
| DC Sensitivity Analysis | pandapower | Calculate injection and outage distribution factors. |
| PTDF / LODF | pandapower | Use the same sensitivity calculation with selected element IDs. |
| P-V Curve | pandapower | Scale one load and inspect voltage and loading. |
| Q-V Curve | pandapower | Vary reactive injection at one bus. |
| AC Transfer Limit | pandapower | Vary active-power transfer between two buses. |
| Dispatch Optimisation | PyPSA | Optimise dispatch and request an AC feasibility check. |
| Security-Constrained Dispatch | PyPSA | Use the dispatch path with supported security constraints and AC checks. |
| Short-Circuit Screening | pandapower | Calculate fault current and assess supplied breaker ratings. |
| Protection Coordination | pandapower | Screen device coverage and clearing-time margins. |
| Time-Series Profiles | pandapower | Evaluate hourly load and generation profiles. |
| Planning Scenario | PyPSA | Optimise dispatch for a network snapshot. |
| Cross-check | GridCal / VeraGrid | Run a secondary voltage and loading calculation. |
The study list comes from the service. The built-in sensitivity label is PTDF / LODF Sensitivity. Select only a study offered by your current list. Engine availability and model readiness still determine whether the calculation can run.
Shared Inputs
Review Connection Request and Engineering Assumptions for every map-based run. A positive connection request can add load or generation to the converted model. The first selected asset identifies the point of connection. These inputs are not measured equipment data.
| Group | Controls | Review |
|---|---|---|
| Connection request | Connection Type, Direction, Requested MW, Requested kV, Power Factor, Notes | Check the requested equipment, capacity, voltage and import/export direction. |
| Network Base | Base MVA, Frequency Hz, Nominal voltage kV | Use the correct system base and voltage. A circuit supplies its model base. |
| Operating Constraints | Voltage lower pu, Voltage upper pu, Thermal warning %, Thermal limit %, Grid supply limit MW | Confirm which limits the selected method assesses. A control value alone is not evidence that a check ran. |
| DER & Growth | DER step MW, DER maximum MW, Load growth % | Set the hosting sweep range and profile-growth assumption. |
| Network state | Reliability Criterion, Include normally-open switches | Choose the intended assumptions. Select an outage study to assess contingencies. |
| Operating Case | Run-only dispatch, service state and switching; Rating set | For a circuit revision, check the overrides and selected rating set. The published revision remains unchanged. |
See Running Engineering Studies for the setup sequence, initial shared values, operating-case controls and readiness checks.
Model Quality
Model Quality has no extra study-specific controls. Review Model Diagnostics, Model Counts, and Engineering Data Validation. These identify topology, data and coverage issues. Model Composition shows asset counts. Geometry and counts are not solved electrical results.
Use the findings to check bus references, source information, voltage, branch ratings, impedance and protection data. A readiness score describes the reported checks; it does not prove the model is accurate or complete.
Power Flow
Power Flow calculates steady-state AC conditions. Supply connected buses, sources, loads, generation, impedances and ratings. There are no extra numeric study controls in this panel.
With pandapower, review pandapower Bus Voltages, pandapower Line Loading, pandapower Transformer Loading, and the three-winding transformer and operating-point tables when present. Check voltage in pu, loading in percent, active power in MW and reactive power in MVAr. Check each branch terminal and its direction before comparing signs.
The voltage chart and result layers help locate findings. An element can have a table result without map geometry. Missing equipment ratings cannot establish a loading pass.
Connection Readiness and Hosting Capacity
Connection Readiness combines conversion diagnostics with connection-point information and a hosting screen. Review the connection bus, requested MW and kV, direction, warnings and blocking issues. It is separate from the Connection Study workspace.
Hosting Capacity varies generation at the connection bus. Set DER step MW, DER maximum MW, the voltage band and connection request. Review Incremental DER Hosting Sweep, Hosting Sweep Headroom, and the reported method.
opendss_step_solveuses separate solver cases.radial_downstream_screenreports an estimated path-based screen, not a solved AC hosting limit.- Read each candidate's status and binding constraint. The largest tested passing step is bounded by the range tested.
- Assess import capacity and battery charging through their relevant operating cases and dispatch studies.
See Hosting Capacity Screening for the full workflow.
Contingency Analysis
Set Max Contingencies for a map-based study. For a circuit revision, choose Limit contingency cases only when you intend to run a subset, then set Max Contingencies. Leave the limit off to request all eligible circuit cases.
Review N-1 Branch Contingency Summary. Check the evaluated case and actions, disconnected load, loading, voltage violations, severity and notes. A case can have more than one problem. Compare evaluated and eligible cases before making an N-1 claim.
pandapower_runppuses AC solutions for the outage cases.radial_downstream_screenis a topology and estimated-loading screen.- A non-converged case has no usable solved operating state. It must not be counted as a passed case.
DC Sensitivity Analysis and PTDF / LODF
Use Monitored branch IDs, Outage branch IDs, and Injection bus IDs to select exact model IDs. Separate IDs with commas or newlines. Blank selections request all eligible elements. Narrow the selections if the service reports a calculation-size limit.
The method pandapower_pypower_dc_jacobian produces DC PTDF Matrix and DC LODF Matrix.
- PTDF describes the change in monitored active flow for an injection change, balanced by the solver's reference treatment.
- LODF describes the change in monitored flow relative to the pre-outage flow of the outaged branch.
- These are DC factors. They do not assess AC voltage, reactive limits or dynamic stability.
- An unavailable factor is not zero.
AC Sweep Studies
P-V Curve, Q-V Curve, and AC Transfer Limit use repeated steady-state AC solutions. Blank fields use the service defaults shown as placeholders. Enter a whole-number Sweep Steps from 2 to 201. Review convergence and violations for every tested point.
| Study | Controls | Result and limits |
|---|---|---|
| P-V Curve | Load ID, Start Load Scale, Stop Load Scale, Sweep Steps | Start scale must be non-negative; stop must exceed start. The sweep scales one load's active and reactive power together. AC P-V Curve reports load scale, target load MW, minimum network voltage, maximum loading and convergence. |
| Q-V Curve | Bus ID, Q Min MVAr, Q Max MVAr, Sweep Steps | Q maximum must exceed Q minimum. Positive injection supplies reactive power; negative injection absorbs it. AC Q-V Curve reports the selected bus voltage and network loading. |
| AC Transfer Limit | Source Bus ID, Sink Bus ID, Max Transfer MW, Sweep Steps | Use different source and sink buses and a positive maximum transfer. AC Transfer Capability reports tested MW, voltage, loading, convergence and feasibility. |
Short-Circuit Screening
Choose Fault Type: Three-phase, Line-line, or Line-ground. Review Fault Types Computed; the primary reported type stays selected.
| Control | What to supply |
|---|---|
| Fault Resistance Rf (ohm) / Fault Reactance Xf (ohm) | Fault impedance in ohms. Resistance must be non-negative. Blank fields use a bolted fault. |
| Source Fault MVA | The maximum source fault level, supported by source evidence. |
| Min Fault MVA | A positive minimum system-normal fault level no greater than the maximum. Do not copy the maximum solely to pass validation. |
| Source R/X Ratio | Source resistance divided by reactance. This is not X/R. |
| Standard Profile | IEC 60909, ANSI duty screen, or Screening. Check the returned method; the selection alone does not prove a standards-based solve. |
| Breaker Rating kA | A screening assumption. Supply actual breaker ratings in the model for equipment-duty checks. |
Read Method, Standard and Execution. pandapower_calc_sc is the IEC 60909 solver method. path_impedance_screen is a deterministic estimate. Do not treat the estimate as an IEC calculation.
In Short-Circuit Screening, review maximum and minimum three-phase, line-line and line-ground currents where calculated. Initial symmetrical current is an RMS quantity in kA. Peak making current and thermal-equivalent current are different quantities. Match each value to the correct equipment rating and calculation duration.
Read Duty Status and Duty Violations. Missing interrupting or making ratings leave the corresponding duty unassessed. Use System Strength at Connection Point to select Connection Bus and enter positive Rated MW (P_rated). Its SCR uses minimum fault MVA divided by rated MW. This changes the displayed ratio, not the fault calculation. See Engineering Study Results and Statuses.
Protection Coordination
Set Coordination Margin s, Default Fault kA, Source Fault MVA, and Breaker Rating kA. Supply device IDs, protected branches, service state, pickup, clearing-time information and interrupting ratings in the model.
The method topology_tcc_screen is a deterministic screen. Review Protection Devices, Protection Coverage, and Protection Coordination Checks. Coordination margin is upstream clearing time minus downstream clearing time. Check that the paired devices and time-current information are appropriate for the network.
Device presence is not proof of adequate protection. Missing ratings or timing evidence leave those checks unassessed. This screen does not replace a detailed protection-setting study.
Time-Series Profiles
Enter 24 non-negative hourly multipliers, separated by commas, in Load Profile and Generation Profile. A multiplier is dimensionless. Blank controls use built-in profiles. Load growth % adjusts the load scaling. Replace generic profiles with values appropriate to the study.
Review 24-Hour Profile Screening and 24-Hour Loading Screen. Check hourly load and generation, loading, headroom, voltage, status and the reported method. pandapower_runpp uses hourly AC snapshots. radial_downstream_screen provides estimates. An estimated hour is not a solved AC hour.
Review Solved Hours, Failed Hours and the peak case before using the result. This study does not perform chronological battery dispatch or unit commitment.
Planning Scenario and Dispatch
Planning Scenario uses a single PyPSA network snapshot. It has no extra study-specific controls in this panel. Supply usable generation, load, costs, impedances and ratings. Review PyPSA Generator Dispatch and PyPSA SCED Line Flows. The objective is an operating cost for the model's snapshot and cost basis, not an annual bill or project NPV.
Dispatch Optimisation and Security-Constrained Dispatch require controllable generation with explicit operating limits and costs. These inputs belong in the model; this panel has no separate cost editor. These types request a post-dispatch AC check. Review SCED Feasibility, SCED Post-Dispatch AC Feasibility, and SCED Post-Dispatch AC N-1 Summary when returned.
A DC-feasible dispatch can fail AC checks. Confirm the actual assessed cases and ratings before using an ac_feasible result. This panel does not enable these dispatch types for Circuit Revision. Do not infer a circuit-based security-constrained workflow from the study name.
Cross-check
Cross-check uses GridCal / VeraGrid for a secondary power-flow calculation. It has no extra study-specific controls. Review GridCal / VeraGrid Bus Voltages, GridCal / VeraGrid Branch Loading, and GridCal / VeraGrid Voltage Cross-check when returned. Compare like-for-like models, assumptions and operating cases. A second-engine result is not an automatic reconciliation of every value.
Related Guides
- Running Engineering Studies
- Engineering Study Results and Statuses
- Engineering Plot Studio
- Hosting Capacity Screening
- Network Model Import and Validation