Reaching1D#

class braintools.cogtask.Reaching1D(t_fixation=Quantity(500., 'ms'), t_stimulus=Quantity(500., 'ms'), t_delay=Quantity(500., 'ms'), t_response=Quantity(500., 'ms'), num_targets=8, noise_sigma=Quantity(0.5, 'ms^0.5'), **kwargs)[source]#

1D Reaching task.

Agent must reach to a target location after a delay.

Structure: Fixation >> Target >> Delay >> Reach

Parameters:
  • t_fixation (Quantity) – Fixation duration (default: 500ms).

  • t_stimulus (Quantity) – Target presentation duration (default: 500ms).

  • t_delay (Quantity) – Delay duration (default: 500ms).

  • t_response (Quantity) – Movement duration (default: 500ms).

  • num_targets (int) – Number of possible target locations (default: 8).

  • noise_sigma (Array | ndarray | bool | number | bool | int | float | complex | Quantity) – Target location noise (default: 0.5 * u.ms**0.5).

  • seed (int, optional) – Random seed.

Examples

>>> import brainunit as u
>>> import braintools
>>> task = braintools.cogtask.Reaching1D(
...     num_targets=4, t_delay=1000 * u.ms, seed=0, dt=10.0 * u.ms)
>>> task.num_inputs, task.num_outputs
(5, 5)
>>> X, Y, info = task.sample_trial(0)
>>> X.shape, Y.shape
((250, 5), (250,))
>>>
>>> X, Y = task.batch_sample(4)  # time-first: (T, batch, features)
>>> X.shape, Y.shape
((250, 4, 5), (250, 4))
define_features()[source]#

Define input and output features.

Override in subclass for class-based task definition.

Return type:

Tuple

Returns:

  • input_features (Feature or FeatureSet) – Input feature definitions.

  • output_features (Feature or FeatureSet) – Output feature definitions.

define_phases()[source]#

Define the phase structure.

Override in subclass for class-based task definition.

Returns:

The task phase structure (single phase or composition).

Return type:

Phase

trial_init(ctx)[source]#

Initialize trial-level state.

Override in subclass to set up trial parameters like ground_truth, stimulus indices, etc.

Parameters:

ctx (Context) – Trial context to populate with state.

Return type:

None