Files
experiments-database/analysis/matlab/tdcs_phase_lme.m
T
Experiments DB Dev 8a18c894dd feat(matlab): add Satterthwaite DF + honest random-slope test to LME reports
Every fitlme-based report (lme_*, paper_*, phase_*, and the variations'
analyze.m) now shows, per effect: residual-DF p, Satterthwaite-DF p, and --
for the interaction -- an HONEST test from a per-animal random-SLOPE model
(day|rat), whose Satterthwaite DF collapses toward the animal count.

New: tdcs_random_slope_interaction.m (shared helper). Wired into tdcs_lme,
tdcs_paper_lme, tdcs_phase_lme, variation_analyze; SUMMARY.csv gains
interaction_p_satt / interaction_p_rs. Regenerated all results/, variations/,
matched-effort outputs.

Key point this surfaces: Satterthwaite ~= residual on the random-INTERCEPT
model (the slope's error is at session level), so it does NOT fix
pseudoreplication; the random-slope model does. Effect: full-range mergeA2
interaction 0.009 -> 0.75 (collapses); unmerge_d0_5 0.015 -> 0.13 (n.s.);
the pooled-control early windows survive honestly (naive_a2_d0_5 0.001 ->
0.028; naive_boxa_d0_5 0.003 -> 0.036). Suite 42/42.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-22 15:45:19 -04:00

97 lines
4.2 KiB
Matlab

function P = tdcs_phase_lme(mergeKey, cfg, phases)
%TDCS_PHASE_LME Refit the days x tDCS LME within learning phases (Box-B2 vs A2).
% P = TDCS_PHASE_LME(MERGEKEY, CFG) fits the same linear mixed model as the
% lme_* scenarios -- success ~ dayp*tDCS + (1|subject) -- SEPARATELY within
% each learning phase, for the Box-B2 (tDCS=1) vs Box-A2 (tDCS=0) subset of
% the MERGEKEY grouping ('unmerged' | 'mergeA2' | 'mergeB2'). `dayp` is `day`
% centered at each phase's start, so the tDCS main effect reads as the group
% difference on the phase's first day (the interaction and slopes are
% invariant to this centering). Prints a per-phase table and writes
% results/phase_<MERGEKEY>.txt.
%
% P = TDCS_PHASE_LME(MERGEKEY, CFG, PHASES) uses custom phase windows
% (default {[0 5],[6 10],[6 13]}), each a [loDay hiDay] pair.
%
% P.phases{k} has: .phase .nSub .a2Slope .b2Slope .dayP (learning) .tDCSlevelP
% (between-group level at phase start) .interP .interEst .interCI (the
% between-group learning-rate difference and its 95% CI).
if nargin < 3 || isempty(phases)
phases = {[0 5], [6 10], [6 13]};
end
Sfull = tdcs_scenario_data([mergeKey '_full']);
T = Sfull(ismember(Sfull.group, {cfg.anchorLow, cfg.anchorHigh}), :);
P = struct('mergeKey', mergeKey, 'phases', {cell(1, numel(phases))});
bar = repmat('=', 1, 78);
s = sprintf('%s\n', bar);
s = [s sprintf('PHASED days x tDCS LME -- %s (Box-B2 vs Box-A2)\n', mergeKey)];
s = [s sprintf('%s\n', bar)];
s = [s sprintf('model per phase: success ~ dayp*tDCS + (1|subject) [dayp = day - phaseStart]\n\n')];
s = [s sprintf('%-8s N A2slp B2slp day p tDCS p intP(res) intP(Satt) intP(RS) slopeDiff [95%% CI]\n', 'phase')];
s = [s sprintf('%s\n', repmat('-', 1, 104))];
rawSummaries = '';
for k = 1:numel(phases)
ph = phases{k};
Tp = T(T.day >= ph(1) & T.day <= ph(2), :);
Tp.dayp = Tp.day - ph(1);
Tp.tDCS = double(Tp.group == cfg.anchorHigh);
lme = fitlme(Tp, 'success ~ dayp*tDCS + (1|subject)');
C = lme.Coefficients; A = anova(lme); ci = coefCI(lme);
As = anova(lme, 'DFMethod', 'satterthwaite');
rs = tdcs_random_slope_interaction(Tp, ...
'success ~ dayp*tDCS + (dayp|subject)', 'dayp:tDCS');
ii = strcmp(C.Name, 'dayp:tDCS');
di = strcmp(C.Name, 'dayp');
e = struct();
e.phase = ph;
e.nSub = numel(unique(Tp.subject));
e.a2Slope = C.Estimate(di);
e.b2Slope = C.Estimate(di) + C.Estimate(ii);
e.dayP = A.pValue(strcmp(A.Term, 'dayp'));
e.tDCSlevelP = A.pValue(strcmp(A.Term, 'tDCS'));
e.interP = A.pValue(strcmp(A.Term, 'dayp:tDCS'));
e.interPsatt = As.pValue(strcmp(As.Term, 'dayp:tDCS')); % Satterthwaite DF
e.interPrs = rs.p; e.rsOk = rs.ok; % honest random-slope
e.interEst = C.Estimate(ii);
e.interCI = ci(ii, :);
P.phases{k} = e;
if rs.ok; rsStr = sprintf('%.3f', rs.p); else; rsStr = 'n/a'; end
s = [s sprintf('%d-%-5d %d %5.2f %5.2f %-8.2g %-8.3f %-9.3f %-10.3f %-9s %+.2f [%+.2f,%+.2f]\n', ...
ph(1), ph(2), e.nSub, e.a2Slope, e.b2Slope, e.dayP, e.tDCSlevelP, ...
e.interP, e.interPsatt, rsStr, e.interEst, e.interCI(1), e.interCI(2))]; %#ok<AGROW>
rawSummaries = [rawSummaries tdcs_model_summary(lme, ...
sprintf('phase %d-%d: success ~ dayp*tDCS + (1|subject)', ph(1), ph(2))) ...
sprintf('\n')]; %#ok<AGROW>
end
s = [s sprintf(['\nColumns: intP(res)=observation-level DF (anticonservative); intP(Satt)=Satterthwaite\n' ...
'DF (~= residual on this random-intercept model); intP(RS)=per-animal random-slope\n' ...
'(dayp|subject) model, the honest test (DF collapses toward the animal count; ''n/a'' if it\n' ...
'did not converge). The early phase carries the Box-B2 faster-acquisition signal; late\n' ...
'phases converge.\n'])];
s = [s rawSummaries];
fprintf('%s', s);
localWrite(['phase_' mergeKey], s);
end
function localWrite(name, s)
thisDir = fileparts(mfilename('fullpath'));
resDir = fullfile(thisDir, 'results');
if ~exist(resDir, 'dir'); mkdir(resDir); end
fid = fopen(fullfile(resDir, [name '.txt']), 'w');
if fid < 0; error('tdcs_phase_lme:fopen', 'Cannot open results file for "%s".', name); end
cleanup = onCleanup(@() fclose(fid)); %#ok<NASGU>
fprintf(fid, '%s', s);
end