windkit.veer_extrapolate#
- windkit.veer_extrapolate(wind_direction, height, veer=0.0, coord_height='height')[source]#
Extrapolate wind direction to new heights using linear veer.
Notes
Linear veer extrapolation:
wd_2 &= (wd_1 + v \cdot (h_2 - h_1)) \pmod{360}
where:
h_1 &= \mathrm{ known\, height} h_2 &= \mathrm{ new\, height} wd_1 &= \mathrm{ wind\, direction\, at\, height\,} h_1 wd_2 &= \mathrm{ wind\, direction\, at\, height\,} h_2 v &= \mathrm{ wind\, veer\, (deg/m)}
- Parameters:
wind_direction (xarray.DataArray) – Wind direction DataArray with wind directions at known heights. A height coordinate must be present. If the height coordinate is also a dimension with more than one known height, the nearest height to each target height will be used. If wind directions are at unstructured heights (i.e., height is a coordinate but not a dimension), only one target height can be used, or varying heights that match the dimensions of wind_direction.
height (number, collection of numbers, or xarray.DataArray) – New heights to which wind directions will be extrapolated.
veer (number, xarray.DataArray, optional) – Wind veer in degrees per meter, by default 0.0. A DataArray can be provided to have varying veer over other dimensions (e.g., time). If the veer also varies with height, the height nearest to the target height will be used.
coord_height (str, optional) – Name of the height coordinate in wind_direction and new_heights, by default “height”.
- Returns:
New time-series wind climate data array with wind directions at the specified heights.
- Return type: