Resting-state Task (EC + EO)

Field	Value
Name	Resting-state Task (EC + EO)
Version	v1.2.0
URL / Repository	https://github.com/TaskBeacon/T000010-rest
Short Description	Eyes-closed / eyes-open resting-state paradigm for EEG baseline acquisition
Created By	Zhipeng Cao (zhipeng30@foxmail.com)
Date Updated	2026-03-02
PsyFlow Version	0.1.9
PsychoPy Version	2025.1.1
Modality	Behavior/EEG
Language	Chinese
Voice Name	zh-CN-YunyangNeural

1. Task Overview

This task runs one resting-state block with EC/EO conditions in sequence. Participants read/listen to instructions and do not provide trial responses during rest windows.

2. Task Flow

Block-Level Flow

• Load runtime settings, initialize triggers/window, and register stimuli.
• Run condition sequence (EC/EO) per block configuration.
• Save outputs and close runtime resources.

Trial-Level Flow

• block_instruction: condition-specific instruction display.
• fixation: passive rest window for the configured duration.

Controller Logic

• No adaptive controller is used.
• Condition order is generated by BlockUnit.generate_conditions(order="sequential").

Other Runtime Logic

• Voice prompts are optional and controlled by task.voice_enabled.
• Trial responder context is set through set_trial_context(...) for auditability.

Runtime Modes

• Human (default): python main.py
• QA: python main.py qa --config config/config_qa.yaml
• Scripted sim: python main.py sim --config config/config_scripted_sim.yaml
• Sampler sim: python main.py sim --config config/config_sampler_sim.yaml

3. Configuration Summary

• config/config.yaml: base human run profile
• config/config_qa.yaml: QA/dev profile (short smoke run)
• config/config_scripted_sim.yaml: scripted simulation profile
• config/config_sampler_sim.yaml: task-local sampler simulation profile

a. Subject Info

• Collected fields: subject_id, subname, age, gender.
• Subject form and localized labels are configured in subinfo_fields and subinfo_mapping.

b. Window Settings

• Config path: window.
• Uses full-screen display with degree (deg) units and gray background.

c. Stimuli

• Condition instruction stimuli: EC_instruction, EO_instruction.
• Rest display stimuli: EC_stim, EO_stim.
• Global instruction/exit stimuli: general_instruction, good_bye.
• Optional voice assets: *_voice.

d. Timing

• Config path: timing.
• Base profile uses EC_duration=180 and EO_duration=180.
• QA/sim profiles use short durations for smoke execution.

Outputs

• Human: outputs/human/
• QA: outputs/qa/
• Scripted sim: outputs/sim/
• Sampler sim: outputs/sim_sampler/

Task Notes

• Trigger schema uses structured triggers.map/driver/policy/timing.
• Trial context for responder plugins is set in src/run_trial.py via set_trial_context(...).
• Sampler implementation for this task is in responders/task_sampler.py.

Runtime Context Phases

Phase Label	Meaning
block_instruction	block instruction stage in src/run_trial.py responder context.
fixation	rest-window stage in src/run_trial.py responder context.

4. Methods (for academic publication)

This resting-state task presents alternating condition instructions (e.g., eyes-open/eyes-closed) followed by passive rest windows with no active response requirement. Trial context labels separate instruction and rest stages for consistent QA/simulation logging. Timing and trigger events are controlled to support auditable baseline acquisition workflows.