@@ -116,7 +116,15 @@ neighboring CpGs using [radadjust](../radadjust).
116116
117117## Tutorial
118118
119- This tutorial aims to answer questions users often have about the assumptions
119+ The data used here is available at:
120+
121+ ``` txt
122+ https://github.com/andrewdavidsmith/radmeth-demo-simulated-data
123+ ```
124+
125+ And the results below were generated with v1.5.1 on Linux.
126+
127+ This tutorial should answer questions users often have about the assumptions
120128of radmeth and how to interepret the results. We will assume a factor of
121129interest, with levels A and B. We will also assume a potentially confounding
122130factor, sex, with levels M and F. Further, we have 8 total samples, 2 samples
@@ -274,16 +282,16 @@ differential methylation between levels for our factor of interest (named
274282
275283``` console
276284$ head sim/samples.radmeth
277- chr1 163 + CG 0.0864953 35 22 45 36
278- chr1 206 + CG 0.444024 37 30 43 38
279- chr1 232 + CG 0.756591 28 20 35 26
280- chr1 278 + CG 0.780385 43 35 37 31
281- chr1 296 + CG 0.64704 33 29 38 32
282- chr1 310 + CG 0.640826 37 28 31 22
283- chr1 322 + CG 0.0971364 38 33 47 35
284- chr1 324 + CG 0.257851 40 29 31 26
285- chr1 350 + CG 0.893476 36 30 35 29
286- chr1 356 + CG 0.0527032 37 35 42 33
285+ chr1 163 + CG 0.0877822 35 22 45 36
286+ chr1 206 + CG 0.442745 37 30 43 38
287+ chr1 232 + CG 0.756925 28 20 35 26
288+ chr1 278 + CG 0.794626 43 35 37 31
289+ chr1 296 + CG 0.635986 33 29 38 32
290+ chr1 310 + CG 0.641986 37 28 31 22
291+ chr1 322 + CG 0.0973903 38 33 47 35
292+ chr1 324 + CG 0.260703 40 29 31 26
293+ chr1 350 + CG 0.888242 36 30 35 29
294+ chr1 356 + CG 0.0535286 37 35 42 33
287295```
288296
289297Focusing on the 5th column, we see values between 0 and 1, but none of them
@@ -294,7 +302,7 @@ for all 4 different original sets of features:
294302
295303``` shell
296304for i in M F A B; do
297- dnmtools selectsites -o sim/features_${i} .txt sim/features_${i} .bed sim/samples.radmeth;
305+ dnmtools selectsites -relaxed - o sim/features_${i} .txt sim/features_${i} .bed sim/samples.radmeth;
298306done
299307```
300308
@@ -303,11 +311,11 @@ above identifies sites as significant when they differ between levels A and B
303311of the factor of interest:
304312
305313``` console
306- $ for i in sim/features_* .counts ; do echo $i ` awk ' BEGIN{k=0;c=0}{k+=$5;c+=1}END{print k,c,k/c}' $i ` ; done | column -t
307- sim/features_A.counts 0.255448 430 0.000594064
308- sim/features_B.counts 0.114256 372 0.00030714
309- sim/features_F.counts 196.093 400 0.490232
310- sim/features_M.counts 295.234 588 0.502099
314+ $ for i in sim/features_[ABFM].txt ; do echo $i ` awk ' BEGIN{k=0;c=0}{k+=$5;c+=1}END{print k,c,k/c}' $i ` ; done | column -t
315+ sim/features_A.txt 0.256072 430 0.000595517
316+ sim/features_B.txt 0.114786 372 0.000308564
317+ sim/features_F.txt 197.332 400 0.493329
318+ sim/features_M.txt 297.728 588 0.50634
311319```
312320
313321The p-values in features associated with either M or F are averaging around
@@ -344,12 +352,12 @@ analogous but with this modified design matrix:
344352
345353``` console
346354$ dnmtools radmeth -o sim/samples_noint.radmeth -f factor design_noint.txt sim/table.txt
347- $ for i in M F A B; do dnmtools selectsites -o sim/features_noint_${i} .txt sim/features_${i} .bed sim/samples_noint.radmeth; done
355+ $ for i in M F A B; do dnmtools selectsites -relaxed - o sim/features_noint_${i} .txt sim/features_${i} .bed sim/samples_noint.radmeth; done
348356$ for i in sim/* _noint_* .txt; do echo $i ` awk ' BEGIN{k=0;c=0}{k+=$5;c+=1}END{print k,c,k/c}' $i ` ; done | column -t
349- sim/features_noint_A.txt 8.27788 430 0.0192509
350- sim/features_noint_B.txt 15.2391 372 0.0409653
351- sim/features_noint_F.txt 77.2438 400 0.193109
352- sim/features_noint_M.txt 93.7181 588 0.159385
357+ sim/features_noint_A.txt 8.27931 430 0.0192542
358+ sim/features_noint_B.txt 15.2397 372 0.040967
359+ sim/features_noint_F.txt 77.2656 400 0.193164
360+ sim/features_noint_M.txt 93.7312 588 0.159407
353361```
354362
355363Although the sites within features corresponding to A and B are much lower on
0 commit comments