Visual

The psychos.visual module provides tools to easily create, display, and control visual stimuli, supporting precise control over timing, appearance, and spatial configuration for behavioral experiments.

Window

A Pyglet-based window class used to display, contain, and refresh visual stimuli during experiments.

psychos.visual.Window([width, height, ...])	Custom window for displaying visual elements.
psychos.visual.get_window()	Retrieve the current default window.

Visual Stimuli

Basic building blocks with predefined and parametrizable visual stimuli to easily create behavioral experiments.

psychos.visual.Text([text, position, width, ...])	A class to represent text in a Pyglet window using a Label component.
psychos.visual.Image(image_path[, position, ...])	A class to display an image in a Pyglet window using the Sprite component.
psychos.visual.Rectangle([position, width, ...])
psychos.visual.BorderedRectangle([position, ...])
psychos.visual.Gabor([size, ...])	A Gabor stimulus for psychophysical experiments.
psychos.visual.RawImage(raw_image[, ...])	A class to display an image in a Pyglet window using the Sprite component.
psychos.visual.Circle([position, radius, ...])	A circle shape that can be drawn on the screen.
psychos.visual.Slider([initial_value, ...])	Interactive slider widget for Pyglet windows.

Units system

Different unit systems to configure the sizes and positions of visual stimuli within the window (e.g., pixels, centimeters, visual degrees, screen percentage, etc.). Most units are transparently integrated into windows and stimuli, but direct access to these classes is provided for custom cases or defining new unit types.

psychos.visual.Unit(window)	Abstract base class for different unit systems that transform normalized or other unit types into pixel values.
psychos.visual.units.PixelUnits(window)	Pixel unit system.
psychos.visual.units.NormalizedUnits(window)	A unit system that normalizes coordinates and sizes with respect to the window dimensions.
psychos.visual.units.PercentageUnit(window)	Percentage unit system.
psychos.visual.units.VWUnit(window)	VW (viewport width) unit system.
psychos.visual.units.VHUnit(window)	VH (viewport height) unit system.
psychos.visual.units.CMUnit(window)	Centimeter (cm) unit system.
psychos.visual.units.VDUnit(window)	Viewport Diagonal (vd) unit system.
psychos.visual.units.MMUnit(window)	Millimeter (mm) unit system.
psychos.visual.units.PTUnit(window)	Points (pt) unit system.
psychos.visual.units.DegUnit(window)	Degrees of visual angle (deg) unit system.
psychos.visual.units.INUnit(window)	Inches (in) unit system.

Synthetic Stimuli

Utility functions for creating synthetic stimuli, such as Gabor patches or scaled textures, useful for generating precise visual stimuli programmatically.

psychos.visual.synthetic.gabor_2d([size, ...])	Generate a 2D Gabor patch as a numpy array (grayscale), with an optional Gaussian envelope.
psychos.visual.synthetic.gabor_3d([size, ...])	Generate a 3D (color) Gabor patch as a numpy array by mapping a grayscale 2D Gabor (computed via gabor_2d) into RGB values using a colormap.
psychos.visual.synthetic.reescale(arr[, ...])	Rescale a numpy array based on the specified method.