---
description: >-
  These files contain all information needed by the model about observed
  precipitation data.
---

# pcp.cli and pcp data files

The **precipitation data files** contain the observed precipitation input data. They are named by the user and must have the file ending \*.pcp. There must be one file per station used in the simulation. As in all SWAT+ input files, the first line in the precipitation data files is reserved for user comments. The second line contains the column headers for the third line, which lists basic information about the station.&#x20;

<table><thead><tr><th>Field</th><th width="292">Description</th><th width="150">Type</th><th>Unit</th></tr></thead><tbody><tr><td>nbyr</td><td>Length of the precipitation time series</td><td>integer</td><td>years</td></tr><tr><td>tstep</td><td>Time step of the precipitation data</td><td>integer</td><td>n/a</td></tr><tr><td>lat</td><td>Latitude of the precipitation station</td><td>real</td><td>Decimal Degrees</td></tr><tr><td>lon</td><td>Longitude of the precipitation station</td><td>real</td><td>Decimal Degrees</td></tr><tr><td>elev</td><td>Elevation of the precipitation station</td><td>real</td><td>m</td></tr></tbody></table>

Starting in the fourth line, the year, Julian day, and precipitation amount are listed. There are no headers for these columns.

<table><thead><tr><th>Field</th><th width="292">Description</th><th width="150">Type</th><th>Unit</th></tr></thead><tbody><tr><td>year</td><td>Year of the observation</td><td>integer</td><td>n/a</td></tr><tr><td>jday</td><td>Julian day of the observation</td><td>integer</td><td>n/a</td></tr><tr><td>pcp</td><td>Observed precipitation</td><td>real</td><td>mm</td></tr></tbody></table>

If the user wishes to run simulations at a sub-daily time step, precipitation data has to be provided at the simulation time step. Currently, the model is able to run at an hourly time step. Smaller time steps have not been tested yet. Three additional columns need to be included in the hourly precipitation files:&#x20;

<table><thead><tr><th>Field</th><th width="292">Description</th><th width="150">Type</th><th>Unit</th></tr></thead><tbody><tr><td>year</td><td>Year of the observation</td><td>integer</td><td>n/a</td></tr><tr><td>jday</td><td>Julian day of the observation</td><td>integer</td><td>n/a</td></tr><tr><td>mon</td><td>Month of the observation</td><td>integer</td><td>n/a</td></tr><tr><td>day</td><td>Day of the observation</td><td>integer</td><td>n/a</td></tr><tr><td>hr</td><td>Time of the observation</td><td>integer</td><td>n/a</td></tr><tr><td>pcp</td><td>Observed precipitation</td><td>real</td><td>mm</td></tr></tbody></table>

{% hint style="info" %}
A negative 99.0 (-99.0) should be inserted for missing data. This value tells SWAT+ to generate precipitation for that day.
{% endhint %}

The **pcp.cli** file lists the names of the precipitation data files used in the simulation. The first line is reserved for user comments. The second line is reserved for the column header "filename". The user can list as many precipitation data file names as needed for the simulation. Only one file name should be listed per line. All file names listed in [**weather-sta.cli**](weather-sta.cli) must be listed here. For every file name listed in **pcp.cli**, a file with that name must be provided by the user that contains the precipitation data measured at the station. &#x20;
