> ## 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.

# Block Overview

> Configure power plant hierarchy including blocks, arrays, inverters, and DC fields in a single-line diagram view

The Power Plant Builder (Block) Page provides a diagrammatic interface for configuring the power plant hierarchy. Similar to a single-line diagram, this page displays the relationship between Blocks, Arrays, Inverters, and DC Fields. You can toggle between a condensed overview and an expanded view to access detailed configuration for each component.

<Frame caption="Power Plant Builder - Condensed View">
  <img src="https://mintcdn.com/terabaseenergy/zqwq-Gn-nigxUeAg/images/power-plant-builder-block-condensed-ui.png?fit=max&auto=format&n=zqwq-Gn-nigxUeAg&q=85&s=d243aef2eefafbb754478cecf0f7f752" alt="Power Plant Builder Condensed View" width="2048" height="565" data-path="images/power-plant-builder-block-condensed-ui.png" />
</Frame>

<Frame caption="Power Plant Builder - Expanded View">
  <img src="https://mintcdn.com/terabaseenergy/zqwq-Gn-nigxUeAg/images/power-plant-builder-block-expanded-ui.png?fit=max&auto=format&n=zqwq-Gn-nigxUeAg&q=85&s=a770044bb4dc655eae7b5c6ae843f915" alt="Power Plant Builder Expanded View" width="2048" height="684" data-path="images/power-plant-builder-block-expanded-ui.png" />
</Frame>

## Overview

The Power Plant Builder Page is organized into the following sections:

1. **Header Bar** — Displays summary metrics (MWdc, MWac, DC:AC ratio, GCR%, Array Count, Inverter Count) and the Save Power Plant button.
2. **Hierarchy Navigation Bar** — Shows the plant topology as BLOCK → ARRAY → INVERTER → DC FIELD. Click to toggle between condensed and expanded views.
3. **Block Details (Condensed View)** — Shows individual block configuration including construction dates and block capacity summary.
4. **Hierarchy Tree (Expanded View)** — Shows the complete tree structure allowing you to add, edit, and navigate to any component in the plant hierarchy.

***

## 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>**Toggle View**</td>
      <td>Button</td>
      <td>—</td>
      <td>Toggles between condensed view (showing block summary and construction dates) and expanded view (showing the full hierarchy tree). Located on the hierarchy navigation bar.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**2**</td>
      <td>**Edit** (Block)</td>
      <td>Button</td>
      <td>—</td>
      <td>Opens the Block configuration dialog to edit block-level parameters including the block name and repeater count.</td>
      <td>[Block Overview](/user-guide/ui/power-plant-builder-block)</td>
    </tr>

    <tr>
      <td>**3**</td>
      <td>**Clone** (Block)</td>
      <td>Button</td>
      <td>—</td>
      <td>Creates a copy of the selected block including all arrays, inverters, and DC fields within it.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**4**</td>
      <td>**Remove** (Block)</td>
      <td>Button</td>
      <td>—</td>
      <td>Removes the selected block and all associated arrays, inverters, and DC fields. This action requires confirmation.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**5**</td>
      <td>**Energization**</td>
      <td>Toggle</td>
      <td>—</td>
      <td>When **ON**, enables construction date staggering for the block. This allows different blocks to have different energization dates, which affects degradation calculations.</td>
      <td>[Degradation](/models/inverter-models/degradation_dc_applied)</td>
    </tr>

    <tr>
      <td>**6**</td>
      <td>**Date**</td>
      <td>Date Picker</td>
      <td>—</td>
      <td>Sets the energization date for the block. Only enabled when Energization toggle is **ON**. Format: MM-DD-YYYY.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**7**</td>
      <td>**DC Field** (Edit)</td>
      <td>Button</td>
      <td>—</td>
      <td>Click the edit icon to open the DC Field configuration page. The DC Field defines the module specifications, string configuration, and field-level losses.</td>
      <td>[DC Field - Table](/user-guide/ui/power-plant-builder-dc-field-table)</td>
    </tr>

    <tr>
      <td>**8**</td>
      <td>**Inverter** (Header)</td>
      <td>Display</td>
      <td>—</td>
      <td>Shows inverter summary in the hierarchy navigation bar including AC capacity (kWac) and DC capacity (kWdc).</td>
      <td>[Inverter Overview](/models/inverter-models/overview)</td>
    </tr>

    <tr>
      <td>**9**</td>
      <td>**Inverter** (Edit)</td>
      <td>Button</td>
      <td>—</td>
      <td>Click the edit icon to open the Inverter configuration page. The Inverter defines the inverter model, setpoint, and AC-side parameters.</td>
      <td>[Inverter](/user-guide/ui/power-plant-builder-inverter), [Inverter Overview](/models/inverter-models/overview)</td>
    </tr>

    <tr>
      <td>**10**</td>
      <td>**Block** (Edit in List)</td>
      <td>Button</td>
      <td>—</td>
      <td>Click the edit icon in the expanded view to open the Block configuration dialog.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**11**</td>
      <td>**Add a DC Field**</td>
      <td>Button</td>
      <td>—</td>
      <td>Adds a new DC Field to the selected inverter. Multiple DC fields can be connected to a single inverter.</td>
      <td>[DC Field Aggregation](/models/inverter-models/dc_field_aggregation)</td>
    </tr>

    <tr>
      <td>**12**</td>
      <td>**Add an Inverter**</td>
      <td>Button</td>
      <td>—</td>
      <td>Adds a new inverter to the selected array. Multiple inverters can be configured within a single array.</td>
      <td>[Inverter Overview](/models/inverter-models/overview)</td>
    </tr>

    <tr>
      <td>**13**</td>
      <td>**Add an Array**</td>
      <td>Button</td>
      <td>—</td>
      <td>Adds a new array to the selected block. Arrays represent groups of inverters that share common characteristics such as transformer and AC collection.</td>
      <td>[Array](/user-guide/ui/power-plant-builder-array)</td>
    </tr>

    <tr>
      <td>**14**</td>
      <td>**Add Block**</td>
      <td>Button</td>
      <td>—</td>
      <td>Adds a new block to the power plant. Blocks are top-level groupings that can have independent construction dates and may represent physical sections of the plant.</td>
      <td>—</td>
    </tr>
  </tbody>
</table>

***

## Saving Changes

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