ContextDecisionMaking

class braintools.cogtask.ContextDecisionMaking(t_fixation=Quantity(300., 'ms'), t_context=Quantity(350., 'ms'), t_stimulus=Quantity(750., 'ms'), t_response=Quantity(100., 'ms'), num_contexts=2, num_choices=2, coherences=(6.4, 12.8, 25.6, 51.2), noise_sigma=Quantity(1., 'ms^0.5'), pop_per_choice=4, **kwargs)

Context-Dependent Decision Making task.

Agent receives a context cue indicating which stimulus dimension to attend. Two stimulus modalities are presented; context determines which is relevant.

Structure: Fixation >> Context >> Stimulus >> Response

Parameters:

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

• t_context (Quantity) – Context cue duration (default: 350ms).

• t_stimulus (Quantity) – Stimulus duration (default: 750ms).

• t_response (Quantity) – Response duration (default: 100ms).

• num_contexts (int) – Number of context types (default: 2).

• num_choices (int) – Number of choices per context (default: 2).

• coherences (Sequence[float]) – Coherence levels (default: (6.4, 12.8, 25.6, 51.2)).

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

• seed (int, optional) – Random seed.

Examples

>>> task = ContextDecisionMaking()
>>> X, Y, info = task.sample_trial(0)

define_features()

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()

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)

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