adapt_michelson_contrast_dict

stimupy.utils.contrast_conversions.adapt_michelson_contrast_dict(stim, michelson_contrast, mean_luminance=None)

Adapt Michelson contrast of image in dict

Parameters:

• stim (dict) – stimulus dictionary containing at least key “img”

• michelson_contrast (float) – desired Michelson contrast

• mean_luminance (float) – desired mean luminance; if None (default), dont change mean luminance

Returns:

dict with the stimulus (key: “img”), Michelson contrast (key: “michelson_contrast”), mean luminance (“mean_luminance”) and additional keys containing stimulus parameters

Return type:

dict[str, Any]