Validation warnings

The validation system continuously monitors your electrical diagram for issues and provides warnings about potential problems. This helps catch errors before running analysis.

What the validation system checks

The system validates:

Connection rules:

• Electrical compatibility between connected components
• Valid connection directions
• Proper upstream/downstream relationships

Voltage compatibility:

• Voltage mismatches between connected components
• Missing transformers where voltage changes
• Excessive voltage differences (>10%)

System completeness:

• Orphaned components (not connected to main system)
• Missing slack bus
• Isolated network islands

Component configuration:

• Missing required properties
• Invalid property values
• Incomplete component specifications

Validation runs automatically whenever you modify the diagram.

Warning types

Connection violations (high severity - red):

• Invalid electrical connections
• Example: Load connected directly to another load
• Example: Reverse polarity (load side to line side)
• Blocks power flow analysis
• Must be fixed for calculations to run

Voltage mismatches (medium severity - yellow):

• Connected components with different voltage ratings
• Example: 480V bus connected to 13.8kV bus without transformer
• May indicate missing equipment
• Should be reviewed before analysis

Orphaned components (low severity - blue):

• Components not connected to the main power system
• Example: Bus with no connections
• Example: Load disconnected from all sources
• Doesn't affect calculations (ignored)
• May be intentional (work in progress)

Connection suggestions (info - blue):

• System-identified potential connections
• High-confidence recommendations
• Example: Components aligned but not connected
• Optional - you can ignore or accept

Viewing warnings panel

The warnings panel displays validation issues:

Location:

• Floating panel on canvas (typically top-left)
• Collapsible to save space
• Badge shows warning count

Panel contents:

• Warning icon (red, yellow, or blue)
• Brief description of issue
• Affected component names
• Dismiss button (X) for individual warnings

Actions:

• Click warning to highlight affected components
• Dismiss warnings you've reviewed
• Toggle suggestions on/off
• Show all dismissed warnings

Connection validation rules

Valid connections:

Invalid connections:

The system prevents invalid connections during creation but warns if validation fails after editing.

Voltage mismatch detection

Voltage mismatch warnings appear when:

Threshold: Connected components differ by >10%

Example scenarios:

Missing transformer:

• 13.8kV bus connected to 480V bus
• Difference: 13,800V vs 480V = 2,775% difference
• Warning: "Voltage mismatch: missing transformer?"

Configuration error:

• 480V bus connected to 460V motor
• Difference: 480V vs 460V = 4.3% difference
• May be acceptable (within equipment tolerance)
• Warning depends on threshold

Fix voltage mismatches:

• Insert transformer between different voltage levels
• Correct component voltage ratings
• Verify voltage specifications match system design

Resolving validation issues

For connection violations:

1. Click warning to highlight affected components.
2. Delete invalid connection.
3. Reconnect correctly (source to bus to load).
4. Verification: Warning disappears automatically.

For voltage mismatches:

1. Identify components with voltage difference.
2. Insert transformer if voltages genuinely differ.
3. Or correct voltage rating if misconfigured.
4. Verification: Warning clears after correction.

For orphaned components:

1. Determine if component is intentionally disconnected.
2. If error: Connect to main system.
3. If intentional: Dismiss warning or delete component.

For suggestions:

1. Review suggested connection.
2. Accept: Manually create the connection.
3. Reject: Dismiss the suggestion.

Warning severity levels

Critical (red icon):

• Prevents analysis from running
• Must be resolved before power flow or short-circuit
• Example: Invalid connections, missing slack bus

Warning (yellow icon):

• Analysis may run but results questionable
• Should be reviewed and resolved
• Example: Voltage mismatches, configuration errors

Info (blue icon):

• Advisory messages
• Analysis runs normally
• Example: Orphaned components, suggestions

Dismissed:

• User-acknowledged warnings
• Hidden from main panel
• Can be re-shown if needed

Connection suggestions

The system suggests connections when it detects:

High confidence indicators:

• Components vertically aligned
• Appropriate distance (50-500px)
• Compatible types
• No existing connection

Suggestion format:

• Blue info icon
• "Suggested: Connect [Component A] to [Component B]"
• Dismiss button
• Accept by manually connecting

Suggestions are optional. Ignore them if your design differs from the suggestion.

Ignoring false positives

Some warnings may be intentional design choices:

Orphaned components:

• Future work in progress
• Alternative designs being compared
• Template components for copy-paste

Voltage mismatches:

• Equipment rated for voltage range (460V-480V)
• Temporary configuration during editing

To dismiss false positives:

1. Click X button on individual warning.
2. Warning moves to "Dismissed" section.
3. Re-show dismissed warnings anytime.
4. Dismissed warnings don't reappear automatically.

Validation before analysis

Before running power flow or short-circuit analysis:

1. Open validation warnings panel.
2. Review all critical (red) warnings.
3. Resolve connection violations.
4. Verify voltage mismatches.
5. Confirm slack bus designation.
6. Review yellow warnings.

Analysis may fail or produce incorrect results if critical warnings exist.

Related topics

• Connections - Valid connection patterns
• Buses - Slack bus configuration
• Power flow analysis - Pre-analysis validation