Skip to main content
Docs / Grid Circuit Builder | Network Map Docs
Docs Menu

Grid Circuit Builder

Create a versioned electrical circuit, resolve model checks, and publish a revision for engineering studies.

Watch the Video: Grid Circuit Builder & Model Import (1:06)

Before You Start

Open Engineering Studies, then Grid Circuit Builder under Build & Organise. Engineering Studies requires Professional or Enterprise access. Select an engineering project in Session Context.

  • Project owners and editors can change circuits.
  • Viewers and commenters have read-only access.
  • A saved circuit revision is not automatically published.
  • Supply the electrical values needed by the intended study.

Create a Circuit

  1. Select New.
  2. Enter Circuit name in Circuit settings.
  3. Check Base power (MVA) and Frequency (Hz). A new circuit starts at 100 MVA and 50 Hz. Both values must be positive.
  4. Click equipment in Components, or drag it onto the canvas.
  5. Select an item and enter its values in Properties.
  6. Use Show advanced and sequence fields for sequence data, control limits, and other advanced properties.
Grid Circuit Builder drawing of the example five-bus mesh with buses, lines, generators and loads.
Grid Circuit Builder with a five-bus example circuit.

The palette includes grid sources, substations, buses, lines, cables, two- and three-winding transformers, generators, storage, loads, induction motors, shunts, HVDC links, SVCs, STATCOMs, switches, breakers, and disconnectors. See the element and field reference for every field and new-component default.

Connect Equipment

  1. Select Connect.
  2. Select a bus or substation.
  3. Select the equipment to connect to it.
  4. Repeat for each remaining terminal.
  5. Select Select to return to editing.

Each connection joins a bus or substation to an equipment terminal. Do not connect two buses directly. Place line, cable, transformer, or switchgear equipment between them. Single-terminal equipment needs one bus. Two-terminal equipment needs two distinct buses. A three-winding transformer needs three distinct buses. An equipment terminal cannot connect twice.

The builder uses the next unused equipment terminal. Check transformer HV, MV, and LV sides after connecting. Each electrical island needs a connected grid source.

Edit and Navigate

ControlUse
SelectSelect or drag equipment and annotation text. Select a connection to inspect its endpoints and provenance.
ConnectJoin bus and equipment terminals. Select the starting item again to cancel that connection.
PanDrag the background to move around the canvas.
SchematicView electrical symbols, busbars, connections, and annotations.
CardsView equipment cards.
DataFilter by ID, name, or kind. Use All equipment or an equipment type. Edit a row name and its first displayed property. Select the row for the full property editor.
Zoom in, Zoom out, Fit circuit to viewChange the view without changing electrical values.
Undo, RedoUndo or redo draft edits.
Delete selectedRemove the selected equipment and its connections. Associated callouts are also removed.
Remove linkDelete only the selected connection.

Scroll to pan when zoomed. Hold Ctrl or Command and scroll to zoom. Hold Shift while scrolling for horizontal movement. With canvas focus, use arrow keys to pan, plus or minus to zoom, and F or 0 to fit. Enter or Space selects a focused component, or connects it in Connect mode.

With focus inside the builder, Ctrl/Command+Z undoes an edit. Ctrl/Command+Shift+Z or Ctrl/Command+Y redoes it. Delete or Backspace removes the selection. These shortcuts do not remove equipment while you type in a field.

For a bus or substation, set Busbar orientation to Horizontal, the default, or Vertical. Set Busbar length to change the symbol. The initial length is 120 drawing units; the input range is 20 to 5,000. These are drawing settings, not electrical dimensions. The canvas uses an overview for large or zoomed-out circuits. Use Data and filters to inspect individual records.

Add Notes to the Drawing

  1. Under Schematic annotations, enter Text.
  2. Choose Type: Callout, Banner, or Note.
  3. Choose Tone: Neutral, Healthy, Warning, or Critical.
  4. Select Add annotation. A callout can attach to the selected equipment with Add annotation to selection.
  5. Select the annotation to edit Annotation text, Annotation type, Annotation tone, Horizontal position, Vertical position, or Text box width.
  6. Drag it in Select mode, or use Delete annotation to remove it.

The initial annotation type is Callout and the tone is Neutral. The initial text-box width is 200 drawing units; its input range is 80 to 1,200.

Use annotation tones to organise the drawing visually.

Edit Definitions

Expand PSS/E definitions and references to edit Areas, Zones, Owners, Subsystem definitions, Monitor definitions, and Contingency definitions. Each field must contain a JSON array. Changes apply when the field loses focus. Imported opaque attachments, including DYR data, remain attached to the circuit.

Import a Starting Model

  • Import > Current Single-Line Diagram captures the displayed map diagram. Review the preview before creating an unsaved draft.
  • Import PSS/E previews model files before Create circuit creates a saved circuit revision.

Save current draft changes before importing or changing circuits. See Network Model Import and Validation for supported files, import diagnostics, and reconciliation.

Check, Save, and Publish

  1. Read Validation. Correct missing values, invalid ranges, equipment mappings, terminal assignments, and unresolved import issues.
  2. Review warnings, even when there are no blocking errors.
  3. Enter a Revision message.
  4. Select Save revision.
  5. When the saved current revision is Ready to publish, select Publish.
  6. Wait for Published. The server validates the revision before making it available for studies.
Grid Circuit Builder side panel with Validation saying Circuit checks pass., the Revisions list with revision 2 published, and the PSS/E export options.
Check the circuit, then save and publish a revision.
StatusMeaning and next step
Unsaved changesEdits exist only in the current draft. Save a revision before export or publication.
SavedThe current draft matches a stored revision. This does not mean it is published.
blocker / blockersValidation found errors. Correct each error before publishing.
Ready to publishLocal blocking checks pass. Save any pending edits, review warnings, then publish.
Circuit checks pass.No local model-validation errors or warnings were found.
PublishedThis revision is the circuit’s published study input.

Revisions and Concurrent Edits

Project circuits lists the project’s circuits. Revisions lists the selected circuit’s saved versions and identifies the published version.

Historical revisions are read-only. Select Restore as new revision to use an older version as a new draft. Save it to create a new revision without overwriting history.

If another session changes the circuit before you save, your draft is preserved. Select Reload latest to load the new head, or Save draft as copy to preserve your work as a separate circuit. Review pending changes before reloading.

Changing the project or leaving the builder with unsaved changes can require confirmation. Save first if you need to keep the draft.

Use the Published Model

  1. Select the project in Session Context.
  2. Open Setup & Run and select a supported study type and engine.
  3. Select Circuit Revision, then choose Published circuit revision.
  4. Run Check Readiness before starting the study.

Circuit-revision inputs are available for model quality, power flow, contingency analysis, sensitivity analysis, PTDF/LODF, and cross-check studies. The study uses the selected saved revision, not later edits. Check equipment and method support for the selected study.

For an interchange package, save the revision and use Export PSS/E. The strict circuit export path requires missing electrical values to be supplied before export. See Engineering Exports and Handoffs.

Use the saved circuit revision to run studies, compare operating cases and prepare an engineering handoff.

Related Guides

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