Task dossier

Corsi Block-Tapping Task

T000060T000060-corsi-block-tapping-taskDraftWeb preview availableUpdated Jul 11, 2026

This task implements a computerized Corsi Block-Tapping Task based primarily on the eCorsi procedure. Nine identical square outlines occu...

Corsi Block-Tapping Task flow diagram
Corsi Block-Tapping Task flow diagram
Preview path
This task ships with a matched HTML companion so the browser preview can stay aligned to the canonical local repository.
Quick start
Clone locally, then follow the README for install and run instructions.
git clone https://github.com/TaskBeacon/T000060-corsi-block-tapping-task.git
cd T000060-corsi-block-tapping-task
# Follow the README for local setup and run steps

Corsi Block-Tapping Task

FieldValue
NameCorsi Block-Tapping Task
Task IDT000060
VariantComputerized forward/backward span
Versionv0.1.0
Date Updated2026-07-12
PsyFlow Version0.2.0
PsychoPy Version2025.1.1
ModalityBehavioral
LanguageChinese
Primary constructVisuospatial short-term and working memory
Releasev0.1.0

1. Task Overview

This task implements a computerized Corsi Block-Tapping Task based primarily on the eCorsi procedure. Nine identical square outlines occupy fixed irregular positions. A sequence of squares fills yellow one at a time, after which the participant reproduces the sequence by clicking the squares.

The forward condition requires the original order. The backward condition requires the reverse order. Each condition begins at sequence length 2 and uses two attempts per length. At least one correct attempt advances the span by one; two failures at the same length terminate that condition. Three length-3 practice trials precede each scored condition.

This is a research implementation. Deterministically generated no-repeat sequences support audit and replay, but the task does not claim clinical equivalence to unpublished or proprietary normative item sets.

2. Task Flow

Task Flow

Block-Level Flow

  1. General instruction.
  2. Forward and backward blocks in seeded counterbalanced order for human runs; fixed order for QA/simulation.
  3. Direction-specific instruction and three practice trials.
  4. Adaptive scored span trials from length 2 through a maximum of 9.
  5. Direction summary, then final forward/backward span summary.

Trial-Level Flow

PhaseDurationParticipant-facing event
Sequence ready500 msNine idle yellow outlines on black
Sequence flash500 ms/itemOne square fills yellow
Inter-flash gap500 msIdle board; produces 1000 ms flash onset interval
RecallSelf-paced, 30 s maxBlue ready marker and clickable board; selected squares light briefly
Practice feedback750 msCorrect/incorrect text, practice only
Intertrial interval500 msBlank black screen

The blue ready marker first appears with the final flash and remains visible during recall. Pointer input is accepted only after the final flash has completed.

Controller Logic

CorsiSpanController owns only adaptive span progression. It presents both attempts at the current length, advances when at least one is correct, and stops after two failures or successful completion of length 9. Trial identity, phase data, trigger timing, pointer hit testing, and response timestamps remain PsyFlow-owned.

Other Logic

Every core trial factor is preplanned by build_sequence_pool(). The sequence RNG uses a stable task seed and never shares state with timing. Sequences contain no repeated block through length 9. Human direction order is deterministically counterbalanced from subject ID.

3. Configuration Summary

a. Subject Info

ParameterValue
Subject IDThree digits
InputMouse or touch-compatible pointer

b. Window Settings

ParameterValue
Window1280 x 800 px
BackgroundBlack
UnitsPixels

c. Stimuli

StimulusDefinition
BoardNine identical 90 x 90 px yellow square outlines at fixed irregular coordinates
Active squareYellow filled square at the same coordinate as its outline
Recall markerSmall blue circle in the upper-right
TextChinese, SimHei

d. Timing

ParameterHuman profile
Flash duration500 ms
Flash IOI1000 ms
Recall ceiling30 s
Attempts per length2
Correct attempts required to advance1
Sequence range2-9

QA and simulation profiles shorten timing and maximum span while preserving forward/backward rules, pointer-sequence semantics, practice feedback, adaptive advancement, and stopping behavior.

e. Adaptive Controller

The focused controller stores only the current length, attempt count, correct attempts, span, and termination reason. It does not own trial identity, response capture, timing, or persistence.

f. Triggers

EventCode
Experiment start1
Block start10
Sequence ready20
Sequence flash21
Recall onset30
Block selection31
Recall complete32
Recall timeout33
Practice feedback40
Trial ITI50
Block end90
Experiment end99

Run locally with:

python main.py human
python main.py qa --config config/config_qa.yaml
python main.py sim --config config/config_scripted_sim.yaml
python main.py sim --config config/config_sampler_sim.yaml

4. Methods (for academic publication)

Participants completed a computerized Corsi Block-Tapping Task implemented with PsychoPy and PsyFlow. Nine identical yellow square outlines were displayed in fixed irregular positions on a black background. On each trial, squares filled yellow sequentially for 500 ms each with a 1000 ms onset-to-onset interval. A blue marker signaled the recall phase, during which participants selected the same squares using a pointer. In the forward block, participants reproduced the original order; in the backward block, they reproduced the reverse order. Each block began with three practice trials of length 3. Scored assessment began at length 2 with two trials per length. At least one correct sequence advanced the participant to the next length, while two incorrect sequences at one length terminated that block. Span was the longest sequence length successfully reproduced. Exact sequences, selections, first-tap latency, completion latency, accuracy, timeout status, and adaptive state were recorded.

References

  • Brunetti, R., Del Gatto, C., & Delogu, F. (2014). eCorsi: implementation and testing of the Corsi block-tapping task for digital tablets. Frontiers in Psychology, 5, 939. https://doi.org/10.3389/fpsyg.2014.00939
  • Smyth, M. M., & Scholey, K. A. (1994). Interference in immediate spatial memory. Memory & Cognition, 22, 1-13. https://doi.org/10.3758/BF03202756
  • Pickering, S. J., Gathercole, S. E., & Peaker, S. (1998). Verbal and visuospatial short-term memory in children. Memory & Cognition, 26, 1117-1126. https://doi.org/10.3758/BF03201189

Full evidence mappings are in references/.