ENH: better documentation of the contrast function