Difference between revisions of "Tutorials"

From Statistical Genetics Courses

Jump to: navigation, search
(Tutorials for Courses)
Line 2: Line 2:
 
* <s>[[Tutorials#Annotation|ANNOVAR Annotation]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/annovar.dockerfile dockefile] and [https://hub.docker.com/r/statisticalgenetics/annovar/tags docker image]</s>
 
* <s>[[Tutorials#Annotation|ANNOVAR Annotation]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/annovar.dockerfile dockefile] and [https://hub.docker.com/r/statisticalgenetics/annovar/tags docker image]</s>
 
* <s>[[Tutorials#Cochran_Armitage_Trend_Test|Cochran Armitage Trend Test for GWAS power analysis]]</s>
 
* <s>[[Tutorials#Cochran_Armitage_Trend_Test|Cochran Armitage Trend Test for GWAS power analysis]]</s>
* [[Tutorials#FastLMM | Family-based Association using FaST-LMM, PLINK and R]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/fastlmm-gcta.dockerfile dockefile] and [https://hub.docker.com/r/statisticalgenetics/fastlmm-gcta/tags docker image]
+
* <s>[[Tutorials#FastLMM | Family-based Association using FaST-LMM, PLINK and R]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/fastlmm-gcta.dockerfile dockefile] and [https://hub.docker.com/r/statisticalgenetics/fastlmm-gcta/tags docker image]</s>
 
* <s>[[Tutorials#IGV|IGV]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/igv.dockerfile dockerfile] and [https://hub.docker.com/r/statisticalgenetics/igv/tags docker image]</s>
 
* <s>[[Tutorials#IGV|IGV]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/igv.dockerfile dockerfile] and [https://hub.docker.com/r/statisticalgenetics/igv/tags docker image]</s>
 
* <s>[[Tutorials#Gemini|Gemini]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/gemini.dockerfile dockerfile] and [https://hub.docker.com/r/statisticalgenetics/gemini/tags docker image]</s>
 
* <s>[[Tutorials#Gemini|Gemini]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/gemini.dockerfile dockerfile] and [https://hub.docker.com/r/statisticalgenetics/gemini/tags docker image]</s>
* [[Tutorials#GCTA|GCTA]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/fastlmm-gcta.dockerfile dockefile] and [https://hub.docker.com/r/statisticalgenetics/fastlmm-gcta/tags docker image]
+
* <s>[[Tutorials#Fast-LMM & GCTA | Fast-LMM & GCTA]] | [ exercise] and [https://hub.docker.com/r/statisticalgenetics/fastlmm-gcta/tags docker image]</s>
* [[Tutorials#GWAS:_Data_Quality_Control|GWAS: QC]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/plink.dockerfile dockerfile] and [https://hub.docker.com/r/statisticalgenetics/plink/tags docker image]
+
* [[Tutorials#GWAS:_Data_Quality_Control|GWAS: QC]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/plink.dockerfile dockerfile] and [https://hub.docker.com/r/statisticalgenetics/fastlmm-gcta docker image]
 
* [[Tutorials#GWAS:_Association_Analysis_Controlling_for_Population_Substructure|GWAS: Controlling for Population Substructure]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/plink.dockerfile dockerfile] and [https://hub.docker.com/r/statisticalgenetics/plink/tags docker image]
 
* [[Tutorials#GWAS:_Association_Analysis_Controlling_for_Population_Substructure|GWAS: Controlling for Population Substructure]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/plink.dockerfile dockerfile] and [https://hub.docker.com/r/statisticalgenetics/plink/tags docker image]
 
* Mendelian Randomization | docker image and exercise
 
* Mendelian Randomization | docker image and exercise
Line 23: Line 23:
 
* <s>[[Tutorials#Variant_Association_Tools|Variant Association Tools]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/vat.dockerfile dockerfile] and [https://hub.docker.com/r/statisticalgenetics/vat/tags docker image]</s>
 
* <s>[[Tutorials#Variant_Association_Tools|Variant Association Tools]] | [https://github.com/statgenetics/statgen-courses/blob/master/docker/vat.dockerfile dockerfile] and [https://hub.docker.com/r/statisticalgenetics/vat/tags docker image]</s>
  
<!---
 
 
==[[Genetic Meetings of Interest]]==
 
[[NGSMendelian2017|Identifying Genes for Mendelian Traits using Next Generation Sequence Data]], September 18-22, 2017<br />Max Delbrück Center for Molecular Medicine<br />Berlin, Germany
 
 
[[Genassoc2017|Genetic Association Course With Application to Sequence and Genotype Data]], June 26-30, 2017<br />Max Delbrück Center for Molecular Medicine<br />Berlin, Germany
 
 
[[ComplexNGS2017|Complex Trait Analysis of Next Generation Sequence Data]], March 6-10, 2017 <br />Max Delbrück Center for Molecular Medicine<br />Berlin, Germany
 
 
[[Advgenemap2017|Advanced Gene Mapping Course]], January 23-27, 2017 <br /> The Rockefeller University, New York
 
 
[[NGSMendelian2016|Identifying Genes for Mendelian Traits using Next Generation Sequence Data]], October 31-November 4, 2016<br />Max Delbrück Center for Molecular Medicine<br />Berlin, Germany
 
 
[[Genassoc2016|Genetic Association Course With Application to Sequence and Genotype Data]], September 5-9, 2016<br />Max Delbrück Center for Molecular Medicine<br />Berlin, Germany
 
 
[[ComplexNGS2016|Complex Trait Analysis of Next Generation Sequence Data]], July 4-8, 2016 <br />Max Delbrück Center for Molecular Medicine<br />Berlin, Germany
 
 
[[Advgenemap2016|Advanced Gene Mapping Course]], January 25-29, 2016 <br /> The Rockefeller University, New York
 
 
[https://www.bcm.edu/research/labs/center-for-statistical-genetics/courses/ngs-mendelian-course-sept-oct-2015 Identifying Genes for Mendelian Traits using Next Generation Sequence Data,] Sept. 28-Oct. 2, 2015<br />Max Delbrück Center (MDC) for Molecular Medicine<br />Berlin, Germany
 
 
[https://www.bcm.edu/research/labs/center-for-statistical-genetics/courses/genetic-association-course-june-2015 Genetic Association Course With Application to Sequence and Genotype Data], June 22-26, 2015<br />Max Delbrück Center for Molecular Medicine<br />Berlin, Germany
 
 
[[2015MarchMDC|Complex Trait Analysis of Next Generation Sequence Data]], March 23-27, 2015<br />Max Delbrück Center for Molecular Medicine<br />Berlin, Germany
 
 
[[2015AdvancedGeneMapping|Advanced Gene Mapping Course]], Feb. 9-13, 2015 <br />The Rockefeller University, New York 
 
 
[https://www.bcm.edu/research/labs/center-for-statistical-genetics/courses/next-generation-sequence-data-course-jun-2014 Analysis of Next Generation Sequence Data Course,]June 23-27, 2014<br />Max Delbrück Center for Molecular Medicine<br />Berlin, Germany
 
 
[https://www.bcm.edu/research/labs/center-for-statistical-genetics/courses/genetic-association-course-march-2014 Genetic Association Course], March 3-7, 2014<br />Max Delbrück Center for Molecular Medicine<br />Berlin, Germany
 
 
[https://www.bcm.edu/research/labs/center-for-statistical-genetics/courses/advanced-gene-mapping-course-jan-2014 Advanced Gene Mapping Course], Jan. 27-31, 2014<br />The Rockefeller University<br />New York, NY
 
 
[https://www.bcm.edu/research/labs/center-for-statistical-genetics/courses/genetic-association-course-june-2013 Genetic Association Course], June 3-7, 2013<br />With Application to Analysis of Sequence and Genotype Data<br />Max Delbrück Center for Molecular Medicine<br />Berlin, Germany
 
 
[https://www.bcm.edu/research/labs/center-for-statistical-genetics/courses/advanced-gene-mapping-course-jan-2013 Advanced Gene Mapping Course], Jan. 28 -Feb. 1, 2013<br />The Rockefeller University<br />New York, NY
 
 
[http://linkage.rockefeller.edu/suzanne/Berlin_Basic_Gene_Mapping_Course_2012.htm Basic Gene Mapping Course], Nov. 26-30, 2012<br />Max Delbrück Center for Molecular Medicine<br />Berlin, Germany
 
 
[http://linkage.rockefeller.edu/suzanne/Berlin_Genetic_Association_Course_2012.html Genetic Association Course], July 23-27, 2012<br />Max Delbrück Center for Molecular Medicine<br />Berlin, Germany
 
 
[http://linkage.rockefeller.edu/suzanne/advanced_course_Jan_12 Advanced Gene Mapping Course], Jan. 16-20, 2012<br />The Rockefeller University<br />New York, NY
 
 
[http://linkage.rockefeller.edu/suzanne/Berlin_Basic_Gene_Mapping_Course_2011.htm Basic Gene Mapping Course], Nov. 7-11, 2011<br />Max Delbrück Center (MDC) for Molecular Medicine<br />Berlin, Germany
 
 
[http://linkage.rockefeller.edu/suzanne/Berlin_Genetic_Association_Course_2011.html Genetic Association Course], July 4-8, 2011<br />Max Delbrück Center (MDC) for Molecular Medicine<br />Berlin, Germany
 
 
[http://linkage.rockefeller.edu/suzanne/BCM_Association_Course_2011.html Genetic Association Course], March 22-25, 2011<br />Center for Statistical Genetics<br />Baylor College of Medicine<br />Houston, TX
 
 
[https://www.bcm.edu/research/labs/center-for-statistical-genetics/courses/advanced-gene-mapping-course-dec-2010 Advanced Gene Mapping Course], Dec. 13-17, 2010<br />The Rockefeller University <br />New York, NY
 
 
[http://linkage.rockefeller.edu/suzanne/MDC_Berlin_Basic_Gene_Mapping_Course_2010.htm Basic Gene Mapping Course], Oct. 25-29, 2010<br />Max Delbrück Center (MDC) for Molecular Medicine<br />Berlin, Germany
 
 
[http://linkage.rockefeller.edu/suzanne/MDC_Berlin_Association_Course_2010.html Genetic Association Course], May 3-7, 2010<br />Max Delbrück Center (MDC) for Molecular Medicine<br />Berlin, Germany
 
-->
 
 
==Genetic Analysis Software==
 
More information about the software used in the previous courses can be found here https://gaow.github.io/genetic-analysis-software/0/
 
  
 +
== ==
 
==Running Tutorials on Your Computer==
 
==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.
+
We adopt [https://www.docker.com/ docker] to run our course material, and we have created various [https://hub.docker.com/u/statisticalgenetics docker repositories] with freely available Docker images for users to readily run our exercises on their own computers using [https://docs.docker.com/desktop/ Docker Desktop]. These docker images are for multi-platform use (Mac, Windows, or Linux). More information regarding instructions to install Docker Desktop and to run the course material on your computer is detailed in the documentation below. 
  
 
===General instructions===
 
===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#alternative-to-cloud-server-use-your-own-computer Instructions to install Docker Desktop and running the course material on your computer]<br /><br />
* [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]
+
  
 
===Preparing Your Computer===
 
===Preparing Your Computer===
Line 106: Line 47:
 
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. Command "statgen-setup login" will allow you to start and login to a Linux command line environment (regardless of your current computational environment) to perform all analysis in command shells. This works for all the tutorials on this page. Additionally, some tutorials support command "statgen-setup launch" which will start a JupyterLab server to perform the analysis.
 
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. Command "statgen-setup login" will allow you to start and login to a Linux command line environment (regardless of your current computational environment) to perform all analysis in command shells. This works for all the tutorials on this page. Additionally, some tutorials support command "statgen-setup launch" which will start a JupyterLab server to perform the analysis.
  
==Alohomora==
 
* [http://statgen.us/files/tutorials/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
+
==FastLMM & GCTA==
</pre>
+
* [file:///https://statgen.us/files/fastlmm_gcta_exercise.pdf FastLMM & GCTA exercise ]
 +
* [https://hub.docker.com/r/statisticalgenetics/fastlmm-gcta FastLMM & GCTA docker image]
 +
To pull and download the docker image from the Docker Hub repository,
  
 +
<pre>docker pull statisticalgenetics/fastlmm-gcta</pre>
 +
To run the exercise from the downloaded docker image,
  
 +
<pre>docker run --rm -p 8888:8888 statisticalgenetics/fastlmm-gcta</pre>
 
==Fine-mapping (SuSiE method)==
 
==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.docx susieR Exercise <nowiki>[DOCX]</nowiki>]

Revision as of 18:05, 17 August 2026

Tutorials for Courses


 

Running Tutorials on Your Computer

We adopt docker to run our course material, and we have created various docker repositories with freely available Docker images for users to readily run our exercises on their own computers using Docker Desktop. These docker images are for multi-platform use (Mac, Windows, or Linux). More information regarding instructions to install Docker Desktop and to run the course material on your computer is detailed in the documentation below. 

General instructions

Preparing Your Computer

Linux
Mac
Windows

Running Exercises

Tutorial specific instructions

We use a script "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. Command "statgen-setup login" will allow you to start and login to a Linux command line environment (regardless of your current computational environment) to perform all analysis in command shells. This works for all the tutorials on this page. Additionally, some tutorials support command "statgen-setup launch" which will start a JupyterLab server to perform the analysis.


FastLMM & GCTA

To pull and download the docker image from the Docker Hub repository,

docker pull statisticalgenetics/fastlmm-gcta

To run the exercise from the downloaded docker image,

docker run --rm -p 8888:8888 statisticalgenetics/fastlmm-gcta

Fine-mapping (SuSiE method)


To run the exercise from docker image provided,

statgen-setup launch --tutorial finemap

GCTA

To run the exercise from docker image provided,

statgen-setup login --tutorial fastlmm-gcta


Gemini

To run the exercise from docker image provided,

statgen-setup login --tutorial gemini


Genehunter


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

sudo apt-get install genehunter-tutorial

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

To run the exercise via JupyterLab from docker image provided,

statgen-setup launch --tutorial plink

Alternatively, you can opt to run the exercise via command terminal from docker image provided,

statgen-setup login --tutorial plink

GWAS: Association Analysis Controlling for Population Substructure

To run the exercise via JupyterLab from docker image provided,

statgen-setup launch --tutorial plink

Alternatively, you can opt to run the exercise via command terminal from docker image provided,

statgen-setup login --tutorial plink

Homozygosity Mapper

IGV


Linkage/FastLinkage


To run the exercise from docker image provided,

statgen-setup login --tutorial mlink

LD clumping


To run the exercise from docker image provided,

statgen-setup launch --tutorial clumping

MR-JTI for TWAS


To run the exercise from docker image provided,

statgen-setup launch --tutorial twas

Pleiotropy

To run the exercise from docker image provided,

statgen-setup login --tutorial pleiotropy


Polygenic risk prediction (NPS method)

To run the exercise from docker image provided,

statgen-setup login --tutorial nps


Polygenic risk prediction (LDpred2 method)


To run the exercise from docker image provided,

statgen-setup launch --tutorial ldpred2

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

get-data

to load the data-set to the JupyterLab workspace.


Population Genetics


To run the exercise from docker image provided,

statgen-setup login --tutorial popgen


PSEQ

To run the exercise from docker image provided,

statgen-setup launch --tutorial pseq

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,

statgen-setup login --tutorial pseq


R and PLINK

To run the exercise from docker image provided,

statgen-setup launch --tutorial plink-r-nothnagel


REGENIE


To run the exercise from docker image provided,

statgen-setup launch --tutorial regenie

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

get-data

to load the data-set to the JupyterLab workspace.


Regression

To run the exercise from docker image provided,

statgen-setup login --tutorial regression


RV-TDT

Installing Packages

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

sudo apt-get install rvtdt-tutorial

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


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

sudo apt-get install seqlinkage-tutorial

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

Installing Packages

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

sudo apt-get install seqspark-tutorial

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

To run the exercise from docker image provided,

statgen-setup login --tutorial slink

SUPERLINK

Variant Association Tools


To run the exercise from docker image provided,

statgen-setup launch --tutorial vat

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.