wrf.udhel

wrf.udhel(zstag, mapfct, u, v, wstag, dx, dy, bottom=2000.0, top=5000.0, meta=True)

Return the updraft helicity.

This function calculates updraft helicity to detect rotating updrafts. The formula follows Kain et al., 2008, Wea. and Forecasting, 931-952, but this version has controls for the limits of integration, bottom to top, in m AGL. Kain et al used 2000 to 5000 m. The expected range is 25 to 250 m-2/s-2. Keith Brewster, CAPS/Univ. of Oklahoma ; March, 2010

This is the raw computational algorithm and does not extract any variables from WRF output files. Use wrf.getvar() to both extract and compute diagnostic variables.

Parameters:
  • zstag (xarray.DataArray or numpy.ndarray) – Geopotential height in [m] that is at least three dimensions with a staggered vertical dimension. The rightmost dimensions are bottom_top_stag x south_north x west_east.

  • mapfct (xarray.DataArray or numpy.ndarray) – The map scale factor on the mass grid. An array of at least two dimensions, whose rightmost two dimensions must be south_north x west_east. If this array is more than two dimensions, they must be the same as zstag’s leftmost dimensions.

  • u (xarray.DataArray or numpy.ndarray) –

    The u component of the wind [m s-1] whose rightmost three dimensions must be bottom_top x south_north x west_east. The leftmost dimensions must be the same as zp’s leftmost dimensions.

    Note

    This variable must be supplied as a xarray.DataArray in order to copy the dimension names to the output. Otherwise, default names will be used.

  • v (xarray.DataArray or numpy.ndarray) – The v component of the wind [m s-1] whose rightmost three dimensions must be bottom_top x south_north x west_east. The leftmost dimensions must be the same as zstag’s leftmost dimensions.

  • wstag (xarray.DataArray or numpy.ndarray) – The z component of the wind [m s-1] with the same dimensionality as zstag.

  • dx (float) – The distance between x grid points.

  • dy (float) – The distance between y grid points.

  • bottom (float, optional) – The bottom limit of integration. Default is 2000.0.

  • top (float, optional) – The upper limit of integration. Default is 5000.0.

  • meta (bool) – Set to False to disable metadata and return numpy.ndarray instead of xarray.DataArray. Default is True.

Warning

The input arrays must not contain any missing/fill values or numpy.nan values.

Returns:

The updraft helicity. If xarray is enabled and the meta parameter is True, then the result will be an xarray.DataArray object. Otherwise, the result will be a numpy.ndarray object with no metadata.

Return type:

xarray.DataArray or numpy.ndarray