netsse.tools.misc_func.ang_std
==============================

.. py:function:: netsse.tools.misc_func.ang_std(angles, unit='deg')

   Calculates the circular standard deviation of an array of
   angular data.

   This function properly handles the circularity of angles at 360
   degrees. The standard "two-pass" computation is implemented.

   :param angles: Array of angles.
   :type angles: array_like
   :param unit: Specifies the unit of the angles as ``'rad'`` or
                ``'deg'``. The default is ``'deg'``.
   :type unit: {'deg','rad'}, optional

   :returns: **std_a** -- Circular standard deviation.
   :rtype: float

   .. seealso::

      :py:obj:`ang_diff`
          Calculates the signed difference between two angles.

      :py:obj:`ang_mean`
          Calculates the mean angle from an array of angular data.

   .. rubric:: Example

   >>> std_angle = ang_std(angles, unit='deg')