Skip to content

Node Types

This table introduces the most commonly used Pywr node types:

Node TypeIconBrief Description
Input NodeInput nodes represent water inputs into the system.
Catchment NodeCatchment nodes are often used to represent river or other type of inflow into the system.
Proportional Input NodeProportional input node is intended for a simple case of where fixed ratio of flow is required to be distributed to multiple downstream routes.
Link NodeLink node represents a link in the water system or other point of interest where a maximum or minimum flow constraint or an allocation priority are assigned.
River NodeRiver node is a node in the river network, which may have multiple upstream nodes (i.e. a confluence) but only one downstream node.
Delay NodeThese delay flow for a given number of timesteps or days. This is used when flow propagation time cannot be ignored, for example because time-steps are relatively short.
Storage NodeStorage node is a general node that can store water (like dams or aquifers), which have a minimum and maximum volume restrictions.
Reservoir NodeReservoir node is a type of storage node with additional functionality to represent evaporation and precipitation.
Output NodeOutput nodes are locations where water leaves the system.
Loss Link NodeLoss link allows for the definition of a fixed proportional loss of flow that goes through this node.
Turbine NodeTurbine node can represent a turbine of a hydropower station. It calculates the flow required to generate a particular hydropower production target in each time step.

Pywr Node types can also be further sub-divided into 6 categories: Water Input, Water Transport, Water Storage, Water Output, Hydropower, and Others. You can find more details about these groupings of nodes and nodes types in the sub-sections of the ‘Node Types’ section.

An overview of nodes in Pywr can be found here. The full list of built-in nodes in Pywr can be found here.