Skip to content

Commit 0d6c402

Browse files
committed
added first pass on AlphaFold2
1 parent 3b91cc6 commit 0d6c402

4 files changed

Lines changed: 61 additions & 0 deletions

File tree

docs/hpc/09_ood/06_Alphafold2.mdx

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# AlphaFold2
2+
3+
The AlphaFold2 software predicts protein structure from an amino acid sequence. Please see the paper [Highly accurate protein structure prediction with AlphaFold](https://www.nature.com/articles/s41586-021-03819-2) for details.
4+
5+
## Getting Started
6+
You can run AlphaFold2 in OOD by going to the URL [ood.hpc.nyu.edu](http://ood.hpc.nyu.edu) in your browser and selecting `AlphaFold2` from the `Interactive Apps` pull-down menu at the top of the page. As you can see below, once you've used it and other interactive apps they'll show up on your home screen under the `Recently Used Apps` header.
7+
8+
:::note
9+
Be aware that when you start from `Recently Used Apps` it will start with the same configuration that you used previously. If you'd like to configure your AlphFold2 session differently, you'll need to select it from the menu.
10+
:::
11+
12+
![OOD Interactive Apps menu](./static/ood_interactive_apps_alphafold2.png)
13+
14+
## Configuration
15+
16+
You can select the version of AlphaFold2 to use, the number or cores, amount of memory, GPU type (if any), amount of time, and optional Slurm options. You'll also be able to select either `/home` or `/scratch` to use as your root directory.
17+
18+
![OOD AlphFold2 Configuration](./static/ood_alphafold2_config.png)
19+
20+
:::warning
21+
If you select to use `/home` as your root directory be careful not to go over your quota. You can find your current usage with the `myquota` command. Please see our [Storage documentation](../03_storage/01_intro_and_data_management.mdx) for details about your storage options.
22+
:::
23+
24+
## AlphaFold2 running in OOD
25+
26+
After you hit the `Launch` button you'll have to wait for the scheduler to find you node(s) to run on:
27+
![OOD AlphaFold2 in queue](./static/ood_alphafold2_in_queue.png)
28+
29+
Once that's done, just hit the `Connect to Jupyter` button to see your Jupyter environment.
30+
31+
## Running the example notebook
32+
33+
Please follow these steps to run the example notebook:
34+
1. Get a shell prompt (This can be done in either of the following two ways):
35+
- In OOD:
36+
1. Select the `Clusters` pull-down menu at the top of the page
37+
1. Select `Greene Shell Access`
38+
- Use your terminal to log into Greene:
39+
1. Follow the instructions on [Connecting to HPC](../02_connecting_to_hpc/01_connecting_to_hpc.mdx)
40+
1. Create a directory to save the example notebook:
41+
```bash
42+
[NetID@log-1 ~]$ mkdir /scratch/$USER/AlphaFold2_example
43+
```
44+
1. `cd` into this new directory:
45+
```bash
46+
[NetID@log-1 ~]$ cd /scratch/$USER/AlphaFold2_example
47+
```
48+
1. Copy the example notebook into your directory:
49+
```bash
50+
[NetID@log-1 AlphaFold2_example]$ cp /scratch/work/public/examples/alphafold/alphafold-test.ipynb .
51+
```
52+
1. You can now go back to the main OOD site in your browser at [ood.hpc.nyu.edu](http://ood.hpc.nyu.edu) and start an AlphaFold2 interactive Session.
53+
:::tip
54+
- You'll need a GPU for the example notebook so select either version `2.0.0` or `2.1.1 amber-gpu`
55+
- One core is enough for the example notebook
56+
- You can select more if you'd like, but your job may sit in the queue longer before starting.
57+
- 4GB of memory is enough for the example notebook
58+
- Again, you can select more memory if you'd like, but it may take longer for you job to get picked up from the queue.
59+
- Select `any` type of GPU for the least amount of time spent in the queue
60+
:::
61+
1. When your Jupyter session starts you should be able to navigate to the new directory you created above and work through the example notebook.
281 KB
Loading
132 KB
Loading
160 KB
Loading

0 commit comments

Comments
 (0)