initiateAddHyd (
        models,
        cancelCB=None,
        okCB=None,
        hisScheme=None,
        addFunc=AddH.hbondAddHydrogens,
        )

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 hydrogens 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.

addHinfoDialog