stimupy.stimuli.ponzos#

Demos#

Functions#

ponzo

Ponzo's (1910) illusion

ponzo(visual_size=None, ppd=None, shape=None, outer_lines_length=None, outer_lines_width=0, outer_lines_angle=15, target_lines_length=None, target_lines_width=0, target_distance=None, intensity_outer_lines=1.0, intensity_target_lines=0.5, intensity_background=0.0)[source]#

Ponzo’s (1910) 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_width (Number) – line width of outer lines in degrees visual angle if 0 (default), set line width to 1 px

  • outer_lines_angle (Number) – angle of outer lines in degrees. Must be between -45 and 45 degrees.

  • target_lines_length (Number) – length of target lines in degrees visual angle

  • target_lines_width – line width of target lines in degrees visual angle if 0 (default), set line width to 1 px

  • target_distance (Number) – distance between target lines in degrees visual angle

  • intensity_outer_lines (Number or (Number, Number)) – intensity value(s) of outer lines

  • intensity_target_lines (Number or (Number, Number)) – intensity value(s) of target lines

  • intensity_background (Number) – intensity value of background

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

Ponzo, M. (1910).

Intorno ad alcune illusioni nel campo delle sensazioni tattili, sull’illusione di Aristotele e fenomeni analoghi. Wilhelm Engelmann.