initiateAddHyd (
models,
cancelCB=None,
okCB=None,
addFunc=AddH.simpleAddHydrogens,
)
Request the addition of hydrogens to the given models.
If all atoms in the models have known hydrogen-adding geometries,
the hydrogens are added immediately. Otherwise, a dialog is
started to request the missing information from the user. Once
the user 'Ok's the information-gathering dialog, the hydrogens are
added. The dialog can instead be cancelled, in which case no
hydorgens are added.
This function may be called from the user interface or from other
functions. If the latter, then typically the cancelCB and okCB
callback functions are provided so that the calling function can
ascertain whether hydrogens were in fact added to the models.
|