Inverter Commands

ADDINVERTER

How to use

1. Type ADDINVERTER in the command line
2. Click to place the inverter block in the drawing
3. Choose a string assignment mode:
   • Automatic — Assigns the nearest unassigned strings
   • Manual — You select which strings to assign
   • Add Later — Skips assignment. Use ASSIGNSTRINGS afterward

What it creates

• • Inverter block — A block reference with inverter number attribute
• • String assignments — Selected strings are assigned circuit designations (unless using Add Later)
• • Updated tags — String tags update to show inverter/MPPT assignment

ADDALLINVERTERS

How to use

1. Ensure strings are solved but not yet assigned to inverters
2. Type ADDALLINVERTERS in the command line
3. Branch groups strings and places inverters automatically

How it works

• • Groups strings by proximity and orientation
• • Calculates optimal inverter placement for each group
• • Places one inverter per group with all strings assigned
• • Respects your MPPT configuration for string distribution

ASSIGNSTRINGS

How to use

1. Place inverters using Add Later mode (ADDINVERTER)
2. Type ASSIGNSTRINGS in the command line
3. Choose Auto or Manual mode
4. Auto: Branch optimizes assignments across all inverters based on proximity
5. Manual: Select an inverter, then pick strings to assign. Repeat for each inverter

Auto vs Manual

• • Auto — Best when all inverters are already placed. Optimizes wiring distance across the entire drawing at once
• • Manual — Best when you need specific control over which strings go where

What it modifies

• • Circuit tags — String tags update from "-" (unassigned) to circuit designations (e.g., 1/4a)
• • Color coding — Strings and inverters receive matching colors to show associations

MOVEINV

How to use

1. Type MOVEINV in the command line
2. Select the inverter to move
3. Click the new location
4. Homerun routing updates automatically

INVBALANCE

How to use

1. Type INVBALANCE in the command line
2. The Inverter Manager opens with all inverters listed, sorted by balance status (worst first)
3. Click any inverter to see its MPPT breakdown with per-string panel counts and homerun lengths
4. Review suggested swaps, or click Auto-Balance All to fix all inverters at once
5. Double-click any string to zoom to it in the drawing

The Inverter Manager shows

• • Inverter overview — All inverters listed with efficiency %, wasted panel count, and color-coded status (green = balanced, yellow = minor issues, red = significant mismatch)
• • MPPT breakdown — Per-MPPT panel showing each string's circuit, panel count, and homerun length in feet. Unbalanced MPPTs highlighted in red with bottleneck strings marked
• • Smart swap suggestions — Ranked list of string swaps that improve balance, showing balance impact and homerun length change. Includes both same-inverter and cross-inverter suggestions
• • Swap history — Every applied swap is tracked with efficiency gain and cumulative impact. Undo individual swaps or revert to any previous state
• • Auto-Balance All — One-click button to apply all non-conflicting swaps across every inverter in the drawing

Why balance matters

Strings in parallel on the same MPPT input share a single voltage operating point. If one string has 12 panels and another has 10, the MPPT tracker must compromise — reducing power output from every string on that input. INVBALANCE helps you:

• • Match panel counts per MPPT to eliminate voltage mismatch losses
• • Identify which strings are causing imbalance and where to move them
• • Weigh balance improvements against homerun length tradeoffs

Inverter Configuration

These settings in BRANCHOPTIONS affect inverter behavior:

Circuit Designation Format

When strings are assigned to inverters, they receive a circuit designation like 1/4a. Here's what each part means:

This format makes it easy to trace cables during installation and troubleshooting. The same designation appears on the string tag in the drawing and in cable export data.