Pre-course Instructions

Please follow these instructions to download all programs and data for the course. You will require ~1GB of space to install all programs and data.

Please create a new folder in which you will keep all the course materials and scripts (e.g., something like /Users/yourname/Documents/Workshop/ in Mac or Linux, or D:/Workshop/ in Windows).


Data and Scripts

Please download all data and scripts required for this course by clicking the following link (Note, the file size is ~ MB) and saving all the data and scripts contained in a folder on your computer.

Download Data and Scripts

Download Advanced Data and Scripts

Download Advanced Data and Scripts 2



Programs and software

Mac and Linux users

The easiest method for downloading all the software required for the workshop is to first download Miniconda.

Mac users, please follow these instructions:

  1. Open the Terminal.

  2. Enter the following code:
  3. # Download and install Miniconda
    wget https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -O ~/miniconda.sh
    bash ~/miniconda.sh -b -p $HOME/miniconda
    
    # Follow prompts, then restart terminal
    

Linux users, please follow these instructions:

  1. Open the Terminal.

  2. Enter the following code:
  3. # Download and install Miniconda
    wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda.sh
    bash ~/miniconda.sh -b -p $HOME/miniconda
    
    # Follow prompts, then restart terminal
    

Both Mac and Linux users:

Following the link to download the scripts above, you should have downloaded three scripts: Install_programs.sh, workshop_env.yml, and install_r_github.R.

These are the three scripts required to download all the programs required for the workshop.

  1. Open your terminal again.

  2. Navigate to the folder where you downloaded the scripts and data (e.g., /Users/yourname/Documents/workshop/):
  3. cd /Users/yourname/Documents/workshop/
    
  4. Run the following command:
  5. bash Install_programs.sh
    

    This may take up to 30 minutes, and you should now have a Conda environment called bioinfo-workshop and can run all the analysis from there.

  6. To activate the environment, run:
  7. source "$HOME/miniconda/etc/profile.d/conda.sh"
    conda activate bioinfo-workshop
    

Windows users

For Windows users, it's a bit more involved to install Miniconda.

    First, install WSL (Windows Subsystem for Linux)

  1. Open PowerShell as Administrator and run:
  2. wsl --install
    

    This will:


  3. Restart your computer when prompted.
  4. Set up Ubuntu in WSL

  5. After reboot, Ubuntu should open automatically. If not, open the WSL app manually. Wait for installation to complete, then choose a username and password when prompted. This opens a Linux terminal (Ubuntu shell).
  6. Install Miniconda inside WSL

  7. Enter the following commands to install Miniconda in WSL
  8. wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O miniconda.sh
    bash miniconda.sh
    
  9. Accept the license agreement and confirm the default install location (e.g., /home/yourname/miniconda).
  10. You may get another prompt after this. Please type "no".

  11. When installation finishes, close and reopen WSL, or run:
  12. source ~/.bashrc
    

    Export Conda into your path with:

    export PATH=~/miniconda3/bin:$PATH
    
  13. Check that Conda is available:
  14. conda --version
    

    Move Setup Scripts Into WSL

  15. Place the files (Install_programs.sh, workshop_env.yml, install_r_github.R) in a folder on Windows, e.g., D:/Workshop/.

  16. In the Ubuntu terminal, navigate to that folder:
  17. cd /mnt/d/Workshop/
    

    Run the install script for Windows:

  18. Enter the following command to set up a Conda environment and install programs usign Conda:
  19. bash Install_programs_windows.sh
    

    After up to 30 minutes, you should have a Conda environment called bioinfo-workshop set up and ready.

  20. To activate it type:
  21. source ~/miniconda3/etc/profile.d/conda.sh 
    conda activate bioinfo-workshop
    

Windows users with ARM64 (alternative with Virtual Box)

Windows users with ARM64 operating systems can sometimes run into problems with downloading these programs and dependencies. If so, please following these instructions to run the workshop from a Virtual Box VM.

    First, install Virtual Box

  1. Download Virtual box from https://www.virtualbox.org/wiki/Downloads.

  2. Install VirtualBox for your operating system.

  3. Download and install the Extension Pack from the same page (optional, for USB and folder sharing).
  4. Download Ubuntu ISO

  5. Download Ubuntu Desktop 22.04 LTS (64-bit) from: https://releases.ubuntu.com/22.04/

  6. Choose: ubuntu-22.04.4-desktop-amd64.iso
  7. Create and Configure the Virtual Machine

  8. Open VirtualBox

  9. Click "New" and create a VM with the following settings:
  10. Install Ubuntu

  11. Start the VM and follow the on-screen instructions to install Ubuntu

  12. Choose "Normal installation" and enable updates during install

  13. After installation, reboot and log into your new Ubuntu system

You should now be able to following the Windows instructions from step 4 above (Install Miniconda inside WSL) and work from within the VM.

All users

These programs must be installed directly from their websites:


Click here to return to the course homepage.