stimupy.stimuli.mueller_lyers#

Demos#

Functions#

mueller_lyer

Mueller-Lyer's (1896) illusion

two_sided

Mueller-Lyer's (1896) illusion

mueller_lyer(visual_size=None, ppd=None, shape=None, outer_lines_length=None, outer_lines_angle=45, target_length=None, line_width=0, intensity_outer_lines=1.0, intensity_target=0.5, intensity_background=0.0)[source]#

Mueller-Lyer’s (1896) illusion

Parameters:
  • visual_size (Sequence[Number, Number], Number, or None (default)) – visual size [height, width] of grating, in degrees

  • ppd (Sequence[Number, Number], Number, or None (default)) – pixels per degree [vertical, horizontal]

  • shape (Sequence[Number, Number], Number, or None (default)) – shape [height, width] of grating, in pixels

  • outer_lines_length (Number) – length of outer lines in degrees visual angle

  • outer_lines_angle (Number (optional)) – angle of outer lines in degrees, by default 45. Must be between -180 and 180 degrees.

  • target_length (Number) – length of target line in degrees visual angle

  • line_width (Number (optional)) – line width in degrees visual angle; if 0 (default), line width is 1 px

  • intensity_outer_lines (Number (optional)) – intensity value of outer lines, by default 0.01

  • intensity_target (Number (optional)) – intensity value of target line, by default 0.5

  • intensity_background (Number (optional)) – intensity value of background, by default 0.0

Returns:

dict with the stimulus (key: “img”), mask with integer index for each target (key: “target_mask”), and additional keys containing stimulus parameters

Return type:

dict[str, Any]

References

Mueller-Lyer, F. (1896).

Zur Lehre von den optischen Taeuschungen. Ueber Kontrast und Konfluxion. Zeitschrift fuer Psychologie und Physiologie der Sinnesorgane, IX, 1-16.

two_sided(visual_size=None, ppd=None, shape=None, outer_lines_length=None, outer_lines_angle=45, target_length=None, line_width=0, intensity_outer_lines=1.0, intensity_target=0.5, intensity_background=0.0)#

Mueller-Lyer’s (1896) illusion

Parameters:
  • visual_size (Sequence[Number, Number], Number, or None (default)) – visual size [height, width] of grating, in degrees

  • ppd (Sequence[Number, Number], Number, or None (default)) – pixels per degree [vertical, horizontal]

  • shape (Sequence[Number, Number], Number, or None (default)) – shape [height, width] of grating, in pixels

  • outer_lines_length (Number) – length of outer lines in degrees visual angle

  • outer_lines_angle (Number (optional)) – angle of outer lines in degrees, by default 45. Must be between -180 and 180 degrees.

  • target_length (Number) – length of target line in degrees visual angle

  • line_width (Number (optional)) – line width in degrees visual angle; if 0 (default), line width is 1 px

  • intensity_outer_lines (Number (optional)) – intensity value of outer lines, by default 0.01

  • intensity_target (Number (optional)) – intensity value of target line, by default 0.5

  • intensity_background (Number (optional)) – intensity value of background, by default 0.0

Returns:

dict with the stimulus (key: “img”), mask with integer index for each target (key: “target_mask”), and additional keys containing stimulus parameters

Return type:

dict[str, Any]

References

Mueller-Lyer, F. (1896).

Zur Lehre von den optischen Taeuschungen. Ueber Kontrast und Konfluxion. Zeitschrift fuer Psychologie und Physiologie der Sinnesorgane, IX, 1-16.