Causal networks
Overview
What are causal networks?
Causal networks are models that describe the relationships between climate, adaptation options and outcomes for environmental, cultural, social, and economic values and assets (adapted from (Peeters et al. 2022)). They include the links which form the basis of the Driver-indicator-response models (e.g. EWR tool: hydrology to indicators), in addition to the links that connect indicators to objectives that are defined for key values.
In HydroBOT (and hence, this website), we use the word ‘theme’ to refer to the dimension described by the causal network, scaling typically from proximate, granular values (e.g. fish spawning) to larger-scale values such as species, groups of species, or decadal management targets. In the paper describing HydroBOT, this dimension is referred to as ‘value’, representing the use of ‘value’ defined in the sense of an ‘ecological value’, i.e. any social, economic, environmental or cultural asset or function of significance, importance, worth, or use. While that use of ‘value’ is closest to the meaning of this dimension, we do not use it in HydroBOT or here because in describing the functioning of HydroBOT, the word ‘value’ is too easily confused with its meaning as ‘a number’ or even more generally a state, such as the ‘value’ of a function argument.
Causal networks can show many relationships and outcomes. To illustrate here, we show the links between EWRs (hydrologic indicators), proximate environmental objectives, larger-scale objectives, and finally broad-based ecological groupings.
Where do they come from?
The causal networks for environmental values relevant to the EWR tool, and so along the environmental ‘theme dimension’, are derived from specific documents detailing the relationships between indicators and objectives for those bottom-line elements. Other ‘theme’ dimensions, e.g. cultural, social, or economic would have separate causal networks linking different values relevant to those themes. For the present example, we focus on environmental values in two catchments of the Murray-Darling Basin and so we draw the causal relationships from the Long Term Water Plans (LTWPs) produced by the states (e.g. DEW 2020; DRDMW 2022; DELWP and Department of Environment, Land, Water, and Planning 2022; Planning, Environment, and State of NSW 2023). The LTWPs report the environmental water requirements (EWRs) for spatially explicit objectives to be achieved. These objectives are aimed to support the completion of all elements of a lifecycle of an organism or group of organisms (taxonomic or spatial). Objectives are described for five target groups and are associated with long-term targets (5, 10, and 20 year) of the LTWP’s management strategies. The links from EWRs to environmental objectives to long-term targets are captured in the causal networks to enable assessment of outcomes in direct equivalence to the LTWPs’ management strategies.
How are they useful?
The causal networks enables 1) visual representation of the complex inter-relationships between scenario inputs (hydrographs) and river-related outcomes and 2) assessment of outcomes aggregated along the thematic dimension. The former, aids transparency, elucidating the targets and causal relationships behind the Driver-indicator-response models and is a useful device for communication about HydroBOT and its outputs. The latter allows outcomes to be assessed for individual (or sets of) environmental objectives, target groups, long-term targets, or at larger theme groupings to identify synergies and trade-offs among values.
In HydroBOT
HydroBOT provides various functions for creation and manipulation of causal networks, depending on what needs to be plotted or investigated, and the causal plots page provides some examples of various ways they can be visualised with HydroBOT.
HydroBOT provides the causal network for the EWR tool in the HydroBOT::causal_ewr
data. Until recently, this was the only source. More recently (early 2025), the EWR tool itself provides its own causal networks. These are brought over to HydroBOT and become HydroBOT::causal_ewr
after testing. This process happens frequently, but if there is any question about whether the networks are current, the network in the installed version of py-ewr
can be accessed with HydroBOT::get_causal_ewr()
.
Other networks can be supplied by the user to all functions that require them. In this case, the network requirements are to be a data frame or list of dataframes with the relevant mapping between levels and any other grouping variables. I.e. there might be columns for spatial units if the network varies in space, and then the ‘level1’ column might contain several rows with different values that all have the same value in the ‘level2’ column. See the structure of causal_ewr
for an example.