netsse.tools.misc_func.ang_mean
===============================

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

   Calculates the mean angle from an array of angular data.

   This function properly handles the circularity of angles at 360
   degrees.

   :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: **mean_a** -- Mean angle in the range [-180,180) degrees.
   :rtype: float

   .. seealso::

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

      :obj:`ang_std`
          Calculates the circular standard deviation of an array of angular data.

   .. rubric:: Example

   >>> mean_angle = ang_mean(angles, unit='deg')