Changes

We have created a debian repository to make it easier to use our tutorialsStarting Fall 2019 we adopt [https://www. This repository allows you to install all required software and example data included in tutorials on your computerdocker. Using this repository will require that you have administrator access com/ docker] to a computer with Linux Systemrun our course material . If you don't We have this level of access or your computer running non-Linux systems (Windows or OS), you have two options. First, you could install the repository on a remote cloud serve, such as created various [https://wwwhub.vultrdocker.com/ VULTRu/statisticalgenetics docker repositories]. Second, you can install a Virtual Machine program (such as with source material freely available from [https://wwwgithub.virtualbox.orgcom/ VirtualBoxstatgenetics/statgen-courses github]) on your computer, for users to readily setup and then load reproduce our pre-configured virtual machine image (VM Image) into the Virtual Machinetutorials on their own computers. You These docker images can refer also be used as production tool to these online videos [[VirtualBox Installation|here]] to install VirtualBox run relevant software on your computer(Mac, Linux or Windows) for your own data analysis.

The VM Image is available [https://statgen.research.bcm.edu/files/images/Statgen.ova here]. The password for the student account is "LetMeIn". Feel free In this document we will focus on discussing how to change set it up and run course tutorials on your computer, using these docker images and optionally a utility script we created to whatever you likestreamline various docker commands.

To ===Pre-requisites===Software you need to install the repository on the cloud server, virtual machine, or your own computer, you need are <code>SoS</code> (a workflow system to follow these configuration steps. Please run as the root user or using the sudo commandour course utility script) and <code>docker</code>.

====Mac and Linux users====<precode>echo "deb SoS</code> requires Python 3.6+ to run. It is recommended that you install [trusted=yes] https://statgendocs.researchconda.bcm.eduio/en/latest/deb miniconda.html Miniconda] to run Python 3 if you don't have it already. Once you have Python 3 installed, simply type <code>pip install sos</" | sudo tee -a code> to install <code>SoS</etccode>, or, check out [https:/apt/sourcesvatlab.listgithub.dio/statgen.listsudo add-aptsos-repository -y ppa:webupd8teamdocs/javasudo apt-get updaterunning.html here for alternative installation methods] if you have troubles with that command. To install <code>docker</precode>from command line please follow our instructions [http://statgen.us/lab-wiki/orientation/jupyter-setup.html#install-docker here]. Alternatively Mac users can download docker app for Mac and install from a graphical interface.

We have made a video tutorial to show you how to install the repository step by step which is available Finally please download our utility script [https://wwwraw.youtubegithubusercontent.com/watch?v=5jRJHXxkC9g&t=19s herestatgenetics/statgen-courses/master/src/statgen-setup <code>src/statgen-setup</code>]to your <code>PATH</code> and change it to executable, eg, <code>chmod +x ~/bin/statgen-setup</code> if you put it under <code>~/bin</code> which is part of your <code>PATH</code>. If To verify your setup, type: <pre>statgen-setup -h</pre>you want should see some meaningful output. ====Windows users====Running these tutorials in Windows is currently not supported. Although in principle these docker images will also work in Windows, this has not yet been tested out and we are unable to install provide sure instructions to setting it up. The utility script "statgen-setup" that we provide will certainly need adjustments (though minor) to work with Windows. ===Tutorial specific instructions===Material and instructions for specific exercise at your demands, please refer to commands 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. For advanced options and other features provided by our utility script please read here our [https://github.com/statgenetics/statgen-courses/blob/master/README.md complete documentation to the utility script].

* [httphttps://statgengithub.uscom/filesstatgenetics/tutorials/functionalstatgen-annotationcourses/blob/master/handout/FunctionalAnnotation_exercise_2018v2FunctionalAnnotation.pdf docx Functional Annotation Exercise <nowiki>[PDFDOCX]</nowiki>]

To install run the exercise from packagesdocker image provided, follow the configuration steps above and run the following command. <pre>statgen-setup login --tutorial annovar</pre>

<pre>sudo aptThe "statgen-get install annotationsetup" script is available [https://github.com/statgenetics/statgen-tutorial<courses/pre>The exercise's files will then blob/master/src/statgen-setup here] and can be installed in the folder ''following [https:/home/sharedgithub.com/functional_annotation''statgenetics/statgen-courses/blob/master/README. You can run from there or copy the files into md#prepare-your user's home directory and proceed with -computer-to-manage-the exercise-tutorials these instructions].

* [httphttps://statgengithub.uscom/statgenetics/statgen-courses/blob/filesmaster/tutorialshandout/Armitage_sample_size_Berlin_1Armitage_sample_size.pdf CATT Exercise <nowiki>[PDF]</nowiki>]

==Epistasis (PLINK and CASSI)==Result Files* [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> The "statgen-setup" script is available [https://github.com/statgenetics/statgen-courses/blob/master/src/statgen-setup here] and can be installed following [https://github.com/statgenetics/statgen-courses/blob/master/README.md#prepare-your-computer-to-manage-the-tutorials these instructions].   ==FastLMM==:* [httphttps://github.com/statgenetics/statgen-courses/blob/master/handout/FASTLMM.uspdf FastLMM exercise <nowiki>[PDF]</filesnowiki>] To run the exercise from docker image provided, <pre>statgen-setup login --tutorial fastlmm-gcta</2016pre> The "statgen-setup" script is available [https:/07/gatk_resultsgithub.tarcom/statgenetics/statgen-courses/blob/master/src/statgen-setup here] and can be installed following [https://github.gz GATKcom/IGV statgenetics/statgen-courses/blob/master/README.md#prepare-your-computer-to-manage-the-tutorials these instructions]. ==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> The "statgen-setup" script is available [https://github.com/statgenetics/statgen-courses/blob/master/src/statgen-setup here] and can be installed following [https://github.com/statgenetics/statgen-courses/blob/master/README.md#prepare-your-computer-to-manage-the-tutorials these instructions].

* [https://drive.googlegithub.com/filestatgenetics/dstatgen-courses/0B2pJ9cgevF3sTS1DeGxYalFTN00blob/view Bam files for master/handout/Gemini.docx Gemini exercise<nowiki>[DOCX]</nowiki>]

==GenABEL==To run the exercise from docker image provided,* <pre>statgen-setup login --tutorial gemini</pre> The "statgen-setup" script is available [httphttps://statgengithub.uscom/filesstatgenetics/tutorialsstatgen-courses/genabelblob/GenABEL_with_PLINK1.9.pdf GenABEL Exercise <nowiki>[PDF]<master/nowiki>src/statgen-setup here]* and can be installed following [[GeneABEL Exercise|Exercise Commands]https://github.com/statgenetics/statgen-courses/blob/master/README.md#prepare-your-computer-to-manage-the-tutorials these instructions].

* [httphttps://statgengithub.uscom/filesstatgenetics/tutorials/gwasstatgen-qccourses/blob/master/handout/PLINK_data_QC.pdf docx Exercise <nowiki>[PDF]</nowiki>]

====Installing Packages====To install run the exercise from packagesdocker image provided, follow the configuration steps above  <pre>statgen-setup login --tutorial plink</pre> The "statgen-setup" script is available [https://github.com/statgenetics/statgen-courses/blob/master/src/statgen-setup here] and run the can be installed following command[https://github.com/statgenetics/statgen-courses/blob/master/README.md#prepare-your-computer-to-manage-the-tutorials these instructions]. 

* [httphttps://statgengithub.uscom/filesstatgenetics/tutorials/gwasstatgen-substructurecourses/blob/master/handout/GWAS_Data_Controlling_for_SubstructurePLINK_Substructure.pdf docx Exercise <nowiki>[PDF]</nowiki>]

====Installing Packages====To install run the exercise from packagesdocker image provided, follow the configuration steps above and run the following command.

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

The "statgen-setup" script is available [https://github.com/statgenetics/statgen-courses/blob/master/src/statgen-setup here] and can be installed following [https://github.com/statgenetics/statgen-courses/blob/master/README.md#prepare-your-computer-to-manage-the-tutorials these instructions].   ==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)] To run the exercise from docker image provided, <pre>statgen-setup login --tutorial igv</pre>

==IGV== *The "statgen-setup" script is available [https://statgen.research.bcmgithub.educom/filesstatgenetics/softwarestatgen-courses/igvblob/igvmaster/src/statgen-2.3.97.jar igv.jar Software Linksetup here]*and can be installed following [https://statgen.researchgithub.bcm.educom/filesstatgenetics/2017statgen-courses/09blob/datamaster/igv_exerciseREADME.zip BAM and VCF Filesmd#prepare-your-computer-to-manage-the-tutorials these instructions].

* [httphttps://github.com/statgenetics/statgen-courses/blob/master/handout/MLINK.uspdf LINKAGE Exercise <nowiki>[DOCX]</filesnowiki>]  To run the exercise from docker image provided, <pre>statgen-setup login --tutorial mlink</pre> The "statgen-setup" script is available [https://github.com/statgenetics/statgen-courses/blob/master/src/statgen-setup here] and can be installed following [https://github.com/statgenetics/statgen-courses/blob/master/README.md#prepare-your-computer-to-manage-the-tutorialsthese instructions]. ==Pleiotropy==* [https:/SEQLinkage/linkage_intro_ex_berlin_2018_with_pg_numgithub.pdf Linkage Introduction com/statgenetics/statgen-courses/blob/master/handout/Pleiotropy.docx Pleiotropy Exercise <nowiki>[PDFDOCX]</nowiki>]* [https://github.com/statgenetics/statgen-courses/blob/master/handout/Pleiotropy_answers.docx Pleiotropy Answers to Questions <nowiki>[DOCX]</nowiki>] To run the exercise from docker image provided, <pre>statgen-setup login --tutorial pleiotropy</pre> The "statgen-setup" script is available [https://github.com/statgenetics/statgen-courses/blob/master/src/statgen-setup here] and can be installed following [https://github.com/statgenetics/statgen-courses/blob/master/README.md#prepare-your-computer-to-manage-the-tutorials these instructions]. ==Polygenic risk prediction (NPS method)==* [https://github.com/statgenetics/statgen-courses/blob/master/handout/NPS.docx PRS NPS Exercise <nowiki>[DOCX]</nowiki>] To run the exercise from docker image provided, <pre>statgen-setup login --tutorial nps</pre> The "statgen-setup" script is available [https://github.com/statgenetics/statgen-courses/blob/master/src/statgen-setup here] and can be installed following [https://github.com/statgenetics/statgen-courses/blob/master/README.md#prepare-your-computer-to-manage-the-tutorials these instructions].

* [httphttps://statgengithub.uscom/filesstatgenetics/tutorialsstatgen-courses/populationblob/Popgen_exe_ansmaster/handout/PopGen.pdf docx Popgen Exercise <nowiki>[PDFDOCX]</nowiki>]*  To run the exercise from docker image provided, <pre>statgen-setup login --tutorial popgen</pre> The "statgen-setup" script is available [httphttps://statgengithub.uscom/filesstatgenetics/tutorialsstatgen-courses/populationblob/popgen_drift.q R Script for popgen_driftmaster/src/statgen-setup here]* and can be installed following [httphttps://statgengithub.uscom/filesstatgenetics/tutorialsstatgen-courses/populationblob/popgen_selectionmaster/README.q R Script for popgen_selectionmd#prepare-your-computer-to-manage-the-tutorials these instructions].

* [httphttps://statgengithub.uscom/filesstatgenetics/tutorialsstatgen-courses/pseqblob/PSEQ_exercisemaster/handout/PSEQ.pdf doc PSEQ Exercise <nowiki>[PDFDOCX]</nowiki>]

To install run the exercise from packagesdocker image provided, follow the configuration steps above and run the following command.

<pre>sudo aptstatgen-setup login -get install plinkseq-tutorialpseq</pre> The exercise's files will then "statgen-setup" script is available [https://github.com/statgenetics/statgen-courses/blob/master/src/statgen-setup here] and can be installed in the folder ''following [https:/home/sharedgithub.com/pseq''statgenetics/statgen-courses/blob/master/README. You can run from there or copy the files into md#prepare-your user's home directory and proceed with -computer-to-manage-the exercise-tutorials these instructions].

* [httphttps://statgengithub.uscom/statgenetics/statgen-courses/blob/filesmaster/tutorialshandout/regression_exerciseregression.pdf docx Regression Exercise <nowiki>[PDFDOCX]</nowiki>]

To install run the exercise from packagesdocker image provided, follow the configuration steps above and run the following command. <pre>statgen-setup login --tutorial regression</pre>

<pre>sudo aptThe "statgen-get install regressionsetup" script is available [https://github.com/statgenetics/statgen-tutorial<courses/pre>The exercise's files will then blob/master/src/statgen-setup here] and can be installed in the folder ''following [https:/home/sharedgithub.com/regression''statgenetics/statgen-courses/blob/master/README. You can run from there or copy the files into md#prepare-your user's home directory and proceed with -computer-to-manage-the exercise-tutorials these instructions].

* [httphttps://statgengithub.uscom/statgenetics/statgen-courses/filesblob/tutorialsmaster/rvtdthandout/rvtdt_exerciseRV-TDT.pdf doc Exercise <nowiki>[PDFDOC]</nowiki>]

* [httphttps://statgengithub.uscom/filesstatgenetics/tutorialsstatgen-courses/blob/master/seqsparkhandout/slink_ex_shortSlink.pdf doc SLINK Exercise <nowiki>[PDFDOCX]</nowiki>] To run the exercise from docker image provided, <pre>statgen-setup login --tutorial slink</pre> The "statgen-setup" script is available [https://github.com/statgenetics/statgen-courses/blob/master/src/statgen-setup here] and can be installed following [https://github.com/statgenetics/statgen-courses/blob/master/README.md#prepare-your-computer-to-manage-the-tutorials these instructions].  

* [httphttps://statgenstatgenetics.usgithub.io/filesstatgen-courses/tutorialsnotebooks/VAT_exercise_2018_nographsVAT.pdf html VAT Exercise <nowiki>[PDFHTML]</nowiki>]

To run the exercise from docker image provided, <pre>sudo aptstatgen-setup login -get install vtools-tutorialvat</pre>The exercise's files will then be installed in the folder ''/home/shared/vat''. You can run from there or copy the files into your user's home directory and proceed with the exercise.

==VAT Mendelian==* The "statgen-setup" script is available [httphttps://statgengithub.uscom/filesstatgenetics/tutorialsstatgen-courses/VAT_Mendelian.pdf Exercise <nowiki>[PDF]<blob/nowiki>master/src/statgen-setup here]* and can be installed following [[VAT mendelian commands|Exercise Commands]https://github.com/statgenetics/statgen-courses/blob/master/README.md#prepare-your-computer-to-manage-the-tutorials these instructions].