eelbrain.table.difference

eelbrain.table.difference(y, x, c1, c0, match, sub=None, ds=None, by=None)

Subtract data in one cell from another

Parameters

  • y (Var | NDVar) – Dependent variable.

  • x (categorial) – Model for subtraction, providing categories to compute c1 - c0.

  • c1 (str | tuple) – Name of the cell in x that forms the minuend.

  • c0 (str | tuple) – Name of the cell in x that is to be subtracted from c1.

  • match (categorial) – Units over which measurements were repeated. c1 - c0 will be calculated separately for each level of match (e.g. "subject", or "subject % condition").

  • sub (None | index) – Only include a subset of the data.

  • ds (Dataset) – If a Dataset is specified other arguments can be str instead of data-objects and will be retrieved from ds.

Returns

diff – Dataset with the difference between c1 and c0 on y.

Return type

Dataset

Examples

ERP difference wave: assuming a dataset ds with EEG data (ds['eeg']), a variable named 'condition' with levels 'expected' and 'unexpected', and multiple subjects, the following will generate the unexpected - expected difference waves:

>>> diff = table.difference('eeg', 'condition', 'unexpected', 'expected',
... 'subject', ds=ds)

If ds also contains a different factor crossed with condition, called 'word' with levels 'verb' abd 'adjective', then separate difference waves for verbs and adjectives can be computed with:

>>> diff = table.difference('eeg', 'condition', 'unexpected', 'expected',
... 'subject % word', ds=ds)

Given the latter, the difference of the difference waves could be computed with:

>>> diffdiff = table.difference('eeg', 'word', 'verb', 'adjective',
... 'subject', ds=diff)