easyclimate.physics.convection

Submodules

Functions

calc_brunt_vaisala_frequency_atm(→ xarray.DataArray)

Calculation of the Brunt-väisälä frequency for the vertical atmosphere.

calc_static_stability(→ xarray.DataArray)

Calculate the static stability within a vertical profile.

Package Contents

easyclimate.physics.convection.calc_brunt_vaisala_frequency_atm(potential_temperature_data: xarray.DataArray, z_data: xarray.DataArray, vertical_dim: str, g: float = 9.8) xarray.DataArray

Calculation of the Brunt-väisälä frequency for the vertical atmosphere.

\[N = \left( \frac{g}{\theta} \frac{\mathrm{d}\theta}{\mathrm{d}z} \right)^\frac{1}{2}\]

Parameters

potential_temperature_data: xarray.DataArray.

Vertical atmospheric potential temperature.

z_data: xarray.DataArray ( \(\mathrm{m}\) ).

Vertical atmospheric geopotential height.

Attention

The unit of z_data should be meters, NOT \(\mathrm{m^2 \cdot s^2}\) which is the unit used in the representation of potential energy.

vertical_dim: str.

Vertical coordinate dimension name.

g: float, default: 9.8.

The acceleration of gravity.

Returns

Brunt-väisälä frequency, units according to potential_temperature_data \(^{1/2}\).

xarray.DataArray

Reference

easyclimate.physics.convection.calc_static_stability(temper_data: xarray.DataArray, vertical_dim: str, vertical_dim_units: Literal['hPa', 'Pa', 'mbar']) xarray.DataArray

Calculate the static stability within a vertical profile.

\[\sigma = - T \frac{\partial \ln \theta}{\partial p}\]

Parameters

temper_data: xarray.DataArray.

Air temperature.

vertical_dim: str.

Vertical coordinate dimension name.

vertical_dim_units: str.

The unit corresponding to the vertical p-coordinate value. Optional values are hPa, Pa, mbar.

Returns

Static stability, units according to temper_data_units^2 vertical_dim_units^-1.

xarray.DataArray.

Reference

  • Howard B. Bluestein. (1992). Synoptic-Dynamic Meteorology in Midlatitudes: Principles of Kinematics and Dynamics, Vol. 1