analysis(matlab): per-variation subfolders (grouping x window) for the paper LME

Add make_variations.m + variation_analyze.m generating 20 self-contained
subfolders under analysis/matlab/variations/, one per grouping x day-window,
each with exactly three files: data.csv (curated subset), analyze.m (a simple
standalone script fitting behavior ~ stim + day + stim:day + (1|rat) on the
success COUNT), and result.txt (its output). Plus variations/SUMMARY.csv.

Groupings (stim=1 / stim=0, other groups dropped):
  unmerge     B2 vs A2
  right_only  B2+Right vs A2            (Box-A dropped)
  naive_a2    B2 vs A2+Naive           (Right, Box-A dropped)
  naive_boxa  B2 vs A2+Naive+Box-A     (Right dropped)
Windows: 0-10, 0-13, 0-5, 6-10, 6-13. All 20 have equal day coverage.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Experiments DB Dev
2026-07-20 20:49:54 -04:00
parent 963fd889b2
commit 969c0205e8
63 changed files with 4343 additions and 0 deletions
@@ -0,0 +1,74 @@
% Variation analysis -- the paper's linear mixed model on the successful-reach
% COUNT, fit on this folder's curated data subset.
%
% model: behavior ~ stim + day + stim:day + (1|rat)
% behavior = successful reaches (count per session)
% stim = 1 for the treatment group(s), 0 for the control group(s)
% day = training day within this window (0 = first analyzed day)
% rat = subject (random intercept)
%
% Self-contained: reads data.csv beside this script and writes result.txt.
% Run headless from this folder with: matlab -batch "analyze"
% (This is a copy of analysis/matlab/variation_analyze.m; see make_variations.m.)
here = fileparts(mfilename('fullpath'));
if isempty(here); here = pwd; end
vname = regexprep(here, '.*[/\\]', ''); % folder name = variation id
D = readtable(fullfile(here, 'data.csv'), 'TextType', 'string');
tbl = table(D.success, D.day - min(D.day), double(D.stim), categorical(D.subject), ...
'VariableNames', {'behavior', 'day', 'stim', 'rat'});
m = fitlme(tbl, 'behavior ~ stim + day + stim:day + (1|rat)');
C = m.Coefficients; A = anova(m); ci = coefCI(m);
gi = @(t) find(strcmp(C.Name, t), 1);
ga = @(t) find(strcmp(A.Term, t), 1);
row = @(nm, t) sprintf('%-26s t(%d)=%6.2f F(%d)=%8.3f p=%.4g\n', nm, ...
C.DF(gi(t)), C.tStat(gi(t)), A.DF1(ga(t)), A.FStat(ga(t)), C.pValue(gi(t)));
maxT = max(D.day(D.stim == 1)); minT = min(D.day(D.stim == 1));
maxC = max(D.day(D.stim == 0)); minC = min(D.day(D.stim == 0));
if abs(maxT - maxC) > 2
cov = '** WARNING: unequal day coverage -- interaction may be confounded. **';
else
cov = '(equal day coverage over this window)';
end
ii = gi('day:stim'); pI = C.pValue(ii); eI = C.Estimate(ii);
if pI >= 0.05
verdict = 'n.s. -- slopes parallel (no differential learning rate)';
elseif eI > 0
verdict = 'SIGNIFICANT positive -- treatment improves FASTER (benefit accumulates)';
else
verdict = 'SIGNIFICANT negative -- treatment improves SLOWER (groups converge)';
end
bar = repmat('=', 1, 78);
raw = regexprep(evalc('disp(m)'), '</?strong>', '');
s = sprintf('%s\nVARIATION: %s\n%s\n', bar, vname, bar);
s = [s sprintf('model: behavior ~ stim + day + stim:day + (1|rat) (behavior = success COUNT)\n')];
s = [s sprintf('day = training day within window (0 = first analyzed day)\n')];
s = [s sprintf('treatment (stim=1): %s\n', strjoin(cellstr(unique(D.group(D.stim == 1))), ', '))];
s = [s sprintf('control (stim=0): %s\n', strjoin(cellstr(unique(D.group(D.stim == 0))), ', '))];
s = [s sprintf('N = %d rats, %d sessions raw day coverage: treat %d..%d, control %d..%d\n', ...
numel(unique(D.subject)), height(D), minT, maxT, minC, maxC)];
s = [s sprintf('%s\n\n%s\nFULL MODEL SUMMARY -- fitlme\n%s\n%s\n', cov, bar, bar, raw)];
s = [s sprintf('%-26s %-13s %-13s %s\n%s\n', 'effect', 't (df)', 'F (df1)', 'p', repmat('-', 1, 66))];
s = [s row('stim x day (interaction)', 'day:stim')];
s = [s row('day (learning)', 'day')];
s = [s row('stim (main, window start)', 'stim')];
s = [s sprintf('interaction 95%% CI: [%+.2f, %+.2f]\n', ci(ii, 1), ci(ii, 2))];
s = [s sprintf('INTERPRETATION: stim x day interaction %s (p=%.4g, slope diff=%+.2f)\n', verdict, pI, eI)];
s = [s sprintf('Paper (N=24): interaction t(227)=2.68, F(1)=7.12, p=0.008.\n')];
fprintf('%s', s);
fid = fopen(fullfile(here, 'result.txt'), 'w');
fprintf(fid, '%s', s);
fclose(fid);
% Machine-readable handoff for the summary table (see make_variations.m).
VARRESULT = struct('name', vname, 'nRats', numel(unique(D.subject)), ...
'nObs', height(D), 'interP', pI, 'interEst', eI, ...
'stimP', C.pValue(gi('stim')), 'dayP', C.pValue(gi('day')), ...
'covEqual', abs(maxT - maxC) <= 2);
@@ -0,0 +1,66 @@
subject,group,day,success,total,stim
Banh-mi-1,Electrode-Box-B2,0,13,84,1
Banh-mi-1,Electrode-Box-B2,1,35,86,1
Banh-mi-1,Electrode-Box-B2,2,47,110,1
Banh-mi-1,Electrode-Box-B2,3,65,140,1
Banh-mi-1,Electrode-Box-B2,4,70,127,1
Banh-mi-1,Electrode-Box-B2,5,102,142,1
Banh-mi-2,Electrode-Box-A2,0,25,97,0
Banh-mi-2,Electrode-Box-A2,1,22,101,0
Banh-mi-2,Electrode-Box-A2,2,22,119,0
Banh-mi-2,Electrode-Box-A2,3,29,118,0
Banh-mi-2,Electrode-Box-A2,4,27,136,0
Banh-mi-2,Electrode-Box-A2,5,43,146,0
Egg-tart-1,Electrode-Box-B2,0,7,56,1
Egg-tart-1,Electrode-Box-B2,1,16,78,1
Egg-tart-1,Electrode-Box-B2,2,23,103,1
Egg-tart-1,Electrode-Box-B2,3,63,120,1
Egg-tart-1,Electrode-Box-B2,4,69,132,1
Egg-tart-1,Electrode-Box-B2,5,83,136,1
Egg-tart-2,Electrode-Box-A2,0,9,32,0
Egg-tart-2,Electrode-Box-A2,1,2,38,0
Egg-tart-2,Electrode-Box-A2,2,31,93,0
Egg-tart-2,Electrode-Box-A2,3,44,101,0
Egg-tart-2,Electrode-Box-A2,4,54,131,0
Egg-tart-2,Electrode-Box-A2,5,84,139,0
Khoai-lang-2,Naive,0,0,0,0
Khoai-lang-2,Naive,1,0,0,0
Khoai-lang-2,Naive,2,10,47,0
Khoai-lang-2,Naive,3,11,52,0
Khoai-lang-2,Naive,4,9,56,0
Khoai-lang-2,Naive,5,34,95,0
Khoai-tay-1,Electrode-Box-A,0,14,62,0
Khoai-tay-1,Electrode-Box-A,1,22,83,0
Khoai-tay-1,Electrode-Box-A,2,6,79,0
Khoai-tay-1,Electrode-Box-A,3,28,97,0
Khoai-tay-1,Electrode-Box-A,4,60,134,0
Khoai-tay-1,Electrode-Box-A,5,75,138,0
Khoai-tay-2,Naive,1,21,68,0
Khoai-tay-2,Naive,2,6,79,0
Khoai-tay-2,Naive,3,0,83,0
Khoai-tay-2,Naive,4,28,87,0
Khoai-tay-2,Naive,5,31,125,0
OM-2,Naive,0,1,7,0
OM-2,Naive,1,11,33,0
OM-2,Naive,2,19,62,0
OM-2,Naive,3,29,117,0
OM-2,Naive,4,73,126,0
OM-2,Naive,5,53,135,0
Root-beer-1,Electrode-Box-B2,0,11,85,1
Root-beer-1,Electrode-Box-B2,1,18,76,1
Root-beer-1,Electrode-Box-B2,2,40,105,1
Root-beer-1,Electrode-Box-B2,3,55,134,1
Root-beer-1,Electrode-Box-B2,4,75,136,1
Root-beer-1,Electrode-Box-B2,5,64,133,1
Root-beer-2,Electrode-Box-A2,0,22,74,0
Root-beer-2,Electrode-Box-A2,1,31,87,0
Root-beer-2,Electrode-Box-A2,2,49,134,0
Root-beer-2,Electrode-Box-A2,3,31,89,0
Root-beer-2,Electrode-Box-A2,4,60,140,0
Root-beer-2,Electrode-Box-A2,5,84,147,0
Vu-vuong,Naive,0,18,61,0
Vu-vuong,Naive,1,35,91,0
Vu-vuong,Naive,2,61,127,0
Vu-vuong,Naive,3,34,146,0
Vu-vuong,Naive,4,61,141,0
Vu-vuong,Naive,5,37,151,0
1 subject group day success total stim
2 Banh-mi-1 Electrode-Box-B2 0 13 84 1
3 Banh-mi-1 Electrode-Box-B2 1 35 86 1
4 Banh-mi-1 Electrode-Box-B2 2 47 110 1
5 Banh-mi-1 Electrode-Box-B2 3 65 140 1
6 Banh-mi-1 Electrode-Box-B2 4 70 127 1
7 Banh-mi-1 Electrode-Box-B2 5 102 142 1
8 Banh-mi-2 Electrode-Box-A2 0 25 97 0
9 Banh-mi-2 Electrode-Box-A2 1 22 101 0
10 Banh-mi-2 Electrode-Box-A2 2 22 119 0
11 Banh-mi-2 Electrode-Box-A2 3 29 118 0
12 Banh-mi-2 Electrode-Box-A2 4 27 136 0
13 Banh-mi-2 Electrode-Box-A2 5 43 146 0
14 Egg-tart-1 Electrode-Box-B2 0 7 56 1
15 Egg-tart-1 Electrode-Box-B2 1 16 78 1
16 Egg-tart-1 Electrode-Box-B2 2 23 103 1
17 Egg-tart-1 Electrode-Box-B2 3 63 120 1
18 Egg-tart-1 Electrode-Box-B2 4 69 132 1
19 Egg-tart-1 Electrode-Box-B2 5 83 136 1
20 Egg-tart-2 Electrode-Box-A2 0 9 32 0
21 Egg-tart-2 Electrode-Box-A2 1 2 38 0
22 Egg-tart-2 Electrode-Box-A2 2 31 93 0
23 Egg-tart-2 Electrode-Box-A2 3 44 101 0
24 Egg-tart-2 Electrode-Box-A2 4 54 131 0
25 Egg-tart-2 Electrode-Box-A2 5 84 139 0
26 Khoai-lang-2 Naive 0 0 0 0
27 Khoai-lang-2 Naive 1 0 0 0
28 Khoai-lang-2 Naive 2 10 47 0
29 Khoai-lang-2 Naive 3 11 52 0
30 Khoai-lang-2 Naive 4 9 56 0
31 Khoai-lang-2 Naive 5 34 95 0
32 Khoai-tay-1 Electrode-Box-A 0 14 62 0
33 Khoai-tay-1 Electrode-Box-A 1 22 83 0
34 Khoai-tay-1 Electrode-Box-A 2 6 79 0
35 Khoai-tay-1 Electrode-Box-A 3 28 97 0
36 Khoai-tay-1 Electrode-Box-A 4 60 134 0
37 Khoai-tay-1 Electrode-Box-A 5 75 138 0
38 Khoai-tay-2 Naive 1 21 68 0
39 Khoai-tay-2 Naive 2 6 79 0
40 Khoai-tay-2 Naive 3 0 83 0
41 Khoai-tay-2 Naive 4 28 87 0
42 Khoai-tay-2 Naive 5 31 125 0
43 OM-2 Naive 0 1 7 0
44 OM-2 Naive 1 11 33 0
45 OM-2 Naive 2 19 62 0
46 OM-2 Naive 3 29 117 0
47 OM-2 Naive 4 73 126 0
48 OM-2 Naive 5 53 135 0
49 Root-beer-1 Electrode-Box-B2 0 11 85 1
50 Root-beer-1 Electrode-Box-B2 1 18 76 1
51 Root-beer-1 Electrode-Box-B2 2 40 105 1
52 Root-beer-1 Electrode-Box-B2 3 55 134 1
53 Root-beer-1 Electrode-Box-B2 4 75 136 1
54 Root-beer-1 Electrode-Box-B2 5 64 133 1
55 Root-beer-2 Electrode-Box-A2 0 22 74 0
56 Root-beer-2 Electrode-Box-A2 1 31 87 0
57 Root-beer-2 Electrode-Box-A2 2 49 134 0
58 Root-beer-2 Electrode-Box-A2 3 31 89 0
59 Root-beer-2 Electrode-Box-A2 4 60 140 0
60 Root-beer-2 Electrode-Box-A2 5 84 147 0
61 Vu-vuong Naive 0 18 61 0
62 Vu-vuong Naive 1 35 91 0
63 Vu-vuong Naive 2 61 127 0
64 Vu-vuong Naive 3 34 146 0
65 Vu-vuong Naive 4 61 141 0
66 Vu-vuong Naive 5 37 151 0
@@ -0,0 +1,65 @@
==============================================================================
VARIATION: naive_boxa_d0_5
==============================================================================
model: behavior ~ stim + day + stim:day + (1|rat) (behavior = success COUNT)
day = training day within window (0 = first analyzed day)
treatment (stim=1): Electrode-Box-B2
control (stim=0): Electrode-Box-A, Electrode-Box-A2, Naive
N = 11 rats, 65 sessions raw day coverage: treat 0..5, control 0..5
(equal day coverage over this window)
==============================================================================
FULL MODEL SUMMARY -- fitlme
==============================================================================
Linear mixed-effects model fit by ML
Model information:
Number of observations 65
Fixed effects coefficients 4
Random effects coefficients 11
Covariance parameters 2
Formula:
behavior ~ 1 + day*stim + (1 | rat)
Model fit statistics:
AIC BIC LogLikelihood Deviance
540.21 553.25 -264.1 528.21
Fixed effects coefficients (95% CIs):
Name Estimate SE tStat DF pValue
{'(Intercept)'} 8.2006 4.622 1.7743 61 0.081011
{'day' } 8.8157 1.0827 8.1421 61 2.5062e-11
{'stim' } 1.3073 8.7275 0.1498 61 0.88142
{'day:stim' } 6.4033 2.0341 3.1479 61 0.0025447
Lower Upper
-1.0416 17.443
6.6507 10.981
-16.144 18.759
2.3358 10.471
Random effects covariance parameters (95% CIs):
Group: rat (11 Levels)
Name1 Name2 Type Estimate
{'(Intercept)'} {'(Intercept)'} {'std'} 9.1032
Lower Upper
5.2068 15.915
Group: Error
Name Estimate Lower Upper
{'Res Std'} 12.477 10.33 15.071
effect t (df) F (df1) p
------------------------------------------------------------------
stim x day (interaction) t(61)= 3.15 F(1)= 9.909 p=0.002545
day (learning) t(61)= 8.14 F(1)= 66.293 p=2.506e-11
stim (main, window start) t(61)= 0.15 F(1)= 0.022 p=0.8814
interaction 95% CI: [+2.34, +10.47]
INTERPRETATION: stim x day interaction SIGNIFICANT positive -- treatment improves FASTER (benefit accumulates) (p=0.002545, slope diff=+6.40)
Paper (N=24): interaction t(227)=2.68, F(1)=7.12, p=0.008.