View source for Tutorials

==Running Tutorials on Your Computer==
Starting Fall 2019 we adopt [https://www.docker.com/ docker] to run our course material . We have created various [https://hub.docker.com/u/statisticalgenetics docker repositories] with source material freely available from [https://github.com/statgenetics/statgen-courses github] for users to readily setup and reproduce our tutorials on their own computers. These docker images can also be used as production tool to run relevant software on your computer (Mac, Linux or Windows) or even a high performance computing cluster (if properly configured) for your own data analysis.

===General instructions===
* [https://github.com/statgenetics/statgen-courses/wiki/How-to-launch-course-tutorials#alternative-to-cloud-server-use-your-own-computer Instructions to setup course tutorial environment on your computer]
* [https://github.com/statgenetics/statgen-courses/wiki/How-to-launch-course-tutorials#option-1-launch-exercise-in-jupyterlab Instructions to run course tutorial through JupyterLab]
* [https://github.com/statgenetics/statgen-courses/wiki/How-to-launch-course-tutorials#option-2-launch-from-command-shell Instructions to run course tutorial through command line terminal]


===Tutorial specific instructions===
We use a script [https://github.com/statgenetics/statgen-courses/blob/master/src/statgen-setup "statgen-setup"] to start the docker based environments for these tutorials. Please refer to the previous section for instructions on the installation of this script.

Material and instructions for specific exercise are listed in each section below (''only those using statgen-setup command are relevant to our docker based tutorials''). They provide links to materials and a minimal set of commands to use for launching and running an exercise.

==Alohomora==
* [http://statgen.us/files/tutorials/seqspark/Alohomora_Exercise_revised.pdf Exercise <nowiki>[PDF]</nowiki>]
* [https://statgen.research.bcm.edu/files/2016/10/data/alohomora.zip Data Set]
* [http://gmc.mdc-berlin.de/alohomora/ Software Link]

==Annovar complex traits==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/FunctionalAnnotation.pdf Functional Annotation Exercise <nowiki>[PDF]</nowiki>]
* [[Commands in Annotation Exercise|Exercise Commands]]

To run the exercise from docker image provided,

<pre>statgen-setup login --tutorial annovar
</pre>

==Annovar Mendelian traits==
* [http://statgen.us/files/tutorials/FunctionalAnnotation_Annovar_final.pdf Exercise <nowiki>[PDF]</nowiki>]
* [https://statgen.us/files/2017/09/commands/annovar-functional_annotation.txt Commands Part I - Functional Annotation]
* [https://statgen.us/files/2017/09/commands/annovar-variant_filtering.txt Commands Part II - Variant Filtering]

==Cochran Armitage Trend Test==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/Armitage_sample_size.pdf CATT Exercise <nowiki>[PDF]</nowiki>]



==Epistasis (PLINK and CASSI)==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/Epistasis_PLINK_CASSI.pdf Epistasis exercise <nowiki>[PDF]</nowiki>]

To run the exercise from docker image provided,

<pre>statgen-setup login --tutorial epistasis
</pre>


==FastLMM==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/FASTLMM.pdf FastLMM exercise <nowiki>[PDF]</nowiki>]

To run the exercise from docker image provided,

<pre>statgen-setup login --tutorial fastlmm-gcta
</pre>


==Fine-mapping (SuSiE method)==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/finemapping.docx susieR Exercise <nowiki>[DOCX]</nowiki>]
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/finemapping_answers.docx susieR Exercise Answers <nowiki>[DOCX]</nowiki>]
* [https://github.com/statgenetics/statgen-courses/blob/master/notebooks/finemapping.ipynb susieR Exercise Answers <nowiki>[Ipython notebook]</nowiki>]
* [https://github.com/statgenetics/statgen-courses/blob/master/notebooks/finemapping_answers.ipynb susieR Exercise Answers <nowiki>[Ipython notebook]</nowiki>]


To run the exercise from docker image provided,

<pre>statgen-setup launch --tutorial finemap
</pre>


==GCTA==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/GCTA.pdf GCTA exercise <nowiki>[PDF]</nowiki>]

To run the exercise from docker image provided,

<pre>statgen-setup login --tutorial fastlmm-gcta
</pre>


==Gemini==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/Gemini.docx Gemini exercise <nowiki>[DOCX]</nowiki>]

To run the exercise from docker image provided,

<pre>statgen-setup login --tutorial gemini
</pre>


==Genehunter==
* [http://statgen.us/files/tutorials/genehunter/Mult_Genehunter.pdf <nowiki>[PDF]</nowiki>]
* [[Genehunter Exercise|Exercise Commands]]


To install from packages, follow the configuration steps above and run the following command.

<pre>sudo apt-get install genehunter-tutorial</pre>
The exercise's files will then be installed in the folder ''/home/shared/genehunter''. You can run from there or copy the files into your user's home directory and proceed with the exercise.

==GWAS: Data Quality Control==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/PLINK_data_QC.pdf Exercise <nowiki>[PDF]</nowiki>]
* [[GWAS Data QC Exercise|Exercise Commands]]

To run the exercise from docker image provided,

<pre>statgen-setup login --tutorial plink
</pre>


==GWAS: Association Analysis Controlling for Population Substructure==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/PLINK_Substructure.pdf Exercise <nowiki>[PDF]</nowiki>]
* [[GWAS_Controlling_for_Population_Substructure|Exercise Commands]]

To run the exercise from docker image provided,

<pre>statgen-setup login --tutorial plink
</pre>


==Homozygosity Mapper==
* [http://statgen.us/files/tutorials/Homozygosity_mapping_exercise_part_1.pdf Exercise Part I]
* [http://statgen.us/files/tutorials/Homozygosity_mapping_exercise_part_2.pdf Exercise Part II]
* [http://www.homozygositymapper.org Data Sets]

==IGV==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/IGV.docx IGV exercise <nowiki>[DOCX]</nowiki>]
* [http://statgen.us/files/igv_exercise.zip Exercise files (VCF and BAM)]



==Linkage/FastLinkage==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/MLINK.pdf LINKAGE Exercise <nowiki>[DOCX]</nowiki>]


To run the exercise from docker image provided,

<pre>statgen-setup login --tutorial mlink
</pre>


==Pleiotropy==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/Pleiotropy.pdf Pleiotropy Exercise <nowiki>[PDF]</nowiki>]
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/Pleiotropy_answers.pdf Pleiotropy Answers to Questions <nowiki>[PDF]</nowiki>]

To run the exercise from docker image provided,

<pre>statgen-setup login --tutorial pleiotropy
</pre>


==Polygenic risk prediction (NPS method)==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/NPS.pdf PRS NPS Exercise <nowiki>[DOCX]</nowiki>]

To run the exercise from docker image provided,

<pre>statgen-setup login --tutorial nps
</pre>


==Polygenic risk prediction (LDpred2 method)==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/ldpred2_example.pdf PRS LDpred2 Exercise <nowiki>[PDF]</nowiki>]
* [https://github.com/cumc/bioworkflows/blob/master/ldpred/ldpred2_example.ipynb PRS LDpred2 Exercise <nowiki>[Ipython Notebook]</nowiki>]


To run the exercise from docker image provided,

<pre>statgen-setup launch --tutorial ldpred2
</pre>

Then follow prompts on the terminal output to open up the JupyterLab server in your web browser. If it is the first time you start this server, please open a command terminal inside JupyterLab, and type

<pre>get-data</pre>

to load the data-set to the JupyterLab workspace.


<!--
==Population Genetics==
* [http://statgen.us/files/tutorials/population/berlinseq.2.2.PopGen_exercise.pdf Population Exercise <nowiki>[PDF]</nowiki>]
* [http://statgen.us/files/tutorials/population/berlinseq.2.2.PopGen_answers.pdf Exercise Answers <nowiki>[PDF]</nowiki>]
* [http://statgen.us/files/tutorials/population/popgen_drift.q Commands for popgen_drift]
* [http://statgen.us/files/tutorials/population/popgen_selection.q Commands for popgen_selection]
-->
==Population Genetics==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/PopGen.docx Popgen Exercise <nowiki>[DOCX]</nowiki>]


To run the exercise from docker image provided,

<pre>statgen-setup login --tutorial popgen
</pre>


==PSEQ==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/PSEQ.pdf PSEQ Exercise <nowiki>[PDF]</nowiki>]
* [https://github.com/statgenetics/statgen-courses/blob/master/notebooks/PSEQ.ipynb PSEQ Exercise <nowiki>[Ipython Notebook]</nowiki>]

To run the exercise from docker image provided,

<pre>statgen-setup launch --tutorial pseq
</pre>

Notice that since PSEQ exercise does not involve generating and visualizing plots, it is also fine to use a command terminal, instead of the JupyterLab server, to run this exercise and reproduce exactly what was described in the tutorial. To do so,

<pre>statgen-setup login --tutorial pseq
</pre>

==REGENIE==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/regenie_example.pdf REGENIE Exercise <nowiki>[PDF]</nowiki>]
* [https://github.com/statgenetics/statgen-courses/blob/master/notebooks/regenie_example.ipynb REGENIE Exercise <nowiki>[Ipython Notebook]</nowiki>]


To run the exercise from docker image provided,

<pre>statgen-setup launch --tutorial regenie
</pre>

Then follow prompts on the terminal output to open up the JupyterLab server in your web browser. If it is the first time you start this server, please open a command terminal inside JupyterLab, and type

<pre>get-data</pre>

to load the data-set to the JupyterLab workspace.



==Regression==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/regression.docx Regression Exercise <nowiki>[DOCX]</nowiki>]
* [[Regression_Exercise|Exercise Commands]]

To run the exercise from docker image provided,

<pre>statgen-setup login --tutorial regression
</pre>


==RV-TDT==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/RV-TDT.doc Exercise <nowiki>[DOC]</nowiki>]
* [[RV-TDT|Exercise Commands]]

====Installing Packages====
To install from packages, follow the configuration steps above and run the following command.

<pre>sudo apt-get install rvtdt-tutorial</pre>
The exercise's files will then be installed in the folder ''/home/shared/rvtdt''. You can run from there or copy the files into your user's home directory and proceed with the exercise.

==SEQLinkage==
* [http://statgen.us/files/tutorials/SEQLinkage/SEQLinkage_revised_with_pg_numb.pdf SEQLinkage Exercise <nowiki>[PDF]</nowiki>]
* [[SEQLinkage_Commands_in_Exercise|Exercise Commands]]


To install from packages, follow the configuration steps above and run the following command.

<pre>sudo apt-get install seqlinkage-tutorial</pre>
The exercise's files will then be installed in the folder ''/home/shared/seqlinkage''. You can run from there or copy the files into your user's home directory and proceed with the exercise.

==SEQSpark==
* [http://statgen.us/files/tutorials/seqspark/SEQSpark_exercise_Final_v4.pdf SEQSpark Exercise <nowiki>[PDF]</nowiki>]
* [[SEQSpark|Exercise Commands]]
* [http://statgen.us/files/images/SEQSpark.ova Virtual Machine Image]

====Installing Packages====
To install from packages, follow the configuration steps above and run the following command.

<pre>sudo apt-get install seqspark-tutorial</pre>
The exercise's files will then be installed in the folder ''/home/shared/seqspark''. You can run from there or copy the files into your user's home directory and proceed with the exercise.In order for the
commands to work correctly, you don't need to reboot, but you should log out and log back in to make sure that the computer's environment is correctly configured.

==SLINK==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/Slink.doc SLINK Exercise <nowiki>[DOCX]</nowiki>]

To run the exercise from docker image provided,

<pre>statgen-setup login --tutorial slink</pre>

==SUPERLINK==
* [http://statgen.us/files/tutorials/Superlink_Exercise_v2.pdf SUPERLINK Exercise <nowiki>[PDF]</nowiki>]
* [https://statgen.research.bcm.edu/files/2016/10/data/superlink.zip Superlink]

==Variant Association Tools==
* [https://github.com/statgenetics/statgen-courses/blob/master/handout/VAT.docx VAT Exercise <nowiki>[DOCX]</nowiki>]
* [https://github.com/statgenetics/statgen-courses/blob/master/notebooks/VAT.ipynb VAT Exercise <nowiki>[Ipython notebook]</nowiki>]


To run the exercise from docker image provided,

<pre>statgen-setup launch --tutorial vat
</pre>

Then follow the prompts on the terminal output to open up the JupyterLab server in your web browser. You should find the exercise notebook in the side panel, and you can click to open it.