---
title: "Irrigation History and Water Usage"
canonical: "https://farmconnect.docs.rubiconwater.com/space/FCD/2029846565/Irrigation%20History%20and%20Water%20Usage"
format: markdown
---
> Macro (toc)

Once a program has finished it will be visible on the **Irrigation History** screen. Use this screen to identify successful program executions and generate water usage statistics for the program.

# Layout of the Irrigation History Screen

The program list will be ordered by start time by default, but you can click on any column to order by that column. For example, click on the **Program Successfully Executed** column to find all the *Executed* programs.

# Managing the Water Usage

If you have marked a program as *Executed*, you can use the :signpostIcon: program menu to view the program usage for the whole program or view the usage for each bay over a specified date range. Select **View Water Usage **from the menu to open the Water Usage screen.

> ℹ️ **Note**
> ℹ️ 
> ℹ️ Usage is NOT recorded for channels.

The Water Usage screen allows you to view and manage usages by program or by bay. You can calculate usages from program details or add usages manually for a program or for a bay or set of bays.

- To add usage to a program or bay **IF **that usage matches an existing bay irrigation, use the **Generate Water Usage **buttons for the program or bays.
- To add usage to a bay regardless of whether there is a matching bay irrigation, use the  :addBayWUIcon:  **Add bay water usage** button.
- To add usage by searching for recorded flow meter records and matching bay irrigations, use the **Find Water Usage** buttons for the program or bays.

## Adding a Usage for a Program

You can add a water usage for a whole program by using the **Generate Water Usage for Program** tool on the **By Program** tab. 

> ℹ️ **Note**
> ℹ️ 
> ℹ️ This process checks for any bay irrigations performed during the program and adds water usage to the bays depending on the flow rate provided and the duration of the irrigation. If there were no bay irrigations during the program, then no usages will be added.

**Step 1**

On the By Program tab of the Water Usage screen, select the program for which you want to add a usage and click the **Generate Water Usage for Program** button.

**Step 2**

Pick a water source from the drop-down list. If you pick a flow source with a flow meter then the application will use the flow rate recorded at the time, otherwise you will need to specify a flow rate.

You can also create a new water source by clicking **Create new flow source** and giving your flow source a name.

**Step 3**

On the Generate Water Use dialog select the **Overwrite Existing** checkbox and click **Submit** to apply your source.

## Adding Usage for a Bay or Bays for a Period

Add a usage for specific bays for a time period by using the **Generate Water Usage for Bays** tool on the **By Bay** tab. 

> ℹ️ **Note**
> ℹ️ 
> ℹ️ This process checks for any bay irrigations performed for the specified bays in the specified time period and adds water usage to the bays depending on the flow rate provided and the duration of the irrigation. If there were no irrigations for those bays during the period, then no usages will be added.

**Step 1**

On the **By Bays** tab, select the bays and the time period for which you want to add water usage then click the **Generate Water Usage for Bays** button.

> ℹ️ **Note**
> ℹ️ 
> ℹ️ If the button is disabled, make sure you have selected at least one bay from the drop-down list.

**Step 2**

Specify or create a flow source as for the **Generate Water Usage for Program** tool.

**Step 3**

On the Generate Water Use dialog select the **Overwrite Existing** checkbox and click **Submit** to apply your source.

## Adding a Usage for a Bay

You can also add a usage for a bay without any check against irrigation history. 

> ℹ️ **Note**
> ℹ️ 
> ℹ️ This option will simply add the specified usage to the specified bay regardless of any bay irrigations that may or may not have happened in the period.

**Step 1**

To add usage for a bay, click the :addBayWUIcon:  **Add bay water usage** button at the top right of the Water Usage list.

**Step 2**

In the **Add bay water usage** screen enter the following details:

- Specify the source or create a new source
- Specify the bay that the usage will apply to (you can only choose one bay)
- Enter the start time, the duration, and the flow rate applied.
- Select **Overwrite existing**.

**Step 3**

Click **Submit** to apply your source. The usage will be added immediately and will appear on the list of usages.

## Adding Usage with the Find Water Usage Tool

Use the **Find Water Usage** tool to find usages that have been recorded by flow meters. 

Click the button to search for recorded usages that match the program or bay filters that you have specified on the Water Usage screen. Any matching water usages will be added to the program or bays and will **replace** any usages currently applied to the program or bays.

# Editing Water Usages

Edit water usages by modifying the data in the table rows. This applies to any row regardless of how it was added. You can edit the following:

- Start time.
- Finish Time.
- Flow Rate.

Or you can delete the usage by clicking the **Delete** button.

# Export the Water Usage Table

Use the :exportWUIcon: **Export data to CSV file **button at the top left of the Water Usage table to save the table to a csv file.

---