@@ -213,85 +213,119 @@ This tutorial was last tested using HADDOCK3 version 2024.10.0b7. The provided p
213213
214214
215215<hr >
216-
217216### BioExcel summerschool, Pula, Sardinia June 2025
218-
219-
220- We will be making use of the local computers for this tutorial.
221- The software and data required for this tutorial have been pre-installed.
222-
223- In order to run the tutorial, go into the HADDOCK3-antibody-antigen directory and activate the HADDOCK3 environment:
224-
225- <a class =" prompt prompt-cmd " >
226- cd ~ /BioExcel_SS_2025/HADDOCK/HADDOCK3-antibody-antigen<br >
227- </a >
228-
229- This directory contains all necessary data and scripts to run this tutorial.
230-
231- To activate the HADDOCK3 environment type:
232-
233- <a class =" prompt prompt-cmd " >
234- haddock3env<br >
235- </a >
236-
237- which is alias to ` source ~/BioExcel_SS_2025/HADDOCK/haddock3/.venv/bin/activate `
238-
239- You can then test that ` haddock3 ` is indeed accessible with:
240-
241- <a class =" prompt prompt-cmd " >
242- haddock3 -h
243- </a >
244-
245- You should see a small help message explaining how to use the software.
246-
247- <details style =" background-color :#DAE4E7 " >
248- <summary >
249- <i >View output</i ><i class =" material-icons " >expand_more</i >
250- </summary >
251- <pre >
252- (haddock3)$ haddock3 -h
253- usage: haddock3 [-h] [--restart RESTART] [--extend-run EXTEND_RUN] [--setup]
254- [--log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [-v]
255- recipe
256-
257- positional arguments:
258- recipe The input recipe file path
259-
260- optional arguments:
261- -h, --help show this help message and exit
262- --restart RESTART Restart the run from a given step. Previous folders from the
263- selected step onward will be deleted.
264- --extend-run EXTEND_RUN
265- Start a run from a run directory previously prepared with the
266- `haddock3-copy` CLI. Provide the run directory created with
267- `haddock3-copy` CLI.
268- --setup Only setup the run, do not execute
269- --log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}
270- -v, --version show version
271- </pre >
272- </details >
273- <br >
217+ <details >
218+ <summary style =" font-weight :bold ; cursor :pointer ;" >
219+ <i>click to expand</i>
220+ </summary >
221+ <p>
222+ We will be making use of the local computers for this tutorial.
223+ The software and data required for this tutorial have been pre-installed.
224+ </p>
225+
226+ <p>
227+ In order to run the tutorial, go into the
228+ <code>HADDOCK3-antibody-antigen</code> directory and activate the HADDOCK3 environment:
229+ </p>
230+
231+ <a class="prompt prompt-cmd">cd ~/BioExcel_SS_2025/HADDOCK/HADDOCK3-antibody-antigen</a>
232+
233+ <p>
234+ This directory contains all necessary data and scripts to run this tutorial.
235+ To activate the HADDOCK3 environment type:
236+ </p>
237+
238+ <a class="prompt prompt-cmd">haddock3env</a>
239+
240+ <p>
241+ which is an alias for:<br>
242+ <code>source ~/BioExcel_SS_2025/HADDOCK/haddock3/.venv/bin/activate</code>
243+ </p>
244+
245+ <p>
246+ You can then test that <code>haddock3</code> is accessible with:
247+ </p>
248+
249+ <a class="prompt prompt-cmd">haddock3 -h</a>
250+ You should see a small help message explaining how to use the software.
251+
252+ <details style="background-color:#DAE4E7">
253+ <summary>
254+ <i>View output</i><i class="material-icons">expand_more</i>
255+ </summary>
256+ <pre>
257+ (haddock3)$ haddock3 -h
258+ usage: haddock3 [-h] [--restart RESTART] [--extend-run EXTEND_RUN] [--setup]
259+ [--log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [-v]
260+ recipe
261+
262+ positional arguments:
263+ recipe The input recipe file path
264+
265+ optional arguments:
266+ -h, --help show this help message and exit
267+ --restart RESTART Restart the run from a given step. Previous folders from the
268+ selected step onward will be deleted.
269+ --extend-run EXTEND_RUN
270+ Start a run from a run directory previously prepared with the
271+ `haddock3-copy` CLI. Provide the run directory created with
272+ `haddock3-copy` CLI.
273+ --setup Only setup the run, do not execute
274+ --log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL}
275+ -v, --version show version
276+ </pre>
277+ </details>
278+ <br >
279+ </details >
274280
275281<hr >
276282
277283
278284### Local setup (on your own)
285+ <details >
286+ <summary style =" font-weight :bold ; cursor :pointer ;" >
287+ <i>click to expand</i>
288+ </summary >
289+ <br >
290+ If you are installing HADDOCK3 on your own system, check the instructions and requirements below.
279291
280- If you are installing HADDOCK3 on your own system, check the instructions and requirements below.
281-
292+ <h4 > Installing HADDOCK3</h4 >
282293
283- #### Installing HADDOCK3
294+ <p >
295+ To obtain HADDOCK3, fill the
296+ <a href="https://docs.google.com/forms/d/e/1FAIpQLScDcd0rWtuzJ_4nftkDAHoLVwr1IAVwNJGhbaZdTYZ4vWu25w/viewform" target="_blank">
297+ registration form
298+ </a>,
299+ and then follow the
300+ <a href="https://www.bonvinlab.org/haddock3-user-manual/install.html" target="_blank">
301+ installation instructions
302+ </a>.
303+ </p >
284304
285- To obtain HADDOCK3 navigate to [ its repository] [ haddock-repo ] , fill the
286- registration form, and then follow the [ installation instructions] ( https://www.bonvinlab.org/haddock3/INSTALL.html ) {: target ="_ blank"}.
305+ <p >
306+ <strong><em>Note</em></strong> that depending on the system you are installing HADDOCK3 on,
307+ you might have to recompile CNS if the provided executable is not working.
308+ See the
309+ <a href="https://github.com/haddocking/haddock3/blob/main/DEVELOPMENT.md#troubleshooting-the-cns-executable" target="_blank">
310+ CNS troubleshooting section
311+ </a>
312+ on the HADDOCK3 GitHub repository for instructions.
313+ </p >
287314
288- ** _ Note_ ** that depending on the system you are installing HADDOCK3 on, you might have to recompile CNS if the provided executable is not working. See the [ CNS troubleshooting section] ( https://github.com/haddocking/haddock3/blob/main/DEVELOPMENT.md#troubleshooting-the-cns-executable ) {: target ="_ blank"} on the HADDOCK3 GitHub repository for instructions.
289315
290- #### Auxiliary software
316+ < h4 > Auxiliary software </ h4 >
291317
292- [ ** PyMOL** ] ( https://www.pymol.org/ ) {: target ="_ blank"}: In this tutorial we will make use of PyMOL for visualization. If not
293- already installed on your system, download and install [ ** PyMOL** ] ( https://www.pymol.org/ ) {: target ="_ blank"}. Note that you can use your favorite visulation software but instructions are only provided here for PyMOL.
318+ <p >
319+ <a href="https://www.pymol.org/" target="_blank"><strong>PyMOL</strong></a>:
320+ In this tutorial we will make use of PyMOL for visualization.
321+ If not already installed on your system, download and install
322+ <a href="https://www.pymol.org/" target="_blank"><strong>PyMOL</strong></a>.
323+ Note that you can use your favorite visualization software,
324+ but instructions are only provided here for PyMOL.
325+ </p >
294326
327+ <br >
328+ </details >
295329
296330<hr >
297331<hr >
@@ -302,7 +336,7 @@ In this section we will prepare the PDB files of the antibody and antigen for do
302336Crystal structures of both the antibody and the antigen in their free forms are available from the
303337[ PDBe database] ( https://www.pdbe.org ) {: target ="_ blank"}.
304338
305- * __ Important:__ For a docking run with HADDOCK, each molecule should consist of a single chain with non-overlapping residue numbering within the same chain.
339+ __ Important:__ For a docking run with HADDOCK, each molecule should consist of a single chain with non-overlapping residue numbering within the same chain.
306340
307341As an antibody consists of two chains (L+H), we will have to prepare it for use in HADDOCK. For this we will be making use of ` pdb-tools ` from the command line.
308342
0 commit comments