Skip to main content
Docs / Grid Circuit Element Reference
Docs Menu

Grid Circuit Element Reference

Use this reference to enter equipment properties and check the defaults in a new Grid Circuit Builder component.

How to Use the Fields

  1. Select equipment in Grid Circuit Builder.
  2. Set Name and check Equipment type.
  3. Enter the normal properties.
  4. Select Show advanced and sequence fields to expose fields marked Advanced below.
  5. Review Validation, then save a revision.
Generator property fields in Grid Circuit Builder for the illustrative circuit.
Select an element to see and edit its fields.

Units are part of each field label. Values shown under Default use those units. “Blank” means no value is supplied. A new-component default is an editable starting value, not verified asset data. Imported data can have different values and review requirements.

Use a finite number for numeric fields. Do not put unit text in a numeric input. Select fields use the choices shown below. Checkbox defaults are shown as selected or cleared. In service controls equipment availability where the field is present. Minima must not exceed maxima.

A field in the editor does not mean every study engine supports it. Check readiness for the chosen study. Supply missing electrical values before strict circuit export; do not replace unknown values with invented ratings, voltages, or impedances.

Grid Source

Connect to one bus. The voltage setpoint and angle define the reference source. Fault and sequence fields support studies that need source strength. Leave unknown fault values blank until you have verified data.

FieldInput or choicesDefaultDisplay
Voltage setpoint (p.u.)Number1Standard
Angle (degrees)Number0Standard
Legacy source fault level (MVA)NumberBlankStandard
Maximum fault level (MVA)NumberBlankStandard
Minimum fault level (MVA)NumberBlankStandard
Maximum-case R/X ratioNumberBlankAdvanced
Minimum-case R/X ratioNumberBlankAdvanced
Maximum-case X0/X1 ratioNumberBlankAdvanced
Maximum-case R0/X0 ratioNumberBlankAdvanced
Minimum-case X0/X1 ratioNumberBlankAdvanced
Minimum-case R0/X0 ratioNumberBlankAdvanced
Slack participation factorNumberBlankAdvanced
In serviceCheckboxSelectedStandard

Substation and Bus / Node

Enter a positive nominal voltage. Both types use this same field set. The bus types are PQ, PV, Swing, and Isolated. A bus or substation can connect to several equipment terminals. Each equipment terminal connects only once. The model must have a grid source for each connected island.

FieldInput or choicesDefaultDisplay
Nominal voltage (kV)NumberBlankStandard
PSS/E bus numberNumberBlankStandard
Bus typePQ; PV; Swing; IsolatedPQStandard
Area numberNumberBlankStandard
Zone numberNumberBlankStandard
Owner numberNumberBlankStandard
Initial voltage (p.u.)NumberBlankStandard
Initial angle (degrees)NumberBlankStandard
Minimum voltage (p.u.)Number0.95Standard
Maximum voltage (p.u.)Number1.05Standard
Emergency minimum voltage (p.u.)NumberBlankAdvanced
Emergency maximum voltage (p.u.)NumberBlankAdvanced

Line and Cable

Enter R, X, and a positive normal rating. R can be zero; R and X cannot both be zero. Impedances here are total ohms for the element, not ohms per kilometer. The length field is in kilometers. Connect one distinct bus to each end.

FieldInput or choicesDefaultDisplay
Nominal voltage (kV)NumberBlankStandard
Length (km)NumberBlankStandard
Positive-sequence R (ohm)NumberBlankStandard
Positive-sequence X (ohm)NumberBlankStandard
Positive-sequence B (S)NumberBlankStandard
Normal rating (MVA)NumberBlankStandard
RATE A (MVA)NumberBlankStandard
RATE B (MVA)NumberBlankStandard
RATE C (MVA)NumberBlankStandard
Circuit IDText1Standard
In serviceCheckboxSelectedStandard
Negative-sequence R2 (ohm)NumberBlankAdvanced
Negative-sequence X2 (ohm)NumberBlankAdvanced
Negative-sequence B2 (S)NumberBlankAdvanced
Zero-sequence R0 (ohm)NumberBlankAdvanced
Zero-sequence X0 (ohm)NumberBlankAdvanced
Zero-sequence B0 (S)NumberBlankAdvanced
From-end conductance (S)NumberBlankAdvanced
From-end susceptance (S)NumberBlankAdvanced
To-end conductance (S)NumberBlankAdvanced
To-end susceptance (S)NumberBlankAdvanced

2-winding Transformer

Enter rating, high-side voltage, low-side voltage, R, and X. The high-side voltage must exceed the low-side voltage. R and X cannot both be zero. A non-neutral tap or voltage control also requires the tap side, neutral position, minimum and maximum positions, and step size. Match each winding to the correct bus voltage.

FieldInput or choicesDefaultDisplay
Rating (MVA)NumberBlankStandard
High-side voltage (kV)NumberBlankStandard
Low-side voltage (kV)NumberBlankStandard
Positive-sequence R (p.u.)NumberBlankStandard
Positive-sequence X (p.u.)NumberBlankStandard
RATE A (MVA)NumberBlankStandard
RATE B (MVA)NumberBlankStandard
RATE C (MVA)NumberBlankStandard
Tap ratioNumber1Standard
Tap sideHV; LVHVStandard
Neutral tap positionNumberBlankAdvanced
Minimum tap positionNumberBlankAdvanced
Maximum tap positionNumberBlankAdvanced
Tap step (%)NumberBlankAdvanced
Phase shift (degrees)Number0Standard
Control modeFixed; VoltageFixedAdvanced
Control targetNumberBlankAdvanced
Control deadbandNumberBlankAdvanced
Regulated busTextBlankAdvanced
Vector groupTextBlankAdvanced
HV groundingTextBlankAdvanced
LV groundingTextBlankAdvanced
Zero-sequence R0 (p.u.)NumberBlankAdvanced
Zero-sequence X0 (p.u.)NumberBlankAdvanced
Zero-sequence magnetizing impedance (%)NumberBlankAdvanced
Zero-sequence magnetizing R/X ratioNumberBlankAdvanced
HV share of zero-sequence impedanceNumberBlankAdvanced
Impedance base (MVA)NumberBlankAdvanced
Magnetizing conductance (p.u.)NumberBlankAdvanced
Magnetizing susceptance (p.u.)NumberBlankAdvanced
Circuit IDText1Standard
In serviceCheckboxSelectedStandard

3-winding Transformer

Enter all three winding voltages and ratings. Enter R, X, and an MVA base for each winding pair. HV voltage must be at least MV voltage, and MV must be at least LV voltage. Each winding needs a different bus. Tap controls need the same supporting tap fields as a two-winding transformer.

FieldInput or choicesDefaultDisplay
HV voltage (kV)NumberBlankStandard
MV voltage (kV)NumberBlankStandard
LV voltage (kV)NumberBlankStandard
HV rating (MVA)NumberBlankStandard
MV rating (MVA)NumberBlankStandard
LV rating (MVA)NumberBlankStandard
HV-MV R (p.u.)NumberBlankStandard
HV-MV X (p.u.)NumberBlankStandard
HV-MV base (MVA)NumberBlankStandard
MV-LV R (p.u.)NumberBlankStandard
MV-LV X (p.u.)NumberBlankStandard
MV-LV base (MVA)NumberBlankStandard
HV-LV R (p.u.)NumberBlankStandard
HV-LV X (p.u.)NumberBlankStandard
HV-LV base (MVA)NumberBlankStandard
Tap sideHV; MV; LVHVStandard
Tap ratioNumber1Standard
Neutral tap positionNumberBlankAdvanced
Minimum tap positionNumberBlankAdvanced
Maximum tap positionNumberBlankAdvanced
Tap step (%)NumberBlankAdvanced
HV phase shift (degrees)Number0Advanced
MV phase shift (degrees)Number0Advanced
LV phase shift (degrees)Number0Advanced
Control modeFixed; VoltageFixedAdvanced
Control targetNumberBlankAdvanced
Control deadbandNumberBlankAdvanced
Regulated busTextBlankAdvanced
Vector groupTextBlankAdvanced
HV groundingTextBlankAdvanced
MV groundingTextBlankAdvanced
LV groundingTextBlankAdvanced
HV-MV zero-sequence R0 (p.u.)NumberBlankAdvanced
HV-MV zero-sequence X0 (p.u.)NumberBlankAdvanced
MV-LV zero-sequence R0 (p.u.)NumberBlankAdvanced
MV-LV zero-sequence X0 (p.u.)NumberBlankAdvanced
HV-LV zero-sequence R0 (p.u.)NumberBlankAdvanced
HV-LV zero-sequence X0 (p.u.)NumberBlankAdvanced
Circuit IDText1Standard
In serviceCheckboxSelectedStandard

Generator

Enter a positive maximum power. Keep active and reactive operating values inside the limits you supply. Sequence and grounding fields describe short-circuit behavior; the available study engine determines which fields it can use.

FieldInput or choicesDefaultDisplay
Machine IDText1Standard
Active power (MW)Number0Standard
Reactive power (MVAr)Number0Standard
Maximum power (MW)NumberBlankStandard
Minimum power (MW)Number0Standard
Maximum reactive power (MVAr)NumberBlankStandard
Minimum reactive power (MVAr)NumberBlankStandard
Machine base (MVA)NumberBlankStandard
Voltage setpoint (p.u.)NumberBlankStandard
Remote regulated busTextBlankAdvanced
Dispatch participation factorNumberBlankAdvanced
Linear cost (/MWh)NumberBlankAdvanced
Constant costNumberBlankAdvanced
Positive-sequence R1 (p.u.)NumberBlankAdvanced
Subtransient X1 (p.u.)NumberBlankAdvanced
Negative-sequence R2 (p.u.)NumberBlankAdvanced
Negative-sequence X2 (p.u.)NumberBlankAdvanced
Zero-sequence R0 (p.u.)NumberBlankAdvanced
Zero-sequence X0 (p.u.)NumberBlankAdvanced
Grounding R0 (p.u.)NumberBlankAdvanced
Grounding X0 (p.u.)NumberBlankAdvanced
Short-circuit current ratioNumberBlankAdvanced
Owner numberNumberBlankAdvanced
TechnologyTextBlankStandard
Dispatch controllableCheckboxSelectedAdvanced
In serviceCheckboxSelectedStandard

Storage

Enter base injection and positive energy capacity. Positive base injection means discharge; negative means charging. Rated power capacity is separate from the current operating point. Keep operating power inside the limits you supply.

FieldInput or choicesDefaultDisplay
Base injection (+ discharge, MW)NumberBlankStandard
Rated power capacity (MW)NumberBlankAdvanced
Energy (MWh)NumberBlankStandard
Reactive power (MVAr)Number0Standard
Minimum power (MW)NumberBlankAdvanced
Maximum power (MW)NumberBlankAdvanced
Minimum reactive power (MVAr)NumberBlankAdvanced
Maximum reactive power (MVAr)NumberBlankAdvanced
Voltage setpoint (p.u.)NumberBlankAdvanced
Dispatch controllableCheckboxSelectedAdvanced
In serviceCheckboxSelectedStandard

Load

Enter active demand in MW. Zero demand is allowed. The constant-current and constant-admittance fields describe additional load components. Enter a profile ID only when you have a matching study profile.

FieldInput or choicesDefaultDisplay
Active power (MW)Number0Standard
Reactive power (MVAr)Number0Standard
Constant-current P (MW)Number0Advanced
Constant-current Q (MVAr)Number0Advanced
Constant-admittance P (MW)Number0Advanced
Constant-admittance Q (MVAr)Number0Advanced
Area numberNumberBlankAdvanced
Zone numberNumberBlankAdvanced
Owner numberNumberBlankAdvanced
Profile IDTextBlankAdvanced
In serviceCheckboxSelectedStandard

Induction Motor

Supply rated power, efficiency, power factor, locked-rotor current ratio, and R/X ratio. Efficiency must be greater than zero and no more than 100%. Power factor must be greater than zero and no more than one.

FieldInput or choicesDefaultDisplay
Rated power (MW)NumberBlankStandard
Efficiency (%)Number95Standard
Power factorNumber0.9Standard
Locked-rotor current ratioNumberBlankStandard
R/X ratioNumberBlankStandard
In serviceCheckboxSelectedStandard

Fixed Shunt

Conductance and susceptance are specified as MW and MVAr at 1 p.u. voltage.

FieldInput or choicesDefaultDisplay
Shunt IDText1Standard
Conductance at 1 p.u. (MW)Number0Standard
Susceptance at 1 p.u. (MVAr)Number0Standard
In serviceCheckboxSelectedStandard

Switched Shunt

Select fixed, discrete-voltage, or continuous-voltage control. Step blocks must be a JSON array with at most eight entries. Each entry has integer steps from 1 to 999 and a finite bPerStepMvar value. Example: [{"steps": 2, "bPerStepMvar": 5}].

FieldInput or choicesDefaultDisplay
Shunt IDText1Standard
Control modeFixed; Discrete voltage; Continuous voltageFixedStandard
Initial susceptance (MVAr)Number0Standard
Voltage target (p.u.)NumberBlankStandard
Voltage deadband (p.u.)NumberBlankStandard
Remote regulated busTextBlankAdvanced
Step blocks (JSON)JSON array[]Advanced
In serviceCheckboxSelectedStandard

HVDC Link

Connect distinct buses at the two ends. Select VSC or LCC technology, then fixed-power or voltage/power control. Enter losses and limits from the model source. Simplified steady-state control is not a dynamic converter model.

FieldInput or choicesDefaultDisplay
TechnologyVSC; LCCVSCStandard
Control modeFixed power; Voltage / powerFixed powerStandard
From-end active power (MW)Number0Standard
From-end reactive power (MVAr)Number0Standard
To-end reactive power (MVAr)Number0Standard
Minimum active power (MW)NumberBlankStandard
Maximum active power (MW)NumberBlankStandard
From-end minimum MVArNumberBlankAdvanced
From-end maximum MVArNumberBlankAdvanced
To-end minimum MVArNumberBlankAdvanced
To-end maximum MVArNumberBlankAdvanced
Fixed loss (MW)Number0Standard
Variable loss (%)Number0Standard
From-end voltage setpoint (p.u.)NumberBlankAdvanced
To-end voltage setpoint (p.u.)NumberBlankAdvanced
Simplified steady-state controlCheckboxSelectedAdvanced
In serviceCheckboxSelectedStandard

SVC and STATCOM

Select Fixed MVAr or Voltage control. Enter operating injection and applicable reactive limits. Simplified steady-state control is not a dynamic control model.

FieldInput or choicesDefaultDisplay
Control modeFixed MVAr; Voltage controlFixed MVArStandard
Reactive injection (MVAr)Number0Standard
Minimum reactive power (MVAr)NumberBlankStandard
Maximum reactive power (MVAr)NumberBlankStandard
Voltage setpoint (p.u.)NumberBlankStandard
Remote regulated busTextBlankAdvanced
Simplified steady-state controlCheckboxSelectedAdvanced
In serviceCheckboxSelectedStandard

Switch and Disconnector

Closed joins the two connected buses electrically. Clear Closed for an open device. Opening switchgear can create an island that needs its own grid source.

FieldInput or choicesDefaultDisplay
ClosedCheckboxSelectedStandard

Breaker

Enter measured or specified protection settings and ratings where needed. The builder does not supply a default interrupting rating. Closed controls whether the device conducts.

FieldInput or choicesDefaultDisplay
ClosedCheckboxSelectedStandard
Pickup current (A)NumberBlankStandard
Clearing time (s)NumberBlankStandard
Interrupting rating (kA)NumberBlankStandard
Making rating peak (kA)NumberBlankAdvanced

Needs Mapping

Needs Mapping identifies imported equipment without an explicit supported type. It is not a component you can add from the palette. Select the item and choose its correct Equipment type. Then review its properties and connections. An unresolved equipment mapping blocks publication.

Circuit-Wide and Drawing Fields

Circuit name, Base power (MVA), and Frequency (Hz) apply to the whole circuit. A new circuit starts at 100 MVA and 50 Hz. PSS/E definitions and references contains JSON arrays for areas, zones, owners, subsystems, monitors, and contingencies.

Busbar orientation, Busbar length, and annotation position and width change the drawing only. They do not change geographic positions or electrical values.

Related Guides

Can't find what you need? Email support@networkmap.energy or call 1300 936 116. Sign in to Network Map.