cube

cube#

cube stimulus example

You can find an interactive version of this example here

stimupy.stimuli.cubes.cube(visual_size=None, ppd=None, shape=None, n_cells=None, target_indices=(), cell_thickness=None, cell_spacing=None, intensity_background=0.0, intensity_cells=1.0, intensity_target=0.5)#

Cube illusion (Agostini & Galmonte, 2002)

Parameters:

  • visual_size (Sequence[Number, Number], Number, or None (default)) – visual size [height, width] of image, 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 image, in pixels

  • n_cells (int) – the number of square cells (not counting background) per dimension

  • target_indices (Sequence) – Target indices. Will be used on each side

  • cell_thickness (Number or None (default)) – thickness of each cell in degrees

  • cell_spacing (Sequence[Number, Number], Number or None (default)) – spacing between cells in degrees (height, width)

  • intensity_background (float) – intensity value for background

  • intensity_cells (float) – intensity value for grid cells

  • intensity_target (float) – intensity value for target

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

Agostini, T., and Galmonte, A. (2002).

Perceptual organization overcomes the effects of local surround in determining simultaneous lightness contrast. Psychol. Sci. 13, 89-93. https://doi.org/10.1111/1467-9280.00417

Domijan, D. (2015).

A neurocomputational account of the role of contour facilitation in brightness perception. Frontiers in Human Neuroscience, 9, 93. https://doi.org/10.3389/fnhum.2015.00093

Contents