> For the complete documentation index, see [llms.txt](https://water-strategy.gitbook.io/waterstrategy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://water-strategy.gitbook.io/waterstrategy/modeling-basics/parameters.md).

# Parameters

Paramters are functions that return a value in the model at each time-step. These values can be a constant, based on time (e.g., on the day or month), a calculation based on the time step's reservoir storage and many other calculations. Custom parameter can also be written in Python.

This page describes (most of) the parameter types supported by Pywr. An overview of parameters in Pywr can be found [here](https://pywr.github.io/pywr-docs/master/json.html#parameters). The full list of built-in Pywr parameters are found [here](https://pywr.github.io/pywr-docs/master/api/pywr.parameters.html).

## 1. Creating a Parameter

In a Network, click the 'Parameters' Tab:

<figure><img src="/files/ykIZD4f5LkJ3u2lp2ZGv" alt=""><figcaption><p>CLick the 'parameters' tab</p></figcaption></figure>

Next to the 'Parameters-Type Categories' section, click the '+' button and select 'PYWR\_PARAMETER'.

<figure><img src="/files/zUi0yIq4YOAeiJPwiDZA" alt=""><figcaption><p>Click on pywr_parameter</p></figcaption></figure>

A text-input will appear. Enter the name of your parameter:\\

<figure><img src="/files/Ktm7Qgucs8bhj3rhKln0" alt=""><figcaption><p>Enter the parameter name</p></figcaption></figure>

Modify the parameter as required in the JSON editor provided:

<figure><img src="/files/vmFSeYwqxaIRrkYAhzgB" alt=""><figcaption></figcaption></figure>

{% embed url="<https://www.youtube.com/watch?v=u-3hotZj_44>" %}
Video demonstrating how to use a parameter for multiple nodes
{% endembed %}

## 2. Parameter editors in WaterStrategy

To make parameter modifications simpler, WaterStrategy offers editors for commonly used Parameters, such as Monthly Profile parameters, with pre-populated default values, and graphical editors to make entering of data simpler.

#### Example parameter editor

In the Parameters Tab, when adding a new Parameter, select 'PYWR\_PARAMETER\_MONTHLY\_PROFILE' as shown:\\

<figure><img src="/files/M7QifAgA0B1OCzvhJSZ0" alt=""><figcaption><p>Select PYWR_PARAMETER_MONTHLY_PROFILE</p></figcaption></figure>

Note that the edior which appears will show a JSON tab, but also a Plot and Table tab. Modifying the data in the table will automaticall update the data in the JSON as shown:\\

<figure><img src="/files/mDQEh1XqUhIXHqJwzzqf" alt=""><figcaption><p>Note the values have been edited in a spreadsheet editor</p></figcaption></figure>

These changes automatically update the JSON:

<figure><img src="/files/Zi2SyhDx4w1mhZ074zsp" alt=""><figcaption><p>Data is automatically updated in the JSON section</p></figcaption></figure>

##


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://water-strategy.gitbook.io/waterstrategy/modeling-basics/parameters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
