Module ocean
Brief summary
The ocean module maintains the ocean properties in contact with the ice — the potential temperature state.ocean_temp (°C), the salinity state.ocean_salinity (g kg⁻¹) and the thermal forcing state.ocean_thermal_forcing (K) — consumed by the sub-shelf melt laws of the bmb module. They are evaluated at the ice base under ice and at the sea floor in open water, from a depth profile (method: profile) or from 2-D fields provided by an input module (method: fields), plus a uniform temperature anomaly in time. The parameters of the module are described here.
State variables
Reads: t, thk, topg, lsurf, water_level
Writes: ocean_temp, ocean_salinity, ocean_thermal_forcing
Methods
At every update the module evaluates the selected method at the depth \(z\) relative to the water level (negative below it): \(z = \min(\mathrm{lsurf} - \mathrm{water\_level},\, 0)\) under ice (the ice base) and \(z = \min(\mathrm{topg} - \mathrm{water\_level},\, 0)\) in open water (the sea floor). It then adds the uniform anomaly \(\delta T(t)\) of anomaly_array (rows [time, delta_temp], interpolated linearly in time and held constant outside the listed times) and publishes
with the linearised freezing point \(T_f = \lambda_1 S + \lambda_2 + \lambda_3 z\) (freezing_point; the defaults are the ISOMIP+ values of Asay-Davis et al., 2016).
profile— horizontally uniform, piecewise-linear \(T(z)\) and \(S(z)\) given byprofile.array(rows[z, temp, salinity], interpolated linearly in depth and held constant outside the listed depths). The default is the ISOMIP+ WARM profile; the COLD profile is given as a comment in the configuration file.fields— 2-D state variables provided by an input module (e.g. in theload_ncdfinput file): the temperature named byfields.tempand the salinity named byfields.salinity(or the uniformfields.salinity_ref). When a thermal forcing is given instead (fields.thermal_forcing, e.g. from ISMIP6), the temperature is rebuilt as \(\mathrm{TF} + T_f(S, z)\), so that the published thermal forcing equals the input plus the anomaly.
Without an ocean (the "no ocean" water level of the thk masks) the depth is clipped at 0 and the fields stay finite; no melt law uses them then.
Module ordering
ocean reads the geometry and the water level of the current step, so it runs after the input modules and before bmb:
Example usage
A warm-water profile with +1 K of ocean warming over 50 years:
# @package _global_
processes:
ocean:
method: profile
profile:
array:
- ["z", "temp", "salinity"]
- [0.0, -1.9, 33.8]
- [-720.0, 1.0, 34.7]
anomaly_array:
- ["time", "delta_temp"]
- [2000.0, 0.0]
- [2050.0, 1.0]
An ISMIP6 thermal-forcing field read from the input file:
processes:
ocean:
method: fields
fields:
temp: ""
thermal_forcing: thermal_forcing
salinity: ""
salinity_ref: 34.5
Parameters
The complete default configuration file can be found here: ocean.yaml.
Structure of the parameters:
ocean
├── method
├── freezing_point
│ └── ...
├── anomaly_array
├── profile
│ └── ...
└── fields
└── ...
Description of the parameters:
| Name | Description | Default value | Units |
|---|---|---|---|
method
|
Ocean forcing to use: profile (horizontally uniform, piecewise-linear T(z) and S(z)) or fields (2-D fields provided by an input module). |
profile | — |
anomaly_array
|
Uniform ocean-temperature anomaly delta_T(t) added to every method, as rows [time, delta_temp] after a header row; interpolated linearly in time and held constant outside the listed times. | [['time', 'delta_temp'], [0.0, 0.0]] | yr, °C |
freezing_point
| Name | Description | Default value | Units |
|---|---|---|---|
freezing_point.lambda1
|
Salinity coefficient of the linearised freezing point T_f = lambda1 S + lambda2 + lambda3 z. The defaults of the three coefficients are the ISOMIP+ values (Asay-Davis et al., 2016). | -0.0573 | °C (g kg\( ^{-1} \))\( ^{-1} \) |
freezing_point.lambda2
|
Constant of the linearised freezing point. | 0.0832 | °C |
freezing_point.lambda3
|
Depth coefficient of the linearised freezing point, with z the depth relative to the water level (negative below it). | 0.000761 | °C m\( ^{-1} \) |
profile
| Name | Description | Default value | Units |
|---|---|---|---|
profile.array
|
Rows [z, temp, salinity] after a header row, with z the depth relative to the water level (negative below it). Interpolated linearly in depth and held constant outside the listed depths. The default is the ISOMIP+ WARM profile (Asay-Davis et al., 2016). | [['z', 'temp', 'salinity'], [0.0, -1.9, 33.8], [-720.0, 1.0, 34.7]] | m, °C, g kg\( ^{-1} \) |
fields
| Name | Description | Default value | Units |
|---|---|---|---|
fields.temp
|
Name of the state variable holding the ocean potential temperature (°C). Leave empty when a thermal forcing is given instead. | thetao | — |
fields.salinity
|
Name of the state variable holding the ocean salinity (g kg^{-1}). Leave empty to use salinity_ref. |
so | — |
fields.thermal_forcing
|
Name of the state variable holding the thermal forcing (K), e.g. from ISMIP6. When set, the temperature is rebuilt as TF + T_f(S, z), so the published ocean_thermal_forcing equals it plus the anomaly. |
— | |
fields.salinity_ref
|
Uniform salinity used when salinity is empty. |
34.5 | g kg\( ^{-1} \) |
Contributors: Thomas Gregov.