The addh command adds hydrogen atoms to atomic models, as well as OXT atoms where missing from peptide C-termini. See also: delete, hbonds
Hydrogens are added to entire atomic model(s) even if only parts of models are specified. Placement is based on atom types and to avoid clashes, if possible. The positions of pre-existing atoms are not changed, but any lone pairs and atoms of unidentifiable element are deleted.
The hbond option (default true) controls whether H-bond formation should also be considered. Considering H-bonds increases calculation time and may not produce a globally optimal network of H-bonds.
The inIsolation option (default true) indicates using only the atoms within the same model. Otherwise, other models in the vicinity (except sibling submodels of the same model) may affect hydrogen placement, even if the other models were not designated for hydrogen addition. Sibling submodels of the same model (e.g., #1.1, #1.2, #1.3, ...) are always treated in isolation from one another, even if this option is false.
The metalDist option specifies a distance between a heavy atom X and metal ion M (default 3.6 Å) within which to suppress adding a hydrogen to X if all of the following also apply:
The remaining options allow alternative protonation states of certain amino acids to be specified with special residue names:
|useHisName||HIS unspecified (guess from local environment),
HID δ-nitrogen protonated, HIE ε-nitrogen protonated,
HIP both sidechain nitrogens protonated
|all treated as unspecified|
|useAspName||ASP negatively charged, ASH neutral (OD2-protonated)||all negatively charged|
|useGluName||GLU negatively charged, GLH neutral (OE2-protonated)||all negatively charged|
|useLysName||LYS positively charged, LYN neutral||all positively charged|
|useCysName||CYS neutral, CYM negatively charged||all neutral|
The atom types within these amino acids are ignored for hydrogen addition, so changing them manually to try to control hydrogen addition will have no effect.
An attempt is made to preserve coloring schemes, coloring the added hydrogens by element (white) and/or to match their bond partners.