pages: update blockunit

Author: zh1peng

docs/_build/doctrees/environment.pickle

@@ -207,7 +207,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../tutorials/getting_started.html">Getting Started with psyflow</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../tutorials/get_subinfo.html">SubInfo: Collecting Participant Information</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../tutorials/task_settings.html">TaskSettings: Configuring Your Experiment</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../tutorials/build_blocks.html">BlockUnit: Organizing Trials into Experimental Blocks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../tutorials/build_blocks.html">BlockUnit: Managing Trials</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../tutorials/build_stimulus.html">StimBank: Flexible Stimulus Management for PsychoPy</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../tutorials/send_trigger.html">TriggerSender: Precise Event Marking for EEG/MEG Experiments</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../tutorials/cli_usage.html">Command-Line Tools: Quick Project Setup</a></li>

docs/_build/doctrees/tutorials/build_blocks.doctree

@@ -261,9 +261,9 @@ print('Config JSON file:', settings.json_file)
 
 `TaskSettings` uses three related fields to control randomization and reproducibility:
 
-- ``(integer, default 2025)``: the base seed for generating block-specific seeds. Change this value in your config or at runtime to alter the overall randomization pattern.
-- ``(list of ints or `None`)``: one seed per block, used to initialize block-level randomization (e.g., shuffling condition order). If unset, seeds are generated automatically based on `overall_seed` and `seed_mode`.
-- ``(`"same_across_sub"` or `"same_within_sub"`)``: determines whether block seeds are shared across participants or personalized per subject.
+- `overall_seed`(integer, default 2025): the base seed for generating block-specific seeds. Change this value in your config or at runtime to alter the overall randomization pattern.
+- `block_seed`(list of ints or `None`): one seed per block, used to initialize block-level randomization (e.g., shuffling condition order). If unset, seeds are generated automatically based on `overall_seed` and `seed_mode`.
+- `seed_mode`(`"same_across_sub"` or `"same_within_sub"`)``: determines whether block seeds are shared across participants or personalized per subject.
 
 #### Controlling condition order per block
 
@@ -298,10 +298,10 @@ for i, seed in enumerate(settings.block_seed):
 
 #### Choosing a seed mode
 
-- `` (default)\
+- `same_across_sub` (default)\
   All participants share the same `block_seed` list generated from `overall_seed`. Use this when you need identical block randomization across the group (e.g., counterbalancing at the cohort level).
 
-- ``\
+- `same_within_sub`\
   Each subject receives a unique set of block seeds derived from their `subject_id`, ensuring reproducible yet individualized randomization. This approach:
 
   - **Reproducibility:** Allows precise reconstruction of any subject’s experimental sequence from their ID.

docs/_build/doctrees/tutorials/task_settings.doctree

@@ -206,7 +206,7 @@
 <li class="toctree-l1"><a class="reference internal" href="tutorials/getting_started.html">Getting Started with psyflow</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/get_subinfo.html">SubInfo: Collecting Participant Information</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/task_settings.html">TaskSettings: Configuring Your Experiment</a></li>
-<li class="toctree-l1"><a class="reference internal" href="tutorials/build_blocks.html">BlockUnit: Organizing Trials into Experimental Blocks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="tutorials/build_blocks.html">BlockUnit: Managing Trials</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/build_stimulus.html">StimBank: Flexible Stimulus Management for PsychoPy</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/send_trigger.html">TriggerSender: Precise Event Marking for EEG/MEG Experiments</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/cli_usage.html">Command-Line Tools: Quick Project Setup</a></li>

docs/_build/html/_modules/index.html

@@ -208,7 +208,7 @@
 <li class="toctree-l1"><a class="reference internal" href="tutorials/getting_started.html">Getting Started with psyflow</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/get_subinfo.html">SubInfo: Collecting Participant Information</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/task_settings.html">TaskSettings: Configuring Your Experiment</a></li>
-<li class="toctree-l1"><a class="reference internal" href="tutorials/build_blocks.html">BlockUnit: Organizing Trials into Experimental Blocks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="tutorials/build_blocks.html">BlockUnit: Managing Trials</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/build_stimulus.html">StimBank: Flexible Stimulus Management for PsychoPy</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/send_trigger.html">TriggerSender: Precise Event Marking for EEG/MEG Experiments</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/cli_usage.html">Command-Line Tools: Quick Project Setup</a></li>
@@ -269,7 +269,7 @@ <h1>Welcome to psyflow’s documentation!<a class="headerlink" href="#welcome-to
 <li class="toctree-l1"><a class="reference internal" href="tutorials/getting_started.html">Getting Started with psyflow</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/get_subinfo.html">SubInfo: Collecting Participant Information</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/task_settings.html">TaskSettings: Configuring Your Experiment</a></li>
-<li class="toctree-l1"><a class="reference internal" href="tutorials/build_blocks.html">BlockUnit: Organizing Trials into Experimental Blocks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="tutorials/build_blocks.html">BlockUnit: Managing Trials</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/build_stimulus.html">StimBank: Flexible Stimulus Management for PsychoPy</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/send_trigger.html">TriggerSender: Precise Event Marking for EEG/MEG Experiments</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/cli_usage.html">Command-Line Tools: Quick Project Setup</a></li>

docs/_build/html/_sources/tutorials/build_blocks.md.txt

@@ -208,7 +208,7 @@
 <li class="toctree-l1"><a class="reference internal" href="tutorials/getting_started.html">Getting Started with psyflow</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/get_subinfo.html">SubInfo: Collecting Participant Information</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/task_settings.html">TaskSettings: Configuring Your Experiment</a></li>
-<li class="toctree-l1"><a class="reference internal" href="tutorials/build_blocks.html">BlockUnit: Organizing Trials into Experimental Blocks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="tutorials/build_blocks.html">BlockUnit: Managing Trials</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/build_stimulus.html">StimBank: Flexible Stimulus Management for PsychoPy</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/send_trigger.html">TriggerSender: Precise Event Marking for EEG/MEG Experiments</a></li>
 <li class="toctree-l1"><a class="reference internal" href="tutorials/cli_usage.html">Command-Line Tools: Quick Project Setup</a></li>