---
jupytext:
  text_representation:
    extension: .md
    format_name: myst
    format_version: 0.13
    jupytext_version: 1.13.8
kernelspec:
  display_name: 'Python 3'
  name: python3
---

(junction)=
# junction
A hydraulic junction coupling two reservoirs to a common output tunnel. Water flows in the junction tunnels according to the pressure and mass balance

|   |   |
|---|---|
|Input connections|{ref}`reservoir`, {ref}`plant`, {ref}`gate`, {ref}`junction`, {ref}`creek_intake`|
|Output connections|{ref}`plant`, {ref}`junction_gate`, {ref}`junction`, {ref}`reservoir`|
|License|SHOP_OPEN|
|Release version|13.0.0.a|

```{contents}
:local:
:depth: 1
```

```{warning}
The junction object is old and will be deprecated in the future. A junction can be replaced with three connected [](tunnel) objects.
```

## Examples
  - [](junction-example)
  



## Attributes
```{code-cell} ipython3
:tags: ['remove-input', 'full-width']

from IPython.core.display import HTML
HTML("""<table id="junction-table" class="display compact"></table>
<script>
enableDataTable(
  "#junction-table",
  "/_static/data/junction-attribute-table.json"
);
</script>
""")
```

(junction:junc_slack)=
### junc_slack
Future deprecation: All junctions should be modelled by using the tunnel object (does not require additional license). Flag determining whether slack variables should be added to the mass balance of the junction (xUnit: NO_UNIT, yUnit: NO_UNIT)


(junction:altitude)=
### altitude
Future deprecation: All junctions should be modelled by using the tunnel object (does not require additional license). Physical height of the connection point between tunnel_1 and tunnel_2 coming into this junction (xUnit: METER, yUnit: METER)


(junction:tunnel_flow_1)=
### tunnel_flow_1
Future deprecation: All junctions should be modelled by using the tunnel object (does not require additional license). Resulting flow in tunnel_1 (xUnit: NO_UNIT, yUnit: M3/S)


(junction:tunnel_flow_2)=
### tunnel_flow_2
Future deprecation: All junctions should be modelled by using the tunnel object (does not require additional license). Resulting flow in tunnel_2 (xUnit: NO_UNIT, yUnit: M3/S)


(junction:sim_tunnel_flow_1)=
### sim_tunnel_flow_1
Future deprecation: All junctions should be modelled by using the tunnel object (does not require additional license). The simulated flow in tunnel_1 of the junction (xUnit: NO_UNIT, yUnit: M3/S)


(junction:sim_tunnel_flow_2)=
### sim_tunnel_flow_2
Future deprecation: All junctions should be modelled by using the tunnel object (does not require additional license). The simulated flow in tunnel_2 of the junction (xUnit: NO_UNIT, yUnit: M3/S)


(junction:loss_factor_1)=
### loss_factor_1
Future deprecation: All junctions should be modelled by using the tunnel object (does not require additional license). Friction loss factor for tunnel_1 into this junction multiplied with the square of the flow to get head loss (xUnit: S2/M5, yUnit: S2/M5)


(junction:loss_factor_2)=
### loss_factor_2
Future deprecation: All junctions should be modelled by using the tunnel object (does not require additional license). Friction loss factor for tunnel_2 into this junction multiplied with the square of the flow to get head loss (xUnit: S2/M5, yUnit: S2/M5)


(junction:min_pressure)=
### min_pressure
Future deprecation: All junctions should be modelled by using the tunnel object (does not require additional license). Minimum pressure requirement at the connection point of tunnel_1 and tunnel_2 (xUnit: NO_UNIT, yUnit: METER)


(junction:pressure_height)=
### pressure_height
Future deprecation: All junctions should be modelled by using the tunnel object (does not require additional license). Resulting pressure height from the optimization calculations (xUnit: NO_UNIT, yUnit: METER)


(junction:sim_pressure_height)=
### sim_pressure_height
Future deprecation: All junctions should be modelled by using the tunnel object (does not require additional license). Resulting pressure height from the simulation (xUnit: NO_UNIT, yUnit: METER)


(junction:incr_cost)=
### incr_cost
Future deprecation: All junctions should be modelled by using the tunnel object (does not require additional license). Resulting marginal value of water in this junction referred to ocean level accounting for headloss between the tunnel connection point and the plant below (xUnit: NO_UNIT, yUnit: NOK)


(junction:local_incr_cost)=
### local_incr_cost
Future deprecation: All junctions should be modelled by using the tunnel object (does not require additional license). Resulting marginal value of water  in this junction referred to the next reservoir below accounting for headloss between the tunnel connection point and the plant below (xUnit: NO_UNIT, yUnit: NOK)