adapt_michelson_contrast
========================



.. py:function:: stimupy.utils.contrast_conversions.adapt_michelson_contrast(img, michelson_contrast, mean_luminance=None)


   Adapt Michelson contrast of image

   :param img: stimulus array
   :type img: np.ndarray
   :param michelson_contrast: desired Michelson contrast
   :type michelson_contrast: float
   :param mean_luminance: desired mean luminance; if None (default), dont change mean luminance
   :type mean_luminance: float

   :returns: **img** -- image with adapted michelson contrast and mean luminance if passed
   :rtype: np.ndarray