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

> Download weather data from integrated providers, upload custom files, or generate synthetic weather data

The Add New Weather page provides three methods for adding weather data to PlantPredict:

1. **Download from Vendor** — Retrieve weather data directly from integrated weather data providers
2. **Upload Your Own File** — Import custom weather files in supported formats
3. **Create Synthetic Weather** — Generate hourly weather data from monthly averages

Access this page by clicking **Add New Weather** from the [Weather Library](/user-guide/ui/weather-library).

<Frame caption="Add New Weather">
  <img src="https://mintcdn.com/terabaseenergy/AZwUADNYmjh7dCFp/images/add-new-weather-ui.png?fit=max&auto=format&n=AZwUADNYmjh7dCFp&q=85&s=abe34d535d092f803c734595cea90437" alt="Add New Weather" width="1708" height="2298" data-path="images/add-new-weather-ui.png" />
</Frame>

## Overview

PlantPredict integrates with multiple weather data providers, each offering different data types, coverage areas, and temporal resolutions. Enter your project coordinates to see which providers have data available for your location.

<Note>
  Not all weather data providers are available in all locations. Provider availability depends on geographic coverage and data licensing.
</Note>

***

## 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>**Latitude**</td>
      <td>Numeric</td>
      <td>°</td>
      <td>Enter the latitude of your project location. Positive values for North, negative for South. Used to query available weather data providers for your location.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**2**</td>
      <td>**Longitude**</td>
      <td>Numeric</td>
      <td>°</td>
      <td>Enter the longitude of your project location. Positive values for East, negative for West. Used to query available weather data providers for your location.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**3**</td>
      <td>**Clear Search**</td>
      <td>Button</td>
      <td>—</td>
      <td>Clears the latitude and longitude inputs and resets the provider search results.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**4**</td>
      <td>**Select File**</td>
      <td>Button</td>
      <td>—</td>
      <td>Opens a file browser to upload your own weather file. Supported formats: **CSV**, **TMY3**, **PPP** (PlantPredict native format), and **AWS**. After upload, PlantPredict guides you through the data mapping process to ensure correct integration. See [Weather File Upload Steps](#weather-file-upload-steps) below.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**5**</td>
      <td>**Generate File**</td>
      <td>Button</td>
      <td>—</td>
      <td>Opens the synthetic weather generator. Create hourly weather data from monthly average values. Useful when only monthly summary data is available for a location.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**6**</td>
      <td>**NSRDB PSM Download**</td>
      <td>Button</td>
      <td>—</td>
      <td>Download weather data from the **National Solar Radiation Database (NSRDB)** using the Physical Solar Model (PSM). Offers free datasets including: Hourly TMY, sub-hourly Time Series, and Multi-Year Time Series.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**7**</td>
      <td>**PVGIS Download**</td>
      <td>Button</td>
      <td>—</td>
      <td>Download weather data from **PVGIS** (Photovoltaic Geographical Information System). Provides a free Typical Meteorological Year (TMY) dataset with hourly meteorological and solar radiation data, compiled by selecting the most representative month from each calendar month across multiple years based on irradiance, temperature, and humidity patterns. No separate API key is required.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**8**</td>
      <td>**SolarAnywhere Download**</td>
      <td>Button</td>
      <td>—</td>
      <td>Download weather data from **SolarAnywhere**. Provides hourly weather and irradiance datasets generated from visible and infrared satellite data. Supports versions 3.4 through 4.0. Requires API credentials configured in [User Profile](/user-guide/ui/profile) or [Company Settings](/user-guide/ui/company-settings).</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**9**</td>
      <td>**Meteonorm Download**</td>
      <td>Button</td>
      <td>—</td>
      <td>Download weather data from **Meteonorm**. Provides unlimited access to Meteonorm's web service containing 8,325 weather stations and five geostationary satellites. Interpolation models deliver global Hourly TMY data.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**10**</td>
      <td>**NASA-SSE Download**</td>
      <td>Button</td>
      <td>—</td>
      <td>Download weather data from **NASA-SSE** (Surface meteorology and Solar Energy). Provides freely available monthly data from NASA Langley Research Center, converted to synthetic hourly weather through a weather generator.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**11**</td>
      <td>**SolarGIS Download**</td>
      <td>Button</td>
      <td>—</td>
      <td>Download weather data from **SolarGIS**. Provides programmatic access to SolarGIS irradiance and weather datasets. Supported formats: TMY15, TMY60. Note: PVPlanner format is deprecated. Requires API credentials.</td>
      <td>—</td>
    </tr>

    <tr>
      <td>**12**</td>
      <td>**Solcast Download**</td>
      <td>Button</td>
      <td>—</td>
      <td>Download weather data from **Solcast**. Provides historical TMY data using the Engerer2 separation model with global aerosol measurements from high-resolution satellite imagery. Supported formats: TMY Hourly, PT15M (15-minute), PT60M (60-minute). Requires API credentials.</td>
      <td>—</td>
    </tr>
  </tbody>
</table>

***

## Integrated Weather Data Providers

| Provider          | Data Types                                                 | Coverage                                     | API Key Required |
| ----------------- | ---------------------------------------------------------- | -------------------------------------------- | ---------------- |
| **NSRDB PSM**     | Hourly TMY, Sub-hourly Time Series, Multi-Year Time Series | Americas, parts of Asia                      | No               |
| **PVGIS**         | Hourly TMY                                                 | Europe, Africa, Asia, parts of South America | No               |
| **SolarAnywhere** | Versions 3.4 – 4.0                                         | Global                                       | Yes              |
| **Meteonorm**     | Hourly TMY                                                 | Global                                       | No               |
| **NASA-SSE**      | Synthetic Hourly from Monthly                              | Global                                       | No               |
| **SolarGIS**      | TMY15, TMY60 (PVPlanner deprecated)                        | Global                                       | Yes              |
| **Solcast**       | TMY Hourly, PT15M, PT60M                                   | Global                                       | Yes              |

<Info>
  Some providers require API credentials to be configured before downloading. Configure your personal API keys in [User Profile](/user-guide/ui/profile) under the Weather Provider Configuration tab. Company-wide API keys can be configured by Admins in [Company Settings](/user-guide/ui/company-settings).
</Info>

***

## Supported Upload Formats

When uploading your own weather data, the following file formats are supported:

| Format               | Description                                       |
| -------------------- | ------------------------------------------------- |
| **CSV**              | Comma-separated values with custom column mapping |
| **TMY3**             | NREL Typical Meteorological Year 3 format         |
| **PPP**              | PlantPredict native weather format                |
| **AWS**              | AWS weather format                                |
| **EPW**              | EnergyPlus Weather format                         |
| **3Tier/Vaisala**    | 3Tier/Vaisala weather format                      |
| **Solar Prospector** | NREL Solar Prospector format                      |

In addition to the formats above, any reasonable Excel workbook or CSV file can be uploaded and formatted during the upload process.

<Note>
  PlantPredict can handle weather files of almost any granularity, from 60 minutes down to single minute intervals.
</Note>

***

## Weather File Upload Steps

After clicking **Select File** and choosing your weather file, PlantPredict guides you through a multi-step process to ensure your data is correctly mapped and validated.

### Step 1: Select File

Click **Select File** (callout #4) and browse to select your weather file. Supported formats include CSV, Excel workbooks, and the standard formats listed above.

### Step 2: Define Locality

Specify the geographic location associated with the weather data, including latitude, longitude, and time zone information.

### Step 3: Set Parameters

Enter optional metadata for the weather file. While not required, it is highly encouraged to fill in these values for informational purposes and future reference.

### Step 4: Format Data

This is the most critical step in the upload process. The goal is to map columns from your uploaded file to PlantPredict weather variables.

**Key elements:**

* **Data Preview Table** — Displays all data from the uploaded file on the right side of the screen
* **Variables Tab** — Select which weather variables to include using checkboxes, then use dropdown menus to specify which column contains each variable
* **Timestamp Tab** — Define the **Start Date** and **Interval Duration**; PlantPredict automatically extrapolates the end date
* **Header Rows to Skip** — Indicate how many header rows exist in your file (these will be excluded from the weather data)
* **Leap Day Toggle** — Choose whether to include leap day(s) in the timestamp definition

<Info>
  **Minimum Required Data:** A PlantPredict weather file requires at minimum **irradiance** (GHI or POA) and **temperature** data.
</Info>

### Step 5: Quality Check

Review all uploaded data before the PlantPredict weather file is created. This step includes:

* **Data Visualization** — Compare your weather data against the clear sky model to detect potential timeshifts
* **Timeshift Correction** — If a timeshift is detected, use the built-in data shifting feature to correct it without restarting the process

***

## Tips and Troubleshooting

<Warning>
  **No Blanks or NULLs Allowed**

  Imported files must not contain blank cells or NULL values. If your weather file contains blanks or NULLs, replace them with "0" prior to importing. The Excel function `=COUNTBLANK()` can help identify blank cells.
</Warning>

### Common Issues

| Issue                                     | Solution                                                                                                                                                                                                       |
| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Projected End Date doesn't match file** | Your file likely has duplicate or missing data entries. Compare the projected End Date in Step 4 to the final timestamp in your Excel file. If they don't match, investigate further.                          |
| **Upload errors on first step**           | The application is having trouble parsing the file. Check that headers are correct and contain the expected data types. Try simplifying the file by removing all-but-one header row.                           |
| **Spectral corrections not applied**      | If variables affecting spectral correction (relative humidity, dewpoint temperature, precipitable water) are not included, spectral calculations will not be performed in predictions using this weather file. |

<Tip>
  **Detecting Timeshifts:** Use the Quality Check step to visualize how your weather data compares to the clear sky model. This is especially useful for detecting timeshifts in measured data.
</Tip>