expyriment.control.defaults

Default settings for the control package.

audiosystem_autostart : bool
    start the audiosystem when Expyriment is initialized
    
audiosystem_bit_depth : int
    the audio bit depth; negative values mean signed sample values
    
audiosystem_buffer_size: int
    the audio buffer size in samples
    
audiosystem_channels : int
    the number of audio channels
    
audiosystem_sample_rate : int
    the audio sample rate
    
auto_create_subject_id : bool
    create a subject id automatically when starting an experiment
    
event_logging : int or bool
    O/False = no event logging
    1       = normal event logging (logging of all input & output events)
    2       = intensive logging; logs much more; use only for debugging
              purposes
    
    NOTES
    =====
    In most cases, it should be avoided to switch of logging (loglevel=0).
    If log files become to big due to certain repetitive events, it is
    suggested to switch of the logging of individual stimuli or IO event
    (see the method .set_logging() of this object).
    The logging of all events can also be changed via
    expyriment.design.Experiment().set_logging.
    
fast_quit : bool
    quit immediately without showing a goodbye message
    
goodbye_delay : int
    duration (in milliseconds) to show the goodbye text
    
goodbye_text : str
    the text to be shown when ending an experiment
    
initialize_delay : int
    a delay (in seconds) to wait before running an experiment to give
    Python time to start properly
    
    NOTES
    =====
    Python needs about 10 seconds to start up properly. Before that,
    timing accuracy can be worse.
    
open_gl : int or bool
    0/False = no OpenGL (no vsync / no blocking)
    1       = OpenGL (vsync / no blocking)
    2       = OpenGL (vsync / blocking)
    3       = OpenGL (vsync / alternative blocking)
    
    NOTES
    =====
    no OpenGL (no vsync / no blocking)
    ----------------------------------
    * Short preloading times
        Pygame is used to write directly to the display
    * Unsynchronized display updating
        Pixels are starting to change at wherever the vertical retrace is
        at the moment of presentation
    
    This mode can be useful for dynamic displays, where an accurate
    stimulus timing is not required, but rather very fast display changes
    have high priority and stimuli have to be created and on the fly (e.g.
    questionnairs, video game-like scenarios).
    
    OpenGL (vsync / no blocking)
    ----------------------------
    * Longer preloading times
        OpenGL is used to write to the display and a conversion to an
        OpenGL texture is needed
    * Synchronized display updating
        Pixels are starting to change always when the vertical retrace is
        at the left top corner
    * Innaccurate presentation time reporting
        Exact time of pixels changing on screen is not known
        
    This mode can be useful for dynamic displays, where an accurate
    stimulus timing is not required, but rather fast and fluid (e.g.
    non-tearing) display changes have high priority and preloaded stimuli
    can be used (e.g. well-controlled motion stimuli).

    OpenGL (vsync / blocking)
    -------------------------
    * Longer preloading times
        OpenGL is used to write to the display and a conversion to an
        OpenGL texture is needed
    * Synchronized display updating
        Pixels are starting to change always when the vertical retrace is
        at the left top corner
    * Accurate presentation time reporting
        present() method will only return when all drawing has been
        finished

    This can be useful for static stimulus presentation, where getting an
    accurate  presentation time report is of highest priority. Since this
    will be the case for most psychological and neuroscientific settings,
    it is the default mode used by Expyriment.

    OpenGL (vsync / alternative blocking)
    -------------------------------------
    * Longer preloading times
        OpenGL is used to write to the display and a conversion to an
        OpenGL texture is needed
    * Synchronized display updating
        Pixels are starting to change always when the vertical retrace is
        at the left top corner
    * Accurate presentation time reporting (alternative method)
        present() method will only return when all drawing has been
        finished and the then empty back buffer is available for drawing
        on it again

    This can be useful for static stimulus presentation, where getting an
    accurate presentation time report is of highest priority and the
    former mode does not work correctly (due to different video card
    driver implementations).
    
pause_key : int
    the key to be used for pausing an experiment
    
quit_key : int
    the key to be used for ending an experiment
    
refresh_key : int
    the key to be used for refreshing the screen
    
stdout_logging: bool
    log errors and warnings which go to the standard output (terminal
    window)
    
window_mode : bool
    run experiment in window instead of fullscreen
    
window_size : (int, int)
    the size of the window when running in window mode

Attributes

expyriment.control.defaults.audiosystem_autostart

default value: True

expyriment.control.defaults.audiosystem_bit_depth

default value: -16

expyriment.control.defaults.audiosystem_buffer_size

default value: 2048

expyriment.control.defaults.audiosystem_channels

default value: 2

expyriment.control.defaults.audiosystem_sample_rate

default value: 44100

expyriment.control.defaults.auto_create_subject_id

default value: False

expyriment.control.defaults.event_logging

default value: 1

expyriment.control.defaults.fast_quit

default value: False

expyriment.control.defaults.goodbye_delay

default value: 3000

expyriment.control.defaults.goodbye_text

default value: ‘Ending experiment...’

expyriment.control.defaults.initialize_delay

default value: 10

expyriment.control.defaults.open_gl

default value: 2

expyriment.control.defaults.pause_key

default value: None

expyriment.control.defaults.quit_key

default value: 27

expyriment.control.defaults.refresh_key

default value: None

expyriment.control.defaults.stdout_logging

default value: True

expyriment.control.defaults.window_mode

default value: False

expyriment.control.defaults.window_size

default value: (800, 600)