Progress Bar Component

(added in version 2023.2.0)

The Progress bar stimulus allows you to present a progress bar within your task.



Everything in a PsychoPy® experiment needs a unique name. The name should contain only letters, numbers and underscores (no punctuation marks or spaces).

start :

The time that the stimulus should first appear. See Defining the onset/duration of components for details.

stop :

Governs the duration for which the stimulus is presented. See Defining the onset/duration of components for details.

progressint | float

from 0.0 = not filled to 1.0 = fully filled


How should the stimulus look? Colour, borders, etc.

bar colorcolor

See Color spaces

back colorcolor

See Color spaces

border colorcolor

See Color spaces

color spacergb, dkl, lms, hsv

See Color spaces

opacity :

Vary the transparency, from 0.0 = invisible to 1.0 = opaque

contrastint | float

Contrast of the stimulus

line widthint | float

How wide should the line be? Width is specified in chosen spatial units, see Units for the window and stimuli


How should the stimulus be laid out? Padding, margins, size, position, etc.


The position of the centre of the stimulus, in the units specified by the stimulus or window

size(width, height)

Size of the stimulus on screen

spatial unitsdeg, cm, pix, norm, or inherit from window

See Units for the window and stimuli


Which point of the stimulus should be anchored to its exact location.


The orientation of the entire patch (texture and mask) in degrees.

See also

API reference for Progress

Back to top