Skip to content

Update basic prot-prot server tuto#773

Open
AnnaKravchenko wants to merge 4 commits intomasterfrom
prot-prot-server
Open

Update basic prot-prot server tuto#773
AnnaKravchenko wants to merge 4 commits intomasterfrom
prot-prot-server

Conversation

@AnnaKravchenko
Copy link
Copy Markdown
Contributor

@AnnaKravchenko AnnaKravchenko commented Mar 12, 2026

Issue #772

  • Added intro about glucose transport
  • Tidied up main text, e.g. the spacing
  • Edited main text, e.g. added more question-prompts, harmonized “Steps” in the section about the server, etc.

@AnnaKravchenko AnnaKravchenko marked this pull request as draft March 12, 2026 14:46
@AnnaKravchenko AnnaKravchenko marked this pull request as ready for review March 16, 2026 14:37
@AnnaKravchenko AnnaKravchenko linked an issue Mar 16, 2026 that may be closed by this pull request
Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md Outdated
Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md Outdated
Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md Outdated
Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md Outdated
Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md Outdated
Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md Outdated
Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md Outdated
Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md Outdated
Copy link
Copy Markdown
Contributor

@VGPReys VGPReys left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am only half way.
Will continue later.

@AnnaKravchenko
Copy link
Copy Markdown
Contributor Author

AnnaKravchenko commented Mar 16, 2026

I am only half way. Will continue later.

Thank you for the detailed review!

UPD: all commenets incorporated, ready for the second part:)

@amjjbonvin
Copy link
Copy Markdown
Member

amjjbonvin commented Mar 16, 2026 via email

@amjjbonvin
Copy link
Copy Markdown
Member

amjjbonvin commented Mar 19, 2026 via email

@AnnaKravchenko AnnaKravchenko requested a review from VGPReys March 20, 2026 12:04
@AnnaKravchenko
Copy link
Copy Markdown
Contributor Author

@amjjbonvin litttle question. I found two saved server runs for the E2A-HPR system described in this tutorial. One result page linked inside the tutorial (https://wenmr.science.uu.nl/haddock2.4/result/4242424242/195967-E2A-HPR) and another one linked in “Example” tab of HADDOCK server (https://wenmr.science.uu.nl/haddock2.4/result/4242424242/0-E2A-HPR)

Wonder if we need to keep both or if it’s fine to keep only one of these result pages permanently available?

@amjjbonvin
Copy link
Copy Markdown
Member

amjjbonvin commented Mar 23, 2026 via email

Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md
Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md
Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md
Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md
Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md
Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md
Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md

**Note:** The same procedure can be used to introduce a mutation in an input protein structure.
To introduce this modification:
<a class="prompt prompt-info">Open the PDB file *e2a_1F3G.pdb* in your favorite text editor</a>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we want to specify editors not to use ?
Or typical editors to use

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think so. Also I cannot think of an editor that can open pdb format by default, but at the same time can't maintain pdb spacing

**Note:** The same procedure can be used to introduce a mutation in an input protein structure.
To introduce this modification:
<a class="prompt prompt-info">Open the PDB file *e2a_1F3G.pdb* in your favorite text editor</a>
<a class="prompt prompt-info">Find histidine with residue sequence number equal to 90</a>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<a class="prompt prompt-info">Find histidine with residue sequence number equal to 90</a>
<a class="prompt prompt-info">Find the histidine with residue number 90</a>

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To me "residue number" is also way more habitual, but I would keep "residue sequence number", as it is in documentation linked bellow in the text. I hope this way very unexperienced users won't get confused.

And experiences users gonna understand as is

Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md
hide lines<br>
</a>

Since this is an NMR structure it does not contain any water molecules and we don't need to remove them.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why remove this? It is relevant since we do remove the water for the first molecule

Comment thread education/HADDOCK24/HADDOCK24-protein-protein-basic/index.md
@amjjbonvin
Copy link
Copy Markdown
Member

Be aware that there is a copy of this tutorial we use for teaching purposes in the 2nd year bachelor course. Might need to be updated too, but keeping the questions. Check https://www.bonvinlab.org/education/NMRMolmod/

#### HADDOCK submission: Input data

For this we will make us of the [HADDOCK 2.4 interface](https://wenmr.science.uu.nl/haddock2.4/submit/1){:target="_blank"} of the HADDOCK web server.
Locate "[Submit a new job](https://wenmr.science.uu.nl/haddock2.4/submit/1){:target="_blank"}" button. Note that you are now in "Input data" tab.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Locate "[Submit a new job](https://wenmr.science.uu.nl/haddock2.4/submit/1){:target="_blank"}" button. Note that you are now in "Input data" tab.
Locate and click on the "[Submit a new job](https://wenmr.science.uu.nl/haddock2.4/submit/1){:target="_blank"}" button. Note that you are now in "Input data" tab.

* **Step1:** In the field "Job name", define a name for your docking run, e.g. *E2A-HPR*.

* **Step2:** Select the number of molecules to dock, in this case the default *2*.
* **Step2:** In the field "Number of molecules", select the number of molecules to dock, in this case 2.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* **Step2:** In the field "Number of molecules", select the number of molecules to dock, in this case 2.
* **Step2:** In the field "Number of molecules", select the number of molecules to dock, in this case 2, which is the default value.


**Note:** Leave all other options to their default values.
Leave all other options to their default values.
**_Note_** that you can fold and unfold the "Molecule 1 - input" section by clicking on the ▼ icon. This works for any section and subsection of HADDOCK server.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
**_Note_** that you can fold and unfold the "Molecule 1 - input" section by clicking on the ▼ icon. This works for any section and subsection of HADDOCK server.
**_Note_** that you can fold and unfold the "Molecule 1 - input" section by clicking on the ▼ icon. This works for any section and subsection on the HADDOCK2.4 server.

##### Definition of restraints

#### Definition of restraints
In this tab, we will define distance restraints by specify active residues for each molecule.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
In this tab, we will define distance restraints by specify active residues for each molecule.
In this tab, we will define distance restraints by specifying active residues for each molecule.

The page will automatically refresh and the results will appear upon completions (which can take between 1/2 hour to several hours depending on the size of your system and the load of the server). You will be notified by email once your job has successfully completed.
This run will take between 30 minutes to several hours - depending on the load of the server. You will be notified by email once your job has been completed. The results will remain accessible for a week.

You do not have to keep this page open, all resent jobs can be accessed via the "[Workspace](https://wenmr.science.uu.nl/haddock2.4/workspace){:target="_blank"}" button in the navigation bar.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You do not have to keep this page open, all resent jobs can be accessed via the "[Workspace](https://wenmr.science.uu.nl/haddock2.4/workspace){:target="_blank"}" button in the navigation bar.
You do not have to keep this page open, all recent jobs can be accessed via the "[Workspace](https://wenmr.science.uu.nl/haddock2.4/workspace){:target="_blank"}" button in the navigation bar.


Once your run has completed you will be presented with a result page showing the cluster statistics and some graphical representation of the data (and if registered, you will also be notified by email). Such an example output page can be found [here](https://wenmr.science.uu.nl/haddock2.4/run/4242424242/195967-E2A-HPR){:target="_blank"} in case you don't want to wait for the results of your docking run.
Once your run has completed (you will also be notified by email about it) you will be presented with a result page showing the cluster statistics and graphical representation of the run.
An example output page for E2A-HPR docking can be found [here](https://wenmr.science.uu.nl/haddock2.4/run/4242424242/195967-E2A-HPR){:target="_blank"} - just in case you don't want to wait for the results of your docking run.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
An example output page for E2A-HPR docking can be found [here](https://wenmr.science.uu.nl/haddock2.4/run/4242424242/195967-E2A-HPR){:target="_blank"} - just in case you don't want to wait for the results of your docking run.
An example output page for E2A-HPR docking can be found [here](https://wenmr.science.uu.nl/haddock2.4/run/4242424242/195967-E2A-HPR){:target="_blank"} - just in case you don't want to wait for the results of your own docking run.


<a class="prompt prompt-question">Inspect the result page</a>
<a class="prompt prompt-question">How many clusters are generated?</a>
<a class="prompt prompt-question">Inspect the result page. How many clusters have been generated?</a>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

At that stage, do we want to make a description of the different parts available on the page ?

HADDOCK_score = 1.0 * E_vdw + 0.2 * E_elec + 1.0 * E_desol + 0.1 * E_air,
</pre>
where Evdw is the intermolecular van der Waals energy, Eelec the intermolecular electrostatic energy, Edesol represents an empirical desolvation energy term adapted from Fernandez-Recio *et al.* J. Mol. Biol. 2004, and Eair the AIR energy. The cluster numbering reflects the size of the cluster, with cluster 1 being the most populated cluster. The various components of the HADDOCK score are also reported for each cluster on the results web page.
where *E_vdw* is the intermolecular van der Waals energy, *E_elec* is the intermolecular electrostatic energy, *E_desol* represents an empirical desolvation energy term adapted from Fernandez-Recio *et al.* J. Mol. Biol. 2004, and *E_air* is a penalty for violation of the restraints.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what about adding a link to the publication itself ?

Suggested change
where *E_vdw* is the intermolecular van der Waals energy, *E_elec* is the intermolecular electrostatic energy, *E_desol* represents an empirical desolvation energy term adapted from Fernandez-Recio *et al.* J. Mol. Biol. 2004, and *E_air* is a penalty for violation of the restraints.
where *E_vdw* is the intermolecular van der Waals energy, *E_elec* is the intermolecular electrostatic energy, *E_desol* represents an empirical desolvation energy term adapted from (Fernandez-Recio *et al.* J. Mol. Biol. 2004)[https://www.sciencedirect.com/science/article/pii/S0022283603013755], and *E_air* is a penalty for violation of the restraints.

## Visualisation

The new HADDOCK2.4 server integrates the NGL viewer which allows you to quickly visualize a specific structure. For that click on the "eye" icon next to a structure.
HADDOCK server integrates the NGL viewer which allows you to quickly visualize a specific structure among clustered. For that click on the "eye" icon next to a structure.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
HADDOCK server integrates the NGL viewer which allows you to quickly visualize a specific structure among clustered. For that click on the "eye" icon next to a structure.
HADDOCK server integrates the NGL viewer which allows you to quickly visualize a specific structure among clustered ones. For that click on the "eye" icon next to a structure.

<a class="prompt prompt-question">Based on this analysis, which cluster does satisfy best the biolocal information?</a>

<a class="prompt prompt-question">Is this cluster also the best ranked one?</a>
<a class="prompt prompt-question">Based on this analysis, which cluster fits biological information the mos does satisfy best the biological information? Is this cluster also the best ranked one?</a>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<a class="prompt prompt-question">Based on this analysis, which cluster fits biological information the mos does satisfy best the biological information? Is this cluster also the best ranked one?</a>
<a class="prompt prompt-question">Based on this analysis, which cluster best satisfies the biological information?>
<a class="prompt prompt-question">Is this cluster also the best ranked one?</a>

<a class="prompt prompt-pymol">
alter (chain B and 1GGR), resv -=300<br>
</a>
This shift is critical for the RMDS calculation described below!
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This shift is critical for the RMDS calculation described below!
This shift is critical for appropriate residue mapping when performing the RMDS calculation described below!


Once your run has completed you will be presented with a result page showing the cluster statistics and some graphical representation of the data (and if registered, you will also be notified by email). Such an example output page can be found [here](https://wenmr.science.uu.nl/haddock2.4/run/4242424242/195967-E2A-HPR){:target="_blank"} in case you don't want to wait for the results of your docking run.
Once your run has completed (you will also be notified by email about it) you will be presented with a result page showing the cluster statistics and graphical representation of the run.
An example output page for E2A-HPR docking can be found [here](https://wenmr.science.uu.nl/haddock2.4/run/4242424242/195967-E2A-HPR){:target="_blank"} - just in case you don't want to wait for the results of your docking run.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update basic protein-protein server tutorial

4 participants