> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plantpredict.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Array

> Configure array multiplier, MV transformer settings, and AC collection losses

The Array page allows you to configure the medium-voltage (MV) transformer, AC collection circuit losses, and define the number of equivalent arrays within a Block. An Array aggregates multiple inverters and their associated DC Fields. Similar to the Inverter page, the Array supports a multiplier to model multiple identical arrays without duplicating configuration work.

<Frame caption="Power Plant Builder - Array Page">
  <img src="https://mintcdn.com/terabaseenergy/9Vjn_rttDdDb1jM2/images/power-plant-builder-array-ui.png?fit=max&auto=format&n=9Vjn_rttDdDb1jM2&q=85&s=7ba3bc3bac0b4d53e5fbee05866ed20b" alt="Power Plant Builder Array Page" width="2048" height="885" data-path="images/power-plant-builder-array-ui.png" />
</Frame>

## Overview

The Array page is organized into the following sections:

1. **Hierarchy Bar** — Shows the current position in the plant hierarchy (Block → Array → Inverter → DC Field) with system capacity summaries.
2. **Array Header** — Displays the array identifier with Edit, Clone, and Remove buttons.
3. **Array Details** — Define how many arrays of this type exist and add optional notes.
4. **Transformer** — Configure the MV transformer including kVA rating, voltage, and loss parameters. The transformer can be toggled on or off.
5. **Electrical** — Configure AC collection losses including wiring losses and auxiliary power consumption.

***

## User Inputs

<table>
  <colgroup>
    <col style={{width: "4%"}} />

    <col style={{width: "18%"}} />

    <col style={{width: "10%"}} />

    <col style={{width: "6%"}} />

    <col style={{width: "44%"}} />

    <col style={{width: "18%"}} />
  </colgroup>

  <thead>
    <tr>
      <th>#</th>
      <th>Input</th>
      <th>Type</th>
      <th>Units</th>
      <th>Description</th>
      <th>Related Documentation</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>**1**</td>
      <td>**Block** (Hierarchy)</td>
      <td>Button</td>
      <td>—</td>
      <td>Toggle view to show the hierarchy bar displaying system summary at each level: Block, Array, Inverter, and DC Field. Shows MWdc, MWac, DC:AC ratio, GCR, Array Count, and Inverter Count.</td>
      <td>[Block Overview](/user-guide/ui/power-plant-builder-block)</td>
    </tr>

    <tr>
      <td>**2**</td>
      <td>**How Many of this Type?**</td>
      <td>Text Field</td>
      <td>—</td>
      <td>Number of identical arrays within this Block. Each repeat uses the same transformer, inverter, and DC Field configuration. Useful for modeling uniform plant sections without duplicating design work.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**3**</td>
      <td>**Description**</td>
      <td>Text Area</td>
      <td>—</td>
      <td>Optional text field for notes or comments about this array configuration. Does not affect simulation results.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**4**</td>
      <td>**Transformer** (Toggle)</td>
      <td>Toggle</td>
      <td>—</td>
      <td>Enable or disable the MV transformer for this array. When **OFF**, transformer losses are not applied and the transformer configuration fields are hidden. When **ON**, the transformer parameters below become active.</td>
      <td>[AC System Losses](/models/ac-losses/ac_system_losses)</td>
    </tr>

    <tr>
      <td>**5**</td>
      <td>**KVA Rating**</td>
      <td>Text Field</td>
      <td>kVA</td>
      <td>Apparent power rating of the MV transformer. Can be manually entered or automatically matched to the total inverter kVA rating using the checkbox below.</td>
      <td>[AC System Losses](/models/ac-losses/ac_system_losses)</td>
    </tr>

    <tr>
      <td>**6**</td>
      <td>**Match Total Inverter kVA**</td>
      <td>Checkbox</td>
      <td>—</td>
      <td>When checked, the transformer kVA rating is automatically set to match the sum of all inverter kVA ratings in the array. Uncheck to manually specify a different transformer size.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**7**</td>
      <td>**High Side Voltage**</td>
      <td>Text Field</td>
      <td>kV</td>
      <td>Medium-voltage output of the transformer (high side). Typical values range from 12 kV to 69 kV depending on the collection system design.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**8**</td>
      <td>**No Load Loss**</td>
      <td>Text Field</td>
      <td>%</td>
      <td>Transformer core losses as a percentage of rated kVA. These losses occur whenever the transformer is energized, regardless of load. Also known as iron losses or excitation losses.</td>
      <td>[AC System Losses](/models/ac-losses/ac_system_losses)</td>
    </tr>

    <tr>
      <td>**9**</td>
      <td>**Full Load Loss**</td>
      <td>Text Field</td>
      <td>%</td>
      <td>Transformer winding losses at full load as a percentage of rated kVA. Also known as copper losses or load losses. Scales with the square of the load.</td>
      <td>[AC System Losses](/models/ac-losses/ac_system_losses)</td>
    </tr>

    <tr>
      <td>**10**</td>
      <td>**AC Collection Loss at Max Array Power**</td>
      <td>Text Field</td>
      <td>%</td>
      <td>Resistive losses in the MV collection circuit at maximum array power output. Includes cable and connection losses between the transformer and the point of interconnection.</td>
      <td>[AC System Losses](/models/ac-losses/ac_system_losses)</td>
    </tr>

    <tr>
      <td>**11**</td>
      <td>**Data Acquisition System Loss**</td>
      <td>Text Field</td>
      <td>W</td>
      <td>Constant power consumption of data acquisition and monitoring equipment (SCADA, meters, sensors, communication systems) at the array level.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**12**</td>
      <td>**Shelter Cooling Loss**</td>
      <td>Text Field</td>
      <td>W</td>
      <td>Constant power consumption for inverter shelter or equipment enclosure cooling systems (HVAC, fans). Set to 0 if no active cooling is used.</td>
      <td>—</td>
    </tr>
  </tbody>
</table>

***

## Saving Changes

Click **Save Power Plant** in the top-right corner to save all array configuration changes and return to the [Block Overview](/user-guide/ui/power-plant-builder-block). Click the **X** button to cancel and discard changes.