feat(matlab): print full native fitlme/fitglme summary in every scenario

Add tdcs_model_summary as the single place that renders a fitted model verbatim (disp(model) with the Command-Window <strong> markup stripped), and route every report through it so all scenarios emit the complete model-fitting output: - tdcs_report: adds the learning-rate GLMM's full summary (count/rate already had theirs); localCleanDisp now delegates to the shared helper. - tdcs_lme_report / tdcs_paper_lme: embed the full fitlme summary before the curated effect table. - tdcs_phase_lme: appends each phase's full fitlme summary. Tests: tReport asserts 3 native summaries in a GLMM report; tLme asserts the lme_*/paper_*/phase_* reports embed 1/1/3 summaries with markup stripped. Suite 39/39. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-20 14:21:34 -04:00
parent d59ff2b659
commit 0e9263b958
41 changed files with 4637 additions and 7 deletions
@@ -0,0 +1,73 @@
+==============================================================================
+LINEAR MIXED MODEL (days x tDCS) -- scenario: lme_mergeA2_full
+==============================================================================
+model: success ~ day * tDCS + (1|subject)   [tDCS: Electrode-Box-B2 = 1 vs Electrode-Box-A2 = 0]
+N = 8 subjects, 109 sessions
+day coverage: Box-B2 0..22, Box-A2 0..14
+(day is raw and 0-indexed: our day 0 = the paper's "Day 1", so the tDCS
+ main effect below is the group difference on Day 1 -- comparable to the paper.)
+** WARNING: the groups' day coverage is UNEQUAL (differ by 8 days). The
+   interaction/slope over this window EXTRAPOLATES the shorter group's line and is
+   CONFOUNDED -- prefer the _d0_14 window (both groups have data throughout). **
+
+==============================================================================
+FULL MODEL SUMMARY -- fitlme: success ~ day*tDCS + (1|subject)
+==============================================================================
+
+Linear mixed-effects model fit by ML
+
+Model information:
+    Number of observations             109
+    Fixed effects coefficients           4
+    Random effects coefficients          8
+    Covariance parameters                2
+
+Formula:
+    success ~ 1 + day*tDCS + (1 | subject)
+
+Model fit statistics:
+    AIC       BIC       LogLikelihood    Deviance
+    962.68    978.83    -475.34          950.68  
+
+Fixed effects coefficients (95% CIs):
+    Name                   Estimate    SE         tStat      DF     pValue    
+    {'(Intercept)'}         20.701      4.9127     4.2138    105    5.3256e-05
+    {'day'        }         6.8599     0.69872     9.8178    105    1.5726e-16
+    {'tDCS'       }         22.092      6.4372     3.4319    105    0.00085848
+    {'day:tDCS'   }        -2.1793     0.81821    -2.6635    105     0.0089525
+
+
+    Lower      Upper   
+      10.96      30.442
+     5.4745      8.2453
+     9.3279      34.855
+    -3.8016    -0.55692
+
+Random effects covariance parameters (95% CIs):
+Group: subject (8 Levels)
+    Name1                  Name2                  Type           Estimate  
+    {'(Intercept)'}        {'(Intercept)'}        {'std'}        2.1043e-15
+
+
+    Lower    Upper
+    NaN      NaN  
+
+Group: Error
+    Name               Estimate    Lower     Upper 
+    {'Res Std'}        18.954      16.597    21.644
+
+
+effect                      t (df)         F (df1)       p
+----------------------------------------------------------------------
+days x tDCS (interaction)   t(105)= -2.66  F(1)=   7.094  p=0.008953
+days (learning)             t(105)=  9.82  F(1)=  96.388  p=1.573e-16
+tDCS (main, at Day 1)       t(105)=  3.43  F(1)=  11.778  p=0.0008585
+
+INTERPRETATION
+  - days x tDCS interaction: SIGNIFICANT (p=0.0090, slope diff=-2.18) -> the tDCS (Box-B2) group improves SLOWER -- groups CONVERGE (Box-B2 is ahead early, the gap narrows).
+  - days (learning): SIGNIFICANT (p=1.6e-16) -> performance improves with training.
+  - tDCS main effect on Day 1 (our day 0): SIGNIFICANT (p=0.0009) -> the groups already DIFFER on Day 1.
+
+Paper reference (N=24): interaction t(227)=2.68, F(1)=7.12, p=0.008;
+  days t(227)=9.64, F(1)=267.64, p=1.2e-18; tDCS t(227)=0.23, F(1)=0.053, p=0.81.
+  (Our N and exact statistics differ; this replicates the MODEL FORM on our data.)