eelbrain.testnd.TTestRelated
 class eelbrain.testnd.TTestRelated(y, x, c1=None, c0=None, match=None, sub=None, data=None, tail=0, samples=10000, pmin=None, tmin=None, tfce=False, tstart=None, tstop=None, parc=None, force_permutation=False, **criteria)
Massunivariate related samples ttest
The test data can be specified in two forms:
In long form, with
y
supplying the data,x
specifying condition for each case andmatch
determining which cases are related.In wide/repeated measures form, with
y
andx
both supplying data with matching case order.
 Parameters:
y (NDVar) – Dependent variable.
x (categorial  NDVar) – Model containing the cells which should be compared, or NDVar to which
y
should be compared. In the latter case, the next three parameters are ignored.c1 (str  tuple  None) – Test condition (cell of
x
).c1
andc0
can be omitted ifx
only contains two cells, in which case cells will be used in alphabetical order.match (categorial) – Units within which measurements are related (e.g. ‘subject’ in a withinsubject comparison).
sub (index) – Perform the test with a subset of the data.
data (Dataset) – If a Dataset is specified, all dataobjects can be specified as names of Dataset variables.
tail (0  1  1) – Which tail of the tdistribution to consider: 0: both (twotailed, default); 1: upper tail (onetailed); 1: lower tail (onetailed).
samples (int) – Number of samples for permutation test (default 10,000).
pmin (float) – Threshold for forming clusters: use a tvalue equivalent to an uncorrected pvalue.
tmin (float) – Threshold for forming clusters as tvalue.
tfce (float  bool) – Use thresholdfree cluster enhancement. Use a scalar to specify the step of TFCE levels (for
tfce is True
, 0.1 is used).tstart (float) – Start of the time window for the permutation test (default is the beginning of
y
).tstop (float) – Stop of the time window for the permutation test (default is the end of
y
).parc (str) – Collect permutation statistics for all regions of the parcellation of this dimension. For thresholdbased test, the regions are disconnected.
force_permutation (bool) – Conduct permutations regardless of whether there are any clusters.
mintime (scalar) – Minimum duration for clusters (in seconds).
minsource (int) – Minimum number of sources per cluster.
 Variables:
c1_mean (NDVar) – Mean in the c1 condition.
c0_mean (NDVar) – Mean in the c0 condition.
clusters (None  Dataset) – For clusterbased tests, a table of all clusters. Otherwise a table of all significant regions (or
None
if permutations were omitted). See also thefind_clusters()
method.difference (NDVar) – Difference between the mean in condition c1 and condition c0.
p (NDVar  None) – Map of pvalues corrected for multiple comparison (or None if no correction was performed).
p_uncorrected (NDVar) – Map of pvalues uncorrected for multiple comparison.
t (NDVar) – Map of tvalues.
tfce_map (NDVar  None) – Map of the test statistic processed with the thresholdfree cluster enhancement algorithm (or None if no TFCE was performed).
n (int) – Number of cases.
See also
testnd
Information on the different permutation methods
Notes
Also known as dependent ttest, paired ttest or repeated measures ttest.
Permutation distributions are generated by randomly switching condition labels within categories of
match
. For each permutation, a random subset ofmatch
is selected and the c1/c0 labels are switched for those cases.Tvalues for cases with zero variance are set to t=0.
Methods

Retrieve a specific cluster as NDVar 

Compute a probability map 

Find significant regions or clusters 
Find peaks in a thresholdfree cluster distribution 


List with information about the test 



Difference map masked by significance 

Statistical parameter map masked by significance 