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

# Add New Module

> Upload module files or generate module specifications from datasheet values, I-V points, or full I-V curves

When you click **Add New Module** from the [Module Library](/user-guide/ui/module-library), a modal appears presenting six options for creating a new module specification.

<Frame caption="Add New Module Options">
  <img src="https://mintcdn.com/terabaseenergy/7d9cGfLAN1NeJWyT/images/add-new-module-modal-ui.png?fit=max&auto=format&n=7d9cGfLAN1NeJWyT&q=85&s=cfcab3339d44dda9d8e029ef3edf5139" alt="Add New Module Modal" width="1024" height="533" data-path="images/add-new-module-modal-ui.png" />
</Frame>

## Input Options Overview

| Option                    | Description                                   | Best For                              |
| ------------------------- | --------------------------------------------- | ------------------------------------- |
| **Enter Basic Data**      | Generate module from datasheet values         | Standard module datasheets            |
| **Enter Key I-V Points**  | Generate from IEC 61853-1 performance data    | Lab-tested performance data           |
| **Enter Full I-V Curves** | Generate from complete I-V curve measurements | Detailed I-V curve data               |
| **Upload PPM File**       | Import PlantPredict native module file        | Sharing between PlantPredict accounts |
| **Upload PAN File**       | Import PVsyst native module file              | Migration from PVsyst                 |
| **Create Blank Template** | Start with empty module file                  | Advanced users                        |

***

## 1. Upload PPM File

Upload a PlantPredict native module file (.ppm format). This is a straightforward file import:

1. Click **Upload PPM File**
2. A file explorer opens
3. Navigate to and select your .ppm file
4. The module is imported with all parameters intact

<Info>
  PPM files can be exported from any PlantPredict module using the **Export** button in the Module Library.
</Info>

***

## 2. Upload PAN File

Upload a PVsyst native module file (.pan format). This allows migration of module specifications from PVsyst:

1. Click **Upload PAN File**
2. A file explorer opens
3. Navigate to and select your .pan file
4. PlantPredict converts the PVsyst parameters to PlantPredict format

<Note>
  Some PVsyst parameters may not have direct equivalents in PlantPredict. Review the imported module to ensure all critical parameters are correctly mapped.
</Note>

***

## 3. Create Blank Template

Creates a new module file with all parameters set to default or empty values. This option provides the same parameter structure as documented in the [Module File](/user-guide/ui/module-file) page.

1. Click **Create Blank Template**
2. A blank module file opens with all tabs available
3. Manually enter all required parameters
4. Click **Save Module** when complete

<Warning>
  This option requires manual entry of all module parameters including 1-diode model coefficients. It is recommended only for advanced users who have complete module characterization data.
</Warning>

***

## 4. Enter Basic Data

The **Enter Basic Data** option is recommended when creating a module from a standard manufacturer datasheet. PlantPredict automatically generates 1-diode parameters from the basic electrical characteristics you provide.

<Frame caption="Module Generator - Enter Basic Data">
  <img src="https://mintcdn.com/terabaseenergy/7d9cGfLAN1NeJWyT/images/add-new-module-basic-ui.png?fit=max&auto=format&n=7d9cGfLAN1NeJWyT&q=85&s=c9cb11c05ec8f5c9452fb7c35558558b" alt="Enter Basic Data" width="1844" height="2048" data-path="images/add-new-module-basic-ui.png" />
</Frame>

### User Inputs

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

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

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

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

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

    <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>**Generate Module**</td>
      <td>Button</td>
      <td>—</td>
      <td>Generates the complete module file from entered data and opens the module editor for final review and saving.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**2**</td>
      <td>**Cell Technology**</td>
      <td>Dropdown</td>
      <td>—</td>
      <td>Select the cell technology. Options: **n-type mono c-Si**, **p-type mono c-Si PERC**, **p-type mono c-Si BSF**, **poly c-Si PERC**, **poly c-Si BSF**, **CdTe**, **CIGS**, **Mixed**.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**3**</td>
      <td>**Number of Cells in Series**</td>
      <td>Numeric</td>
      <td>—</td>
      <td>Number of cells connected in series within the module.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**4**</td>
      <td>**Model Type**</td>
      <td>Dropdown</td>
      <td>—</td>
      <td>Select the diode model type. Options: **1-Diode**, **1-Diode Recombination**, **1-Diode Recombination Non-Linear**. Use **1-Diode** for crystalline silicon modules; use **1-Diode Recombination** for CdTe modules.</td>
      <td>[Single Diode Model](/models/dc-performance/5_parameter_model)</td>
    </tr>

    <tr>
      <td>**5**</td>
      <td>**Maximum Power**</td>
      <td>Numeric</td>
      <td>W</td>
      <td>Rated maximum power at STC (Pmax).</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**6**</td>
      <td>**Power Temp. Coeff.**</td>
      <td>Numeric</td>
      <td>%/°C</td>
      <td>Temperature coefficient of power (typically negative).</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**7**</td>
      <td>**Voc**</td>
      <td>Numeric</td>
      <td>V</td>
      <td>Open circuit voltage at STC.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**8**</td>
      <td>**Voc Temp. Coeff.**</td>
      <td>Numeric</td>
      <td>%/°C</td>
      <td>Temperature coefficient of open circuit voltage (typically negative).</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**9**</td>
      <td>**Isc**</td>
      <td>Numeric</td>
      <td>A</td>
      <td>Short circuit current at STC.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**10**</td>
      <td>**Isc Temp. Coeff.**</td>
      <td>Numeric</td>
      <td>%/°C</td>
      <td>Temperature coefficient of short circuit current (typically positive).</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**11**</td>
      <td>**Vmp**</td>
      <td>Numeric</td>
      <td>V</td>
      <td>Voltage at maximum power point at STC.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**12**</td>
      <td>**Imp**</td>
      <td>Numeric</td>
      <td>A</td>
      <td>Current at maximum power point at STC.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**13**</td>
      <td>**Module Temp.**</td>
      <td>Numeric</td>
      <td>°C / °F</td>
      <td>Temperature for calculated performance preview (adjustable).</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**14**</td>
      <td>**Irradiance**</td>
      <td>Numeric</td>
      <td>W/m²</td>
      <td>Irradiance for calculated performance preview (adjustable).</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**15**</td>
      <td>**Show/Hide Advanced Fine Tuning Options**</td>
      <td>Toggle</td>
      <td>—</td>
      <td>Expands or collapses the 1-Diode Parameters and Effective Irradiance Response (EIR) tuning sections.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**16**</td>
      <td>**Use algorithmic defaults**</td>
      <td>Checkbox</td>
      <td>—</td>
      <td>When checked, 1-diode parameters are calculated automatically. Unchecks automatically when any parameter is manually modified. Re-check to revert to defaults.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**17**</td>
      <td>**Series Resistance at STC**</td>
      <td>Numeric</td>
      <td>Ω</td>
      <td>Series resistance at STC. Key parameter for EIR optimization.</td>
      <td>[Single Diode Model](/models/dc-performance/5_parameter_model)</td>
    </tr>

    <tr>
      <td>**18**</td>
      <td>**Recombination Parameter**</td>
      <td>Numeric</td>
      <td>V</td>
      <td>Recombination loss parameter for the diode model.</td>
      <td>[Recombination Model](/models/dc-performance/7_parameter_model)</td>
    </tr>

    <tr>
      <td>**19**</td>
      <td>**Shunt Resistance at STC**</td>
      <td>Numeric</td>
      <td>Ω</td>
      <td>Shunt resistance at STC.</td>
      <td>[Single Diode Model](/models/dc-performance/5_parameter_model)</td>
    </tr>

    <tr>
      <td>**20**</td>
      <td>**Exp. Dep. of Shunt Resist.**</td>
      <td>Numeric</td>
      <td>—</td>
      <td>Exponential dependence of shunt resistance on irradiance.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**21**</td>
      <td>**Dark Shunt Resistance**</td>
      <td>Numeric</td>
      <td>Ω</td>
      <td>Shunt resistance in the dark (zero irradiance).</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**22**</td>
      <td>**Optimize to match EIR**</td>
      <td>Button</td>
      <td>—</td>
      <td>Algorithmically tunes Series Resistance at STC to match the desired Effective Irradiance Response curve.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**23**</td>
      <td>**Add Curve**</td>
      <td>Button</td>
      <td>—</td>
      <td>Add a new temperature curve for the Effective Irradiance Response. Only the 25°C curve is used for EIR optimization.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**24**</td>
      <td>**Irradiance / Rel. Efficiency Table**</td>
      <td>Table</td>
      <td>W/m², %</td>
      <td>Enter desired irradiance-relative efficiency pairs to define target EIR performance.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**26**</td>
      <td>**Add Point**</td>
      <td>Button</td>
      <td>—</td>
      <td>Add a new irradiance-efficiency data point to the EIR table.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**27**</td>
      <td>**Clear Form Data**</td>
      <td>Button</td>
      <td>—</td>
      <td>Clear all EIR data points from the table.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**28**</td>
      <td>**Relative Efficiency**</td>
      <td>Radio</td>
      <td>—</td>
      <td>Display the EIR chart showing relative efficiency vs. irradiance. Solid line = model-calculated; circles = target values.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**29**</td>
      <td>**Difference/Error**</td>
      <td>Radio</td>
      <td>—</td>
      <td>Display the difference between target and model-calculated relative efficiencies at each irradiance point.</td>
      <td>—</td>
    </tr>
  </tbody>
</table>

### Workflow

1. Fill in **General Characteristics** (Cell Technology, Number of Cells, Model Type)
2. Enter **Electrical Data at STC** (Pmax, Voc, Isc, Vmp, Imp)
3. Enter **Temperature Coefficients** (Power, Voc, Isc)
4. Review the **Calculated Performance** and I-V curve preview
5. (Optional) Expand **Advanced Fine Tuning Options** to optimize EIR
6. Click **Generate Module** to create the module file
7. Complete remaining metadata and click **Save Module**

### Advanced Tuning with Effective Irradiance Response (EIR)

A module's EIR defines its relative efficiency across a range of irradiance levels, where 100% represents efficiency at 1000 W/m².

**To optimize EIR:**

1. Click **Show Advanced Fine Tuning Options**
2. Click **Add Curve** and specify a temperature (use 25°C for optimization)
3. Enter irradiance-relative efficiency pairs in the table
4. The chart displays target values (circles) and model-calculated values (solid line)
5. Click **Optimize to match EIR** to automatically tune Series Resistance
6. Toggle to **Difference/Error** view to see optimization quality
7. Manually adjust 1-diode parameters if further refinement is needed

<Info>
  The **Optimize to match EIR** feature currently only uses the 25°C curve for optimization. For best results, ensure your target EIR data is entered at this temperature.
</Info>

***

## 5. Enter Key I-V Points

The **Enter Key I-V Points** option is recommended when you have module performance data from IEC 61853-1 testing or similar characterization. PlantPredict automatically calculates temperature coefficients and relative efficiencies from the provided data.

<Frame caption="Module Generator - Enter Key I-V Points">
  <img src="https://mintcdn.com/terabaseenergy/7d9cGfLAN1NeJWyT/images/add-new-module-keyiv-ui.png?fit=max&auto=format&n=7d9cGfLAN1NeJWyT&q=85&s=c394818184311e7c9444badce70d5f81" alt="Enter Key I-V Points" width="1699" height="592" data-path="images/add-new-module-keyiv-ui.png" />
</Frame>

### Data Entry Format

For each temperature and irradiance condition, enter the key electrical characteristics:

| Column              | Units | Description                                                         |
| ------------------- | ----- | ------------------------------------------------------------------- |
| **Irradiance**      | W/m²  | Irradiance level for this data point                                |
| **Isc**             | A     | Short circuit current                                               |
| **Voc**             | V     | Open circuit voltage                                                |
| **Imp**             | A     | Current at maximum power point                                      |
| **Vmp**             | V     | Voltage at maximum power point                                      |
| **Pmp**             | W     | Maximum power (can be calculated)                                   |
| **Rel. Efficiency** | %     | Relative efficiency (auto-calculated when sufficient data provided) |

### Features

| Element                    | Description                                                            |
| -------------------------- | ---------------------------------------------------------------------- |
| **Temperature Tabs**       | Add data at multiple temperatures (25°C, 15°C, 50°C, 75°C, etc.)       |
| **Add Row**                | Add a new irradiance data point within the current temperature         |
| **Add Temp**               | Add a new temperature tab                                              |
| **Download Template**      | Download an Excel template for offline data entry                      |
| **Upload Template**        | Upload a completed Excel template to populate the grid                 |
| **Calculated Performance** | Real-time display of extracted STC values and temperature coefficients |
| **Continue**               | Proceed to the main module generator with pre-populated values         |

### Workflow

1. Click **Enter Key I-V Points** from the Add New Module modal
2. Enter data at 25°C, 1000 W/m² (minimum required)
3. Add additional irradiance rows and temperature tabs as available
4. Review the **Calculated Performance** panel for extracted values
5. Click **Continue** to proceed to the module generator
6. Review and finalize the module, then click **Save Module**

<Note>
  **Minimum Requirement:** At least one row of data at 25°C, 1000 W/m² is required. However, providing data at multiple temperatures and irradiances enables automatic calculation of temperature coefficients and relative efficiencies.
</Note>

***

## 6. Enter Full I-V Curves

The **Enter Full I-V Curves** option is recommended when you have complete I-V curve measurements at STC and other conditions. PlantPredict extracts all key electrical parameters automatically from the curve data.

<Frame caption="Module Generator - Enter Full I-V Curves">
  <img src="https://mintcdn.com/terabaseenergy/7d9cGfLAN1NeJWyT/images/add-new-module-fulliv-ui.png?fit=max&auto=format&n=7d9cGfLAN1NeJWyT&q=85&s=6918d623ba4ba2b330704c7dc2b63b2a" alt="Enter Full I-V Curves" width="1682" height="985" data-path="images/add-new-module-fulliv-ui.png" />
</Frame>

### Data Entry Format

For each I-V curve, enter current-voltage pairs from Isc (V=0) to Voc (I=0):

| Column      | Units | Description                                      |
| ----------- | ----- | ------------------------------------------------ |
| **Current** | A     | Current at each point on the I-V curve           |
| **Voltage** | V     | Voltage at each point on the I-V curve           |
| **Power**   | W     | Calculated power at each point (auto-calculated) |

### Features

| Element                    | Description                                                            |
| -------------------------- | ---------------------------------------------------------------------- |
| **Temperature Tabs**       | Add curves at multiple temperatures (25°C, 30°C, etc.)                 |
| **Irradiance Selector**    | Select or add irradiance levels for curves                             |
| **Add Curve**              | Add a new I-V curve at a new irradiance within the current temperature |
| **Add Temp**               | Add a new temperature tab                                              |
| **I-V Curve Chart**        | Real-time visualization of the entered curve                           |
| **Download Template**      | Download an Excel template for offline data entry                      |
| **Upload Template**        | Upload a completed Excel template to populate the grid                 |
| **Calculated Performance** | Real-time display of extracted STC values and temperature coefficients |
| **Continue**               | Proceed to the main module generator with pre-populated values         |

### Workflow

1. Click **Enter Full I-V Curves** from the Add New Module modal
2. Enter the I-V curve at 25°C, 1000 W/m² (minimum required)
3. Add additional curves at different irradiances and temperatures as available
4. Review the **Calculated Performance** panel for extracted values
5. Click **Continue** to proceed to the module generator
6. Review and finalize the module, then click **Save Module**

<Warning>
  **Minimum Data Requirements:**

  * At least one I-V curve at 25°C, 1000 W/m²
  * Each curve must contain at least **40 (I, V) data points**
</Warning>

<Tip>
  For easiest data entry with large datasets, use the **Download Template** option to get an Excel file, enter your data offline, then use **Upload Template** to populate the grid.
</Tip>