|
| 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 | + |
| 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 | + |
| 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 | + |
| 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. |
0 commit comments