Tutorials

Interactive Jupyter notebook tutorials are available in the tutorials/ directory of the repository.

Overview Tutorials

#	Tutorial	Description
1	Base Overview	Introduction to the core neurodesign workflow
2	Comparing Designs Across Experiments	Comparing designs across diverse experiment definitions
3	Progressive Experiment Building	Build event-level designs progressively from simple to complex task structures

Base Function Tutorials

#	Tutorial	Description
4	Designing, Scoring, and Optimising	Core workflow: designing, scoring, and optimising
5	Comparing Designs	Side-by-side design comparison
6	Discovering Best Design	Finding the optimal design
7	Optimising and Reporting	Running optimisation and generating reports

New Feature Tutorials

#	Tutorial	Description
8	Controlled Probabilistic Ordering with Event Templates	Sample event-level orders from probabilistic motifs rather than single-event draws
9	Fixed Stimulus Order: Optimize Timing Without Changing the Task Sequence	Keep the event sequence fixed while optimisation focuses on timing
10	Transition-Specific ITIs with conditional_ITI	Use transition-dependent ITI distributions keyed by (previous_event, current_event)
11	Variable Stimulus Durations with stimuli_durations	Assign fixed or distribution-based durations per stimulus class

Tip

To run these notebooks locally, install the package in development mode and register the Jupyter kernel. See the installation guide for details.