Add Charge Add Charge icon

Add Charge assigns atomic partial charges and Amber/GAFF atom types as the attributes charge and gaffType, respectively.

Atomic partial charges are included in saved Mol2 files. The charges and Amber/GAFF atom types are used by other Chimera tools such as Minimize Structure. Atoms can be labeled with their attribute values (see the figure) using Actions... Label... other or the commands labelopt and label.

See also: AddH, Dock Prep, Minimize Structure, Add Ions, Write Prmtop

There are several ways to start Add Charge, a tool in the Structure Analysis and Structure Editing categories. Add Charge is also implemented as the command addcharge.

Models to process can be chosen from the list with the left mouse button. Ctrl-click toggles the status of an individual model. To choose a block of models without dragging, click on the first (or last) and then Shift-click on the last (or first) in the desired block.

Charge model indicates the parameters to use for standard residues (details):

OK initiates processing and dismisses the dialog, Apply initiates processing without dismissing the dialog, and Close simply dismisses the dialog. Help opens this manual page in a browser window.

AddH will be called as needed to add hydrogens. Potentially ambiguous or rare protonation states, especially in binding sites and nonstandard residues, should be verified and corrected before charges are assigned. For example, extra hydrogens could be deleted, or atom types could be edited (before hydrogen addition) with setattr or Build Structure.

If there are any nonstandard residues, a dialog will appear for specifying the net charge of each nonstandard residue and which charge calculation method should be used (details).

If a nucleic acid chain has a 5' terminal phosphate, the user will be asked whether this group should be deleted; otherwise, its atoms will be assigned charges of zero (the charge sets lack parameters for 5' phosphates).

A warning will appear if the name of any atom in a standard residue is not recognized or a model's net charge is not an integer; details will be reported in the Reply Log. Cases of unrecognized atoms in standard residues and/or incorrect net charges should be examined and resolved. Note that chain-terminal nucleotide residues will normally have non-integral charges, but the 5' and 3' charges sum to an integer.

Details for Standard Residues

Atoms in standard residues (water, standard amino acids, standard nucleic acids, and a few common variants and capping groups) are assigned charges and atom types taken from Amber parameter files. Charge model corresponds to force field version (see the Amber documentation for further details):

The parameters include alternative sidechain protonation states for some standard residues: AddH will add hydrogens to generate the states shown in bold, although it will not remove any hydrogens that were already present. Histidine protonation states can be indicated with the special names HID/HIE/HIP or guessed based on the local environment. Protonation should be adjusted to the desired states before charge assignment.

Water charges correspond to the TIP3P model:

W.L. Jorgensen, J. Chandrasekhar, and J.D. Madura, "Comparison of simple potential functions for simulating liquid water" J Chem Phys 79:926 (1983).
Note different solvent charge sets can be obtained using Solvate. Charges previously assigned to solvent atoms by Solvate are not overwritten by Add Charge.

Cases of unrecognized atoms in standard residues and/or incorrect net charges should be examined and resolved. Approaches include:

Nonstandard Residues and Antechamber

Charges and GAFF atom types in nonstandard residues (any not classified as standard) are determined using Amber's Antechamber module, which is included with Chimera.

A dialog will appear for specifying the net charge of each nonstandard residue and which charge calculation method should be used:

While both methods are much faster than ab initio calculations, the Gasteiger method is the faster and more approximate of the two. Regardless of which method is chosen, residues that are monatomic ions will simply be assigned their net charges.

Publications involving Antechamber use should cite:

J. Wang, W. Wang, P.A. Kollman, and D.A. Case, "Automatic atom type and bond type perception in molecular mechanical calculations" J Mol Graph Model 25:247 (2006).
GAFF atom types and associated parameters are described online and in:
J. Wang, R.M. Wolf, J.W. Caldwell, P.A. Kollman, and D.A. Case, "Development and testing of a general amber force field." J Comput Chem 25:1157 (2004).

Additional Parameter Sources

Additional sources of charges and other parameters include:


UCSF Computer Graphics Laboratory / October 2008