stimupy.stimuli.todorovics#

Demos#

Functions#

rectangle_generalized

Rectangular target and rectangular covers added with flexible number of covers and flexible target and cover placement

rectangle

Rectangular target in the center and four rectangular covers added symmetrically around target center

rectangle_two_sided

Rectangular target in the center and four rectangular covers added symmetrically around target center

cross_generalized

Cross target and rectangular covers added with flexible number of covers and flexible cover placement

cross

Cross target and four rectangular covers added at inner cross corners

cross_two_sided

Cross target and four rectangular covers added at inner cross corners

equal

Cross target and four rectangular covers added at inner cross corners

equal_two_sided

Cross target and four rectangular covers added at inner cross corners
rectangle_generalized(visual_size=None, ppd=None, shape=None, target_size=None, target_position=None, covers_size=None, covers_x=None, covers_y=None, intensity_background=0.0, intensity_target=0.5, intensity_covers=1.0)[source]#

Rectangular target and rectangular covers added with flexible number of covers and flexible target and cover placement

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

  • target_size (float or (float, float)) – size of the target in degrees of visual angle (height, width)

  • target_position (float or (float, float)) – coordinates where to place the target

  • covers_size (float or (float, float)) – size of the covers in degrees of visual angle (height, width)

  • covers_x (tuple of floats) – x coordinates of covers; as many covers as there are coordinates

  • covers_y (tuple of floats) – y coordinates of covers; as many covers as there are coordinates

  • intensity_background (float) – intensity value for background

  • intensity_target (float) – intensity value for target

  • intensity_covers (Sequence[Number, ...] or Number) – intensity value for covers

Returns:

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

Return type:

dict[str, Any]

References

Blakeslee, B., & McCourt, M. E. (1999).

A multiscale spatial filtering account of the White effect, simultaneous brightness contrast and grating induction. Vision Research, 39, 4361-4377.

Pessoa, L., Baratoff, G., Neumann, H., & Todorovic, D. (1998).

Lightness and junctions: variations on White’s display. Investigative Ophthalmology and Visual Science (Supplement), 39, S159.

Todorovic, D. (1997).

Lightness and junctions. Perception, 26, 379-395.

rectangle(visual_size=None, ppd=None, shape=None, target_size=None, target_position=None, covers_size=None, covers_offset=None, intensity_background=0.0, intensity_target=0.5, intensity_covers=1.0)[source]#

Rectangular target in the center and four rectangular covers added symmetrically around target center

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

  • target_size (float or (float, float)) – size of the target in degrees of visual angle (height, width)

  • target_position (float or (float, float)) – coordinates where to place the target

  • covers_size (float or (float, float)) – size of covers in degrees of visual angle (height, width)

  • covers_offset (float or (float, float)) – distance from cover center to target center in (y, x)

  • intensity_background (float) – intensity value for background

  • intensity_target (float) – intensity value for target

  • intensity_covers (Sequence[Number, ...] or Number) – intensity value for covers

Returns:

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

Return type:

dict[str, Any]

References

Blakeslee, B., & McCourt, M. E. (1999).

A multiscale spatial filtering account of the White effect, simultaneous brightness contrast and grating induction. Vision Research, 39, 4361-4377.

Pessoa, L., Baratoff, G., Neumann, H., & Todorovic, D. (1998).

Lightness and junctions: variations on White’s display. Investigative Ophthalmology and Visual Science (Supplement), 39, S159.

Todorovic, D. (1997).

Lightness and junctions. Perception, 26, 379-395.

rectangle_two_sided(visual_size=None, ppd=None, shape=None, target_size=None, target_position=None, covers_size=None, covers_offset=None, intensity_background=0.0, intensity_target=0.5, intensity_covers=1.0)#

Rectangular target in the center and four rectangular covers added symmetrically around target center

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

  • target_size (float or (float, float)) – size of the target in degrees of visual angle (height, width)

  • target_position (float or (float, float)) – coordinates where to place the target

  • covers_size (float or (float, float)) – size of covers in degrees of visual angle (height, width)

  • covers_offset (float or (float, float)) – distance from cover center to target center in (y, x)

  • intensity_background (float) – intensity value for background

  • intensity_target (float) – intensity value for target

  • intensity_covers (Sequence[Number, ...] or Number) – intensity value for covers

Returns:

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

Return type:

dict[str, Any]

References

Blakeslee, B., & McCourt, M. E. (1999).

A multiscale spatial filtering account of the White effect, simultaneous brightness contrast and grating induction. Vision Research, 39, 4361-4377.

Pessoa, L., Baratoff, G., Neumann, H., & Todorovic, D. (1998).

Lightness and junctions: variations on White’s display. Investigative Ophthalmology and Visual Science (Supplement), 39, S159.

Todorovic, D. (1997).

Lightness and junctions. Perception, 26, 379-395.

cross_generalized(visual_size=None, ppd=None, shape=None, cross_size=None, cross_thickness=None, covers_size=None, covers_x=None, covers_y=None, intensity_background=0.0, intensity_target=0.5, intensity_covers=1.0)[source]#

Cross target and rectangular covers added with flexible number of covers and flexible cover placement

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

  • cross_size (float or (float, float)) – size of target cross in visual angle

  • cross_thickness (float) – thickness of target cross in visual angle

  • covers_size (float or (float, float)) – size of covers in degrees visual angle (height, width)

  • covers_x (tuple of floats) – x coordinates of covers; as many covers as there are coordinates

  • covers_y (tuple of floats) – y coordinates of covers; as many covers as there are coordinates

  • intensity_background (float) – intensity value for background

  • intensity_target (float) – intensity value for target

  • intensity_covers (Sequence[Number, ...] or Number) – intensity value for covers

Returns:

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

Return type:

dict[str, Any]

References

Blakeslee, B., & McCourt, M. E. (1999).

A multiscale spatial filtering account of the White effect, simultaneous brightness contrast and grating induction. Vision Research, 39, 4361-4377.

Pessoa, L., Baratoff, G., Neumann, H., & Todorovic, D. (1998).

Lightness and junctions: variations on White’s display. Investigative Ophthalmology and Visual Science (Supplement), 39, S159.

Todorovic, D. (1997).

Lightness and junctions. Perception, 26, 379-395.

cross(visual_size=None, ppd=None, shape=None, cross_size=None, cross_thickness=None, covers_size=None, intensity_background=0.0, intensity_target=0.5, intensity_covers=1.0)[source]#

Cross target and four rectangular covers added at inner cross corners

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

  • cross_size (float or (float, float)) – size of target cross in visual angle

  • cross_thickness (float) – thickness of target cross in visual angle

  • covers_size (float or (float, float)) – size of covers in degrees of visual angle (height, width)

  • intensity_background (float) – intensity value for background

  • intensity_target (float) – intensity value for target

  • intensity_covers (Sequence[Number, ...] or Number) – intensity value for covers

Returns:

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

Return type:

dict[str, Any]

References

Blakeslee, B., & McCourt, M. E. (1999).

A multiscale spatial filtering account of the White effect, simultaneous brightness contrast and grating induction. Vision Research, 39, 4361-4377.

Pessoa, L., Baratoff, G., Neumann, H., & Todorovic, D. (1998).

Lightness and junctions: variations on White’s display. Investigative Ophthalmology and Visual Science (Supplement), 39, S159.

Todorovic, D. (1997).

Lightness and junctions. Perception, 26, 379-395.

cross_two_sided(visual_size=None, ppd=None, shape=None, cross_size=None, cross_thickness=None, covers_size=None, intensity_background=0.0, intensity_target=0.5, intensity_covers=1.0)#

Cross target and four rectangular covers added at inner cross corners

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

  • cross_size (float or (float, float)) – size of target cross in visual angle

  • cross_thickness (float) – thickness of target cross in visual angle

  • covers_size (float or (float, float)) – size of covers in degrees of visual angle (height, width)

  • intensity_background (float) – intensity value for background

  • intensity_target (float) – intensity value for target

  • intensity_covers (Sequence[Number, ...] or Number) – intensity value for covers

Returns:

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

Return type:

dict[str, Any]

References

Blakeslee, B., & McCourt, M. E. (1999).

A multiscale spatial filtering account of the White effect, simultaneous brightness contrast and grating induction. Vision Research, 39, 4361-4377.

Pessoa, L., Baratoff, G., Neumann, H., & Todorovic, D. (1998).

Lightness and junctions: variations on White’s display. Investigative Ophthalmology and Visual Science (Supplement), 39, S159.

Todorovic, D. (1997).

Lightness and junctions. Perception, 26, 379-395.

equal(visual_size=None, ppd=None, shape=None, cross_size=None, cross_thickness=None, intensity_background=0.0, intensity_target=0.5, intensity_covers=1.0)[source]#

Cross target and four rectangular covers added at inner cross corners

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

  • cross_size (float or (float, float)) – size of target cross in visual angle

  • cross_thickness (float) – thickness of target cross in visual angle

  • intensity_background (float) – intensity value for background

  • intensity_target (float) – intensity value for target

  • intensity_covers (float) – intensity value for covers

Returns:

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

Return type:

dict[str, Any]

References

Blakeslee, B., & McCourt, M. E. (1999).

A multiscale spatial filtering account of the White effect, simultaneous brightness contrast and grating induction. Vision Research, 39, 4361-4377.

Pessoa, L., Baratoff, G., Neumann, H., & Todorovic, D. (1998).

Lightness and junctions: variations on White’s display. Investigative Ophthalmology and Visual Science (Supplement), 39, S159.

Todorovic, D. (1997).

Lightness and junctions. Perception, 26, 379-395.

equal_two_sided(visual_size=None, ppd=None, shape=None, cross_size=None, cross_thickness=None, intensity_background=0.0, intensity_target=0.5, intensity_covers=1.0)#

Cross target and four rectangular covers added at inner cross corners

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

  • cross_size (float or (float, float)) – size of target cross in visual angle

  • cross_thickness (float) – thickness of target cross in visual angle

  • intensity_background (float) – intensity value for background

  • intensity_target (float) – intensity value for target

  • intensity_covers (float) – intensity value for covers

Returns:

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

Return type:

dict[str, Any]

References

Blakeslee, B., & McCourt, M. E. (1999).

A multiscale spatial filtering account of the White effect, simultaneous brightness contrast and grating induction. Vision Research, 39, 4361-4377.

Pessoa, L., Baratoff, G., Neumann, H., & Todorovic, D. (1998).

Lightness and junctions: variations on White’s display. Investigative Ophthalmology and Visual Science (Supplement), 39, S159.

Todorovic, D. (1997).

Lightness and junctions. Perception, 26, 379-395.