Connections

Connections represent electrical links between components. They define how power flows through your system from sources to loads.

Manual connections

Create connections by dragging from one component's handle to another:

Hover over a component to reveal connection handles (small circles or lines).
Click and hold on a handle.
Drag toward the target component.
Drop on a target component's handle.
The connection appears as a line between components.

Handles appear at connection points:

Top handles: Connections from above (source, upstream)
Bottom handles: Connections to below (load, downstream)
Left/right handles: Horizontal connections (less common)

Most electrical components use top and bottom handles following industry SLD conventions.

Connection handles

Different components have different handle configurations:

Simple handles (single connection per side):

Loads: Top only (power in)
Motors: Top only (power in)
Generators: Bottom only (power out)
Utility feeds: Bottom only (power out)

Pass-through handles (both top and bottom):

Breakers: Top (line side) and bottom (load side)
Fuses: Top (line side) and bottom (load side)
Cables: Both ends connect
Transformers: Top (primary) and bottom (secondary)

Dynamic handles (unlimited connections):

Buses: Creates handles dynamically as components connect
See Buses for bus-specific behavior)

Handles are invisible by default and appear when you hover over a component or during connection mode.

Auto-connection system

The auto-connect feature automatically connects components you drop near compatible existing components:

How auto-connect works:

Drag a component from the toolbar, or move a component that has no connections yet.
Position it directly above or below an existing component, within about 200 px vertically and 75 px sideways (anywhere along a bus).
Drop the component.
System automatically creates a connection between compatible handles.

Auto-connect saves time when building typical power system configurations like:

Utility feed → Breaker → Transformer → Bus → Loads
Generator → Switchgear → Distribution panels

When auto-connect doesn't trigger:

Component dropped too far above, below, or to the side of any existing component
No electrically compatible components nearby
Shift key held during drop (disables auto-connect)
Target component already has maximum connections

Proximity threshold

Auto-connect activates when the dropped component is within about 200 px above or below another component and within about 75 px sideways of it (for a bus, of any point along its length):

Within threshold: auto-connect on drop
Outside threshold: manual connection required

The threshold provides:

Generous range for quick diagram building
Prevents unwanted connections to distant components

If auto-connect attempts an unwanted connection, press Shift while dropping to disable auto-connection for that placement.

Shift key to disable auto-connect

To place a component near others without auto-connecting:

Start dragging a component from the toolbar.
Hold Shift key before dropping.
Drop the component.
Component places without creating connections.
Manually connect later if desired.

This is useful when:

Building dense diagrams where components are close but shouldn't connect
Placing multiple components before connecting them
You want precise control over connection points

Connection validation rules

The system validates electrical compatibility before allowing connections:

Valid connections:

Source to bus (utility feed, generator to distribution bus)
Bus to load through protection (bus → breaker → load)
Transformer primary to upstream bus, secondary to downstream bus
Generator to switchgear to distribution
Cable/conductor between any compatible components

Invalid connections prevented:

Load to load (two sinks)
Generator to generator (two sources without bus)
Voltage-incompatible components (13.8kV to 480V without transformer)
Reverse connections (load side to line side)

Connection validation checks:

Component types are electrically compatible
Voltage levels are appropriate
Connection direction matches power flow
No duplicate connections between same components

If you attempt an invalid connection, the system rejects it and the connection does not form.

Connection direction and power flow

Connections follow electrical power flow direction:

Downstream (normal power flow):

Sources connect downward: Utility → Transformer → Bus → Loads
Top handles connect to bottom handles
Represents power flowing from source to load

Upstream (reverse connections for generation):

Generators can connect upward to buses
Bottom handles (generator output) connect to bus top handles
Represents power injection into the system

The visual layout matches electrical intent:

Power sources at top of diagram
Distribution in middle
Loads at bottom

This top-to-bottom flow is industry standard for single-line diagrams.

Disconnecting components

To remove a connection:

Click on the connection line to select it.
The line highlights (typically blue).
Press Delete or Backspace key.
Connection removes immediately.

Deleting a component:

When you delete a component, all its connections delete automatically.
Prevents orphaned connection lines.

Undo:

Connection deletions support undo (Ctrl/Cmd+Z).
Accidentally deleted connections can be restored.

Multiple connections

Some components support multiple connections:

Buses:

Unlimited connections
Each connected component gets its own dynamic handle
Handles align vertically with connected components
See Buses

Transformers:

One primary connection (top)
One secondary connection (bottom)
Cannot parallel transformers with simple connections

Breakers and fuses:

One line side connection (top)
One load side connection (bottom)
Series protection only (no parallel paths)

Loads:

Typically one connection (radial feed)

Connection display

Connections are drawn as stepped lines between component handles. A selected connection is highlighted.

A connection has no impedance. To model a conductor's length and impedance, place a Cable component between the two components and set its properties in the edit panel.

Opening a connection

A connection is closed unless you open it. To open a tie drawn as a plain wire, right-click the connection and choose Open; choose Close to close it again. An open connection is drawn dashed and labelled OPEN, and it carries no current in power flow, short circuit, arc flash or sizing. In a scenario, opening a connection changes only that scenario. See Scenarios.

Editing existing connections

To move a connection, delete it and create a new one from different handles or to a different component.

Connection edits update power flow calculations automatically when you rerun analysis.

Best practices

For clean diagrams:

Route connections top-to-bottom to match power flow
Avoid crossing connection lines when possible
Use buses to organize multiple connections
Group related components to minimize connection length

For accurate analysis:

Set appropriate cable types and lengths for all cables
Verify voltage compatibility of connected components
Review connection issues reported before running a study
Ensure all components connect to the main power system (no isolated islands)

For efficient editing:

Use auto-connect when building typical configurations
Use Shift key to disable auto-connect in dense areas
Delete components with many connections carefully (deletes all connections)
Use undo if you accidentally delete connections

Auto-connect feature - Detailed auto-connect behavior
Pre-analysis validation - Issues shown before a study runs
Buses - Bus-specific connection behavior
Cables - Cable electrical properties