Skip to content

Commit 9afd32a

Browse files
committed
Update for BioExcel summerschool
1 parent ccf738a commit 9afd32a

File tree

1 file changed

+37
-13
lines changed
  • education/HADDOCK3/HADDOCK3-antibody-antigen

1 file changed

+37
-13
lines changed

education/HADDOCK3/HADDOCK3-antibody-antigen/index.md

Lines changed: 37 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -209,30 +209,28 @@ This tutorial was last tested using HADDOCK3 version 2024.10.0b7. The provided p
209209

210210
<hr>
211211

212-
### BioExcel HPC workshop, Sofia May 2025
212+
### BioExcel summerschool, Pula, Sardinia June 2025
213213

214-
We will be making use of the [Discoverer HPC CPU cluster](https://docs.discoverer.bg){:target="_blank"} for this tutorial.
214+
215+
We will be making use of the local computers for this tutorial.
215216
The software and data required for this tutorial have been pre-installed.
216-
Please connect to the system using your credentials as instructed.
217217

218-
In order to run the tutorial, go into you scratch directory, then unzip the required data:
218+
In order to run the tutorial, go into the HADDOCK3-antibody-antigen directory and activate the HADDOCK3 environment:
219219

220220
<a class="prompt prompt-cmd">
221-
cd /discofs/\<my\-username\><br>
222-
unzip /valhalla/projects/school-01/HADDOCK/HADDOCK3-antibody-antigen.zip<br>
223-
cd HADDOCK3-antibody-antigen
221+
cd ~/BioExcel_SS_2025/HADDOCK/HADDOCK3-antibody-antigen<br>
224222
</a>
225223

226-
This will create the `HADDOCK3-antibody-antigen` directory with all necessary data and scripts and job examples ready for submission to the batch system.
227-
228-
HADDOCK3 is part of the standard software supported on discoverer. To activate the HADDOCK3 environment load the following modules:
224+
This directory contains all necessary data and scripts to run this tutorial.
229225

226+
To activate the HADDOCK3 environment type:
230227

231228
<a class="prompt prompt-cmd">
232-
module load python/3/3.12<br>
233-
module load haddock3/2025.5.0
229+
haddock3env<br>
234230
</a>
235231

232+
which is alias to `source ~/BioExcel_SS_2025/HADDOCK/haddock3/.venv/bin/activate`
233+
236234
You can then test that `haddock3` is indeed accessible with:
237235

238236
<a class="prompt prompt-cmd">
@@ -946,10 +944,32 @@ In in the first section of the workflow above we have a parameter `mode` definin
946944
- **mpi**: HADDOCK3 also supports a pseudo parallel MPI implementation, which allows to harvest the power of multiple nodes to distribute the computations (functional but still very experimental at this stage).
947945

948946

947+
<hr>
948+
949+
#### Execution of HADDOCK3 on the computers of the BioExcel 2025 summerschool
950+
951+
To execute the HADDOCK3 workflow on the computational resources provided for this workshop,
952+
we will simply run in local mode, calling haddock3 with as argument the workflow you want to execute.
953+
954+
{% highlight shell %}
955+
haddock3 <my-workflow-configuration-file>
956+
{% endhighlight %}
957+
958+
Alternatively redirect the output to a log file and send haddock3 to the background.
959+
960+
As an indication, running locally on an Apple M2 laptop using 10 cores, this workflow completed in 7 minutes.
961+
962+
963+
949964
<hr>
950965

951966
#### Execution of HADDOCK3 on DISCOVERER (BioExcel Sofia May 2025 workshop)
952967

968+
<details style="background-color:#DAE4E7">
969+
<summary style="bold">
970+
<i>View execution instructions for running HADDOCK3 on DISCOVERER</i> <i class="material-icons">expand_more</i>
971+
</summary>
972+
953973
To execute the HADDOCK3 workflow on the computational resources provided for this workshop,
954974
you should create an execution script contain specific requirements for the queueing system and the HADDOCK3 configuration and execution.
955975
An example slurm script is provided with the data you unzipped:
@@ -987,6 +1007,8 @@ And you can check the status in the queue using the `squeue`command.
9871007

9881008
This example run should take about 7 minutes to complete on a single node using 50 cores.
9891009

1010+
</details>
1011+
9901012

9911013
<hr>
9921014

@@ -1623,10 +1645,12 @@ These computational methods come in two main flavours. One involves rigorous fre
16231645

16241646
### PROT-ON and haddock3-scoring to inspect a single mutation
16251647

1626-
PROT-ON (Structure-based detection of designer mutations in PROTein-protein interface mutatiONs) is a tool and [online server](http://proton.tools.ibg.edu.tr:8001/about) that scans all possible interfacial mutations and **predicts ΔΔG score** by using EvoEF1 (active in both on the web server and stand-alone versions) or FoldX (active only in the stand-alone version) with the aim of finding the most mutable positions. The original publication describing PROT-ON can be found [here](https://www.frontiersin.org/journals/molecular-biosciences/articles/10.3389/fmolb.2023.1063971/full).
1648+
PROT-ON (Structure-based detection of designer mutations in PROTein-protein interface mutatiONs) is a tool and [online server](http://proton.tools.ibg.edu.tr:8001/about){:target="_blank"} that scans all possible interfacial mutations and **predicts ΔΔG score** by using EvoEF1 (active in both on the web server and stand-alone versions) or FoldX (active only in the stand-alone version) with the aim of finding the most mutable positions. The original publication describing PROT-ON can be found [here](https://www.frontiersin.org/journals/molecular-biosciences/articles/10.3389/fmolb.2023.1063971/full){:target="_blank"}.
16271649

16281650
Here we will use PROT-ON to analyse the interface of our antibody-antigen complex. For that, we will use the provided matched reference structure (`4G6M-matched.pdb`) in which both chains of the antibody have the same chainID (A), which allows us to analyse all interface residues of the antibody at once.
16291651

1652+
__Note:__ Pre-calculated PROT-ON results for this system can be accessed [here](http://proton.tools.ibg.edu.tr:8001/result/ebcdec31308c46acb82e8010f7f21df1){:target="_blank"}.
1653+
16301654
<a class="prompt prompt-info">
16311655
Connect to the PROT-ON server page (link above) and fill in the following fields:
16321656
</a>

0 commit comments

Comments
 (0)