Skip to content

Repository files navigation

Current methods and open challenges for structural modeling in cancer immunotherapy - ISMCO'21

Welcome to the third edition of the ISMCO tutorial on Current methods and open challenges for structural modeling in cancer immunotherapy!!!

Tentative outline

Activity Duration (m) Time (PST) Time (CST)
Opening 5 3:00 5:00
Cellular immunity for cancer immunotherapy 15 - -
Exploring IEDB resources 45 - -
Break 15 4:05 6:05
Downloading structures from PDB 5 4:20 6:20
Visualizing pHLA structures w Chimera 35 - -
Break 15 5:00 7:00
Intro to pHLA modeling 10 5:15 7:15
DINC (webserver) 10 - -
DockTope (webserver) 5 - -
Break 15 5:40 7:40
Intro to Google Colab 5 5:55 7:55
Running Ape-Gen w Google Colab 10 - -
Intro to HLA-Arena 15 - -
HLA-Arena workflow 0 demo (ApeGen) 10 - -
HLA-Arena workflow 1 demo (DINC) 5 - -
HLA-Arena workflow 3 demo (mhcflurry + APE-Gen) 5 - -
Conclusion 5 6:45 8:45

Zoom link for tutorial

https://riceuniversity.zoom.us/j/96681193182?pwd=MVo3bkt0eW9Vb3NGMm1Ydmt1R1RTUT09

Tutorial materials

  • IEDB Part 1: T01, IEDB

  • IEDB Part 2: T02, IEDB, Uniprot

  • PDB: T03, PDB

  • UCSF Chimera: T04, requires downloading UCSF Chimera

  • APE-Gen with Google Colab: T05, requires downloading the notebook and opening it on Google Colab

Software requirements

You will need to install the following programs PRIOR TO THE BEGINNING OF THE TUTORIAL! This is important since the download could take some time depending on your internet connection.

If you have any questions about the installation, please contact mmr9@rice.edu.

1. Software that will be required for the tutorial:

1.1. UCSF Chimera

1.2. Google Colab

  • Find a intro do Google Colab here.

2. Additional software that will be discussed, but not requiered for the tutorial:

2.1. Docker

To run HLA-Arena you will need to first install Docker, unless you already have it. For that, follow the instructions in one of these links:

2.2. HLA-Arena

Next, in a command prompt, pull the HLA-Arena image from Docker Hub by typing:

    docker pull kavrakilab/hla-arena

This step can take hours and it will require about 20 Gb of disk space.

3. Checking your installation:

3.1. Test your Docker installation

In the command line (or prompt) run the following command:

      docker run hello-world

You should see the following output:

    Hello from Docker!
    This message shows that your installation appears to be working correctly.

    To generate this message, Docker took the following steps:
     1. The Docker client contacted the Docker daemon.
     2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
        (amd64)
     3. The Docker daemon created a new container from that image which runs the
        executable that produces the output you are currently reading.
     4. The Docker daemon streamed that output to the Docker client, which sent it
        to your terminal.

    To try something more ambitious, you can run an Ubuntu container with:
     $ docker run -it ubuntu bash

    Share images, automate workflows, and more with a free Docker ID:
     https://hub.docker.com/

    For more examples and ideas, visit:
     https://docs.docker.com/get-started/

3.2. Check if you have downloaded the HLA-arena image

In the command line (or prompt) run the following command:

    docker images

You should see an output like this:

    REPOSITORY             TAG                      IMAGE ID            CREATED             SIZE
    kavrakilab/hla-arena   latest                   e6cefe68c72a        2 months ago        20.6GB

3.3. Modeller license key

Several of HLA-Arena workflows rely on Modeller to perform the homology modeling of a given HLA receptor. This modeling task is integrated into a specific HLA-Arena function (more details here). However, using Modeller requires you to register and obtain your own license key, if you do not already have one. First, follow instructions on the Modeller registration page.

Once you have the key, you can permanently update the HLA-Arena container with your key. For that, you should execute the commands below, replacing MODELLER_KEY with the correct key.

    docker run -it kavrakilab/hla-arena
    sed -i "s/XXXX/MODELLER_KEY/g" /conda/envs/apegen/lib/modeller-9.20/modlib/modeller/config.py
    exit
    docker commit $(docker ps -a | sed -n 2p | awk '{ print $1 }') kavrakilab/hla-arena
    docker container rm $(docker ps -a | sed -n 2p | awk '{ print $1 }')

For more information on HLA-Arena, you can check the HLA-Arena github repository.

4. Online video tutorials:

4.1. Two-part video tutorial on HLA-Arena

HLA-Arena video tutorial (Part 1)

HLA-Arena video tutorial (Part 2)

4.2. Two-part video tutorial on DINC

DINC video tutorial (Part 1)

DINC video tutorial (Part 2)

About

Current methods and open challenges for structural modeling in cancer immunotherapy - ISMCO'21

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages