environmentaltools.common.uv_to_magnitude_angle

environmentaltools.common.uv_to_magnitude_angle(u: Series | ndarray, v: Series | ndarray, labels: list = ['magnitude', 'angle'])

Convert u, v vector components to magnitude and direction.

Transforms Cartesian velocity/wind components (u, v) to polar form (magnitude, direction) using standard meteorological convention.

Parameters:

• u (pd.Series or np.ndarray) – Zonal (east-west) component.

• v (pd.Series or np.ndarray) – Meridional (north-south) component.

• labels (list) – Output column names for [magnitude, direction]. Defaults to [“magnitude”, “angle”].

Returns:

DataFrame with two columns containing magnitude (sqrt(u²+v²))

and angle in degrees [0, 360).

Return type:

pd.DataFrame