psychopy 2024.2.4__py3-none-any.whl → 2025.1.0__py3-none-any.whl

psychopy/core.py.orig

@@ -1,169 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-"""Basic functions, including timing, rush (imported), quit
-"""
-# Part of the PsychoPy library
-# Copyright (C) 2002-2018 Jonathan Peirce (C) 2019-2021 Open Science Tools Ltd.
-# Distributed under the terms of the GNU General Public License (GPL).
-
-import sys
-import threading
-import subprocess
-import shlex
-import locale
-
-# some things are imported just to be accessible within core's namespace
-from psychopy.clock import (MonotonicClock, Clock, CountdownTimer,
-                            wait, monotonicClock, getAbsTime,
-                            StaticPeriod)  # pylint: disable=W0611
-
-# always safe to call rush, even if its not going to do anything for a
-# particular OS
-from psychopy.platform_specific import rush  # pylint: disable=W0611
-from psychopy import logging
-<<<<<<< HEAD
-from psychopy.constants import STARTED, NOT_STARTED, FINISHED
-=======
-from psychopy.constants import STARTED, NOT_STARTED, FINISHED, PY3
-from psychopy.iohub.client import ioHubConnection
->>>>>>> c06fff3cf5e2f418f6db297fd47819041a00c07d
-
-try:
-    import pyglet
-    havePyglet = True
-    # may not want to check, to preserve terminal window focus
-    checkPygletDuringWait = True
-except ImportError:
-    havePyglet = False
-    checkPygletDuringWait = False
-
-try:
-    import glfw
-    haveGLFW = True
-except ImportError:
-    haveGLFW = False
-
-runningThreads = []  # just for backwards compatibility?
-openWindows = []  # visual.Window updates this, event.py and clock.py use it
-
-# Set getTime in core to == the monotonicClock instance created in the
-# clockModule.
-# The logging module sets the defaultClock to == clock.monotonicClock,
-# so by default the core.getTime() and logging.defaultClock.getTime()
-# functions return the 'same' timebase.
-#
-# This way 'all' OSs have a core.getTime() timebase that starts at 0.0 when
-# the experiment is launched, instead of it being this way on Windows only
-# (which was also a descripancy between OS's when win32 was using time.clock).
-
-
-def getTime(applyZero = True):
-    """Get the current time since psychopy.core was loaded.
-
-
-
-    Version Notes: Note that prior to PsychoPy 1.77.00 the behaviour of
-    getTime() was platform dependent (on OSX and linux it was equivalent to
-    :func:`psychopy.core.getAbsTime`
-    whereas on windows it returned time since loading of the module, as now)
-    """
-    return monotonicClock.getTime(applyZero)
-
-
-def quit():
-    """Close everything and exit nicely (ending the experiment)
-    """
-    # pygame.quit()  # safe even if pygame was never initialised
-    logging.flush()
-
-    # properly shutdown ioHub server
-    if ioHubConnection.ACTIVE_CONNECTION:
-        ioHubConnection.ACTIVE_CONNECTION.quit()
-
-    for thisThread in threading.enumerate():
-        if hasattr(thisThread, 'stop') and hasattr(thisThread, 'running'):
-            # this is one of our event threads - kill it and wait for success
-            thisThread.stop()
-            while thisThread.running == 0:
-                pass  # wait until it has properly finished polling
-
-    sys.exit(0)  # quits the python session entirely
-
-
-def shellCall(shellCmd, stdin='', stderr=False, env=None, encoding=None):
-    """Call a single system command with arguments, return its stdout.
-    Returns stdout, stderr if stderr is True.
-    Handles simple pipes, passing stdin to shellCmd (pipes are untested
-    on windows) can accept string or list as the first argument
-
-    Parameters
-    ----------
-    shellCmd : str, or iterable
-        The command to execute, and its respective arguments.
-
-    stdin : str, or None
-        Input to pass to the command.
-
-    stderr : bool
-        Whether to return the standard error output once execution is finished.
-
-    env : dict
-        The environment variables to set during execution.
-
-    encoding : str
-        The encoding to use for communication with the executed command.
-        This argument will be ignored on Python 2.7.
-
-    Notes
-    -----
-    We use ``subprocess.Popen`` to execute the command and establish
-    `stdin` and `stdout` pipes.
-    Python 2.7 always opens the pipes in text mode; however,
-    Python 3 defaults to binary mode, unless an encoding is specified.
-    To unify pipe communication across Python 2 and 3, we now provide an
-    `encoding` parameter, enforcing `utf-8` text mode by default.
-    This parameter is present from Python 3.6 onwards; using an older
-    Python 3 version will raise an exception. The parameter will be ignored
-    when running Python 2.7.
-
-    """
-    if encoding is None:
-        encoding = locale.getpreferredencoding()
-
-    if type(shellCmd) == str:
-        # safely split into cmd+list-of-args, no pipes here
-        shellCmdList = shlex.split(shellCmd)
-    elif type(shellCmd) == bytes:
-        # safely split into cmd+list-of-args, no pipes here
-        shellCmdList = shlex.split(shellCmd.decode('utf-8'))
-    elif type(shellCmd) in (list, tuple):  # handles whitespace in filenames
-        shellCmdList = shellCmd
-    else:
-        msg = 'shellCmd requires a string or iterable.'
-        raise TypeError(msg)
-
-    cmdObjects = []
-    for obj in shellCmdList:
-        if type(obj) != bytes:
-            cmdObjects.append(obj)
-        else:
-            cmdObjects.append(obj.decode('utf-8'))
-
-    # the `encoding` parameter results in unicode coming back
-    if sys.version_info.minor >= 6:
-        proc = subprocess.Popen(cmdObjects, stdin=subprocess.PIPE,
-                                stdout=subprocess.PIPE,
-                                stderr=subprocess.PIPE,
-                                encoding=encoding, env=env)
-    else:
-        msg = 'shellCall() requires Python 2.7, or 3.6 and newer.'
-        raise RuntimeError(msg)
-
-    stdoutData, stderrData = proc.communicate(stdin)
-
-    del proc
-    if stderr:
-        return stdoutData.strip(), stderrData.strip()
-    else:
-        return stdoutData.strip()

psychopy/demos/builder/Design Templates/randomisedBlocks/html/index.html

@@ -1,23 +0,0 @@
-<!doctype html>
-<html>
-  <head>
-    <meta charset="utf-8">
-    <meta name="viewport" content="user-scalable=no">
-    <title>randomisedBlocks [PsychoPy]</title>
-    <!-- styles -->
-    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/jquery-ui-dist@1.12.1/jquery-ui.min.css">
-    <link rel="stylesheet" href="./lib/psychojs-2022.2.0.css">
-  </head>
-  <body>
-    <div id="root"></div>
-    <!-- external libraries -->
-    <script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script>
-    <script src="https://cdn.jsdelivr.net/npm/jquery-ui-dist@1.12.1/jquery-ui.min.js"></script>
-    <script src="https://cdn.jsdelivr.net/npm/preloadjs@1.0.1/lib/preloadjs.min.js"></script>
-    <!-- experiment -->
-    <script src="./randomisedBlocks.js" type="module"></script>
-    <!-- legacy browsers -->
-    <script src="./lib/psychojs-2022.2.0.iife.js" nomodule></script>
-    <script src="./randomisedBlocks-legacy-browsers.js" nomodule></script>
-  </body>
-</html>

psychopy/demos/builder/Design Templates/randomisedBlocks/html/randomisedBlocks-legacy-browsers.js

@@ -1,423 +0,0 @@
-/************************* 
- * Randomisedblocks Test *
- *************************/
-
-
-// store info about the experiment session:
-let expName = 'randomisedBlocks';  // from the Builder filename that created this script
-let expInfo = {'session': '001', 'participant': `subj${(Math.random() * 100000)}`};
-
-// Start code blocks for 'Before Experiment'
-// init psychoJS:
-const psychoJS = new PsychoJS({
-  debug: true
-});
-
-// open window:
-psychoJS.openWindow({
-  fullscr: true,
-  color: new util.Color([0, 0, 0]),
-  units: 'height',
-  waitBlanking: true
-});
-// schedule the experiment:
-psychoJS.schedule(psychoJS.gui.DlgFromDict({
-  dictionary: expInfo,
-  title: expName
-}));
-
-const flowScheduler = new Scheduler(psychoJS);
-const dialogCancelScheduler = new Scheduler(psychoJS);
-psychoJS.scheduleCondition(function() { return (psychoJS.gui.dialogComponent.button === 'OK'); }, flowScheduler, dialogCancelScheduler);
-
-// flowScheduler gets run if the participants presses OK
-flowScheduler.add(updateInfo); // add timeStamp
-flowScheduler.add(experimentInit);
-const blocksLoopScheduler = new Scheduler(psychoJS);
-flowScheduler.add(blocksLoopBegin(blocksLoopScheduler));
-flowScheduler.add(blocksLoopScheduler);
-flowScheduler.add(blocksLoopEnd);
-flowScheduler.add(quitPsychoJS, '', true);
-
-// quit if user presses Cancel in dialog box:
-dialogCancelScheduler.add(quitPsychoJS, '', false);
-
-psychoJS.start({
-  expName: expName,
-  expInfo: expInfo,
-  });
-
-psychoJS.experimentLogger.setLevel(core.Logger.ServerLevel.EXP);
-
-
-var frameDur;
-async function updateInfo() {
-  expInfo['date'] = util.MonotonicClock.getDateStr();  // add a simple timestamp
-  expInfo['expName'] = expName;
-  expInfo['psychopyVersion'] = '2022.2.0dev3';
-  expInfo['OS'] = window.navigator.platform;
-
-  psychoJS.experiment.dataFileName = (("." + "/") + `data/${expInfo["participant"]}_${expName}_${expInfo["date"]}`);
-
-  // store frame rate of monitor if we can measure it successfully
-  expInfo['frameRate'] = psychoJS.window.getActualFrameRate();
-  if (typeof expInfo['frameRate'] !== 'undefined')
-    frameDur = 1.0 / Math.round(expInfo['frameRate']);
-  else
-    frameDur = 1.0 / 60.0; // couldn't get a reliable measure so guess
-
-  // add info from the URL:
-  util.addInfoFromUrl(expInfo);
-  
-  return Scheduler.Event.NEXT;
-}
-
-
-var readyMessageClock;
-var textbox;
-var trialClock;
-var image;
-var globalClock;
-var routineTimer;
-async function experimentInit() {
-  // Initialize components for Routine "readyMessage"
-  readyMessageClock = new util.Clock();
-  textbox = new visual.TextBox({
-    win: psychoJS.window,
-    name: 'textbox',
-    text: '',
-    font: 'Open Sans',
-    pos: [0, 0], letterHeight: 0.05,
-    size: [0.4, 0.4],  units: undefined, 
-    color: 'white', colorSpace: 'rgb',
-    fillColor: undefined, borderColor: undefined,
-    bold: false, italic: false,
-    opacity: 1.0,
-    padding: undefined,
-    editable: false,
-    multiline: true,
-    anchor: 'center',
-    depth: 0.0 
-  });
-  
-  // Initialize components for Routine "trial"
-  trialClock = new util.Clock();
-  image = new visual.ImageStim({
-    win : psychoJS.window,
-    name : 'image', units : 'height', 
-    image : undefined, mask : undefined,
-    ori : 0, pos : [0, 0], size : [0.5, 0.5],
-    color : new util.Color([1, 1, 1]), opacity : 1,
-    flipHoriz : false, flipVert : false,
-    texRes : 128, interpolate : true, depth : 0.0 
-  });
-  // Create some handy timers
-  globalClock = new util.Clock();  // to track the time since experiment started
-  routineTimer = new util.CountdownTimer();  // to track time remaining of each (non-slip) routine
-  
-  return Scheduler.Event.NEXT;
-}
-
-
-var blocks;
-var currentLoop;
-function blocksLoopBegin(blocksLoopScheduler, snapshot) {
-  return async function() {
-    TrialHandler.fromSnapshot(snapshot); // update internal variables (.thisN etc) of the loop
-    
-    // set up handler to look after randomisation of conditions etc
-    blocks = new TrialHandler({
-      psychoJS: psychoJS,
-      nReps: 2, method: TrialHandler.Method.RANDOM,
-      extraInfo: expInfo, originPath: undefined,
-      trialList: 'chooseBlock.xlsx',
-      seed: undefined, name: 'blocks'
-    });
-    psychoJS.experiment.addLoop(blocks); // add the loop to the experiment
-    currentLoop = blocks;  // we're now the current loop
-    
-    // Schedule all the trials in the trialList:
-    blocks.forEach(function() {
-      const snapshot = blocks.getSnapshot();
-    
-      blocksLoopScheduler.add(importConditions(snapshot));
-      blocksLoopScheduler.add(readyMessageRoutineBegin(snapshot));
-      blocksLoopScheduler.add(readyMessageRoutineEachFrame());
-      blocksLoopScheduler.add(readyMessageRoutineEnd());
-      const trialsLoopScheduler = new Scheduler(psychoJS);
-      blocksLoopScheduler.add(trialsLoopBegin(trialsLoopScheduler, snapshot));
-      blocksLoopScheduler.add(trialsLoopScheduler);
-      blocksLoopScheduler.add(trialsLoopEnd);
-      blocksLoopScheduler.add(endLoopIteration(blocksLoopScheduler, snapshot));
-    });
-    
-    return Scheduler.Event.NEXT;
-  }
-}
-
-
-var trials;
-function trialsLoopBegin(trialsLoopScheduler, snapshot) {
-  return async function() {
-    TrialHandler.fromSnapshot(snapshot); // update internal variables (.thisN etc) of the loop
-    
-    // set up handler to look after randomisation of conditions etc
-    trials = new TrialHandler({
-      psychoJS: psychoJS,
-      nReps: 1, method: TrialHandler.Method.RANDOM,
-      extraInfo: expInfo, originPath: undefined,
-      trialList: condsFile,
-      seed: undefined, name: 'trials'
-    });
-    psychoJS.experiment.addLoop(trials); // add the loop to the experiment
-    currentLoop = trials;  // we're now the current loop
-    
-    // Schedule all the trials in the trialList:
-    trials.forEach(function() {
-      const snapshot = trials.getSnapshot();
-    
-      trialsLoopScheduler.add(importConditions(snapshot));
-      trialsLoopScheduler.add(trialRoutineBegin(snapshot));
-      trialsLoopScheduler.add(trialRoutineEachFrame());
-      trialsLoopScheduler.add(trialRoutineEnd());
-      trialsLoopScheduler.add(endLoopIteration(trialsLoopScheduler, snapshot));
-    });
-    
-    return Scheduler.Event.NEXT;
-  }
-}
-
-
-async function trialsLoopEnd() {
-  psychoJS.experiment.removeLoop(trials);
-
-  return Scheduler.Event.NEXT;
-}
-
-
-async function blocksLoopEnd() {
-  psychoJS.experiment.removeLoop(blocks);
-
-  return Scheduler.Event.NEXT;
-}
-
-
-var t;
-var frameN;
-var continueRoutine;
-var readyMessageComponents;
-function readyMessageRoutineBegin(snapshot) {
-  return async function () {
-    TrialHandler.fromSnapshot(snapshot); // ensure that .thisN vals are up to date
-    
-    //--- Prepare to start Routine 'readyMessage' ---
-    t = 0;
-    readyMessageClock.reset(); // clock
-    frameN = -1;
-    continueRoutine = true; // until we're told otherwise
-    routineTimer.add(1.000000);
-    // update component parameters for each repeat
-    textbox.setText(readyMsg);
-    // keep track of which components have finished
-    readyMessageComponents = [];
-    readyMessageComponents.push(textbox);
-    
-    readyMessageComponents.forEach( function(thisComponent) {
-      if ('status' in thisComponent)
-        thisComponent.status = PsychoJS.Status.NOT_STARTED;
-       });
-    return Scheduler.Event.NEXT;
-  }
-}
-
-
-var frameRemains;
-function readyMessageRoutineEachFrame() {
-  return async function () {
-    //--- Loop for each frame of Routine 'readyMessage' ---
-    // get current time
-    t = readyMessageClock.getTime();
-    frameN = frameN + 1;// number of completed frames (so 0 is the first frame)
-    // update/draw components on each frame
-    
-    // *textbox* updates
-    if (t >= 0.0 && textbox.status === PsychoJS.Status.NOT_STARTED) {
-      // keep track of start time/frame for later
-      textbox.tStart = t;  // (not accounting for frame time here)
-      textbox.frameNStart = frameN;  // exact frame index
-      
-      textbox.setAutoDraw(true);
-    }
-
-    frameRemains = 0.0 + 1.0 - psychoJS.window.monitorFramePeriod * 0.75;  // most of one frame period left
-    if (textbox.status === PsychoJS.Status.STARTED && t >= frameRemains) {
-      textbox.setAutoDraw(false);
-    }
-    // check for quit (typically the Esc key)
-    if (psychoJS.experiment.experimentEnded || psychoJS.eventManager.getKeys({keyList:['escape']}).length > 0) {
-      return quitPsychoJS('The [Escape] key was pressed. Goodbye!', false);
-    }
-    
-    // check if the Routine should terminate
-    if (!continueRoutine) {  // a component has requested a forced-end of Routine
-      return Scheduler.Event.NEXT;
-    }
-    
-    continueRoutine = false;  // reverts to True if at least one component still running
-    readyMessageComponents.forEach( function(thisComponent) {
-      if ('status' in thisComponent && thisComponent.status !== PsychoJS.Status.FINISHED) {
-        continueRoutine = true;
-      }
-    });
-    
-    // refresh the screen if continuing
-    if (continueRoutine && routineTimer.getTime() > 0) {
-      return Scheduler.Event.FLIP_REPEAT;
-    } else {
-      return Scheduler.Event.NEXT;
-    }
-  };
-}
-
-
-function readyMessageRoutineEnd() {
-  return async function () {
-    //--- Ending Routine 'readyMessage' ---
-    readyMessageComponents.forEach( function(thisComponent) {
-      if (typeof thisComponent.setAutoDraw === 'function') {
-        thisComponent.setAutoDraw(false);
-      }
-    });
-    return Scheduler.Event.NEXT;
-  };
-}
-
-
-var trialComponents;
-function trialRoutineBegin(snapshot) {
-  return async function () {
-    TrialHandler.fromSnapshot(snapshot); // ensure that .thisN vals are up to date
-    
-    //--- Prepare to start Routine 'trial' ---
-    t = 0;
-    trialClock.reset(); // clock
-    frameN = -1;
-    continueRoutine = true; // until we're told otherwise
-    routineTimer.add(1.500000);
-    // update component parameters for each repeat
-    image.setImage(stimFile);
-    // keep track of which components have finished
-    trialComponents = [];
-    trialComponents.push(image);
-    
-    trialComponents.forEach( function(thisComponent) {
-      if ('status' in thisComponent)
-        thisComponent.status = PsychoJS.Status.NOT_STARTED;
-       });
-    return Scheduler.Event.NEXT;
-  }
-}
-
-
-function trialRoutineEachFrame() {
-  return async function () {
-    //--- Loop for each frame of Routine 'trial' ---
-    // get current time
-    t = trialClock.getTime();
-    frameN = frameN + 1;// number of completed frames (so 0 is the first frame)
-    // update/draw components on each frame
-    
-    // *image* updates
-    if (t >= 0.5 && image.status === PsychoJS.Status.NOT_STARTED) {
-      // keep track of start time/frame for later
-      image.tStart = t;  // (not accounting for frame time here)
-      image.frameNStart = frameN;  // exact frame index
-      
-      image.setAutoDraw(true);
-    }
-
-    frameRemains = 0.5 + 1.0 - psychoJS.window.monitorFramePeriod * 0.75;  // most of one frame period left
-    if (image.status === PsychoJS.Status.STARTED && t >= frameRemains) {
-      image.setAutoDraw(false);
-    }
-    // check for quit (typically the Esc key)
-    if (psychoJS.experiment.experimentEnded || psychoJS.eventManager.getKeys({keyList:['escape']}).length > 0) {
-      return quitPsychoJS('The [Escape] key was pressed. Goodbye!', false);
-    }
-    
-    // check if the Routine should terminate
-    if (!continueRoutine) {  // a component has requested a forced-end of Routine
-      return Scheduler.Event.NEXT;
-    }
-    
-    continueRoutine = false;  // reverts to True if at least one component still running
-    trialComponents.forEach( function(thisComponent) {
-      if ('status' in thisComponent && thisComponent.status !== PsychoJS.Status.FINISHED) {
-        continueRoutine = true;
-      }
-    });
-    
-    // refresh the screen if continuing
-    if (continueRoutine && routineTimer.getTime() > 0) {
-      return Scheduler.Event.FLIP_REPEAT;
-    } else {
-      return Scheduler.Event.NEXT;
-    }
-  };
-}
-
-
-function trialRoutineEnd() {
-  return async function () {
-    //--- Ending Routine 'trial' ---
-    trialComponents.forEach( function(thisComponent) {
-      if (typeof thisComponent.setAutoDraw === 'function') {
-        thisComponent.setAutoDraw(false);
-      }
-    });
-    return Scheduler.Event.NEXT;
-  };
-}
-
-
-function endLoopIteration(scheduler, snapshot) {
-  // ------Prepare for next entry------
-  return async function () {
-    if (typeof snapshot !== 'undefined') {
-      // ------Check if user ended loop early------
-      if (snapshot.finished) {
-        // Check for and save orphaned data
-        if (psychoJS.experiment.isEntryEmpty()) {
-          psychoJS.experiment.nextEntry(snapshot);
-        }
-        scheduler.stop();
-      } else {
-        const thisTrial = snapshot.getCurrentTrial();
-        if (typeof thisTrial === 'undefined' || !('isTrials' in thisTrial) || thisTrial.isTrials) {
-          psychoJS.experiment.nextEntry(snapshot);
-        }
-      }
-    return Scheduler.Event.NEXT;
-    }
-  };
-}
-
-
-function importConditions(currentLoop) {
-  return async function () {
-    psychoJS.importAttributes(currentLoop.getCurrentTrial());
-    return Scheduler.Event.NEXT;
-    };
-}
-
-
-async function quitPsychoJS(message, isCompleted) {
-  // Check for and save orphaned data
-  if (psychoJS.experiment.isEntryEmpty()) {
-    psychoJS.experiment.nextEntry();
-  }
-  psychoJS.window.close();
-  psychoJS.quit({message: message, isCompleted: isCompleted});
-  
-  return Scheduler.Event.QUIT;
-}