Changes

From Statistical Genetics Courses

Jump to: navigation, search

Tutorials

460 bytes added, 02:57, 22 February 2020
==Running Tutorials on Your Computer==
We have Since Fall 2019 we adopted [https://www.docker.com/ docker] to run our course material since Fall 2019. 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) for your own data analysis. In this section we will discuss how to set it up and run course materials on your computer, using these docker images and optionally a utility script we created to streamline various docker commands.
===Pre-requisites===
====Mac and Linux users====
<code>SoS</code> requires Python 3.6+ to run. It is recommended that you install [https://docs.conda.io/en/latest/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</code> to install <code>SoS</code>, or, check out [https://vatlab.github.io/sos-docs/running.html here for alternative installation methods] if you have troubles with that command. To install <code>docker</code> 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.
To install <code>docker</code> please follow our instruction [http://statgen.us/lab-wiki/orientation/jupyter-setup.html#install-docker here].  Additionally Finally please download our utility script [https://raw.githubusercontent.com/statgenetics/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>. To verify your setup, type:
<pre>statgen-setup -h</pre>
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 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 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 our [https://github.com/statgenetics/statgen-courses/blob/master/README.md complete documentation to the utility script here].
==Alohomora==