ICM GUI Manual
PrevICM User's Guide
5.1 Convert to ICM Object
Next

[ Load a Protein Structure | Convert | Convert Chemical ]

Available in the following product(s): ICM-Browser | ICM-Browser-Pro | ICM-Pro | ICM-Chemist

5.1.1 Load a Protein Structure


There are a couple of ways to read into ICM a protein structure.

  1. Search the PDB using the Search Tab.
  2. Load in a PDB file that you have saved on your computer using File/Open.

5.1.2 Converting PDB Files Into ICM Objects


To perform any energy-based calculation in ICM (for example, docking, displaying hydrogen bonds, or displaying electrostatic or binding property surfaces), a protein or small molecule must first be converted into an ICM object.

The convertObject macro converts a non-ICM structure, such as a PDB file, into a fully defined ICM object suitable for energy-based calculations. This conversion produces a complete all-atom model with assigned atom types, formal and partial charges, and an internal-coordinate representation. An ICM object is required for docking, energy evaluation, hydrogen-bond analysis, and electrostatic or binding property surface calculations.

During conversion, ICM applies a series of automated refinement steps to ensure the structure is chemically and energetically consistent. Missing side-chain atoms for known residues may be added, atom types and charges are assigned using ICM and MMFF rules, and alternative atom positions are resolved. Missing backbone segments or loops are not built. The original input object is preserved unless explicitly replaced by user options.

Depending on the selected arguments, convertObject can delete or retain water molecules, optimize hydrogen placement, evaluate histidine protonation states, flip Asn and Gln side chains, adjust cysteine states near metal ions, and assign ligand charge states using MolSoft's pKa model. Additional string options allow control over water handling, ligand tautomer optimization, and atom name correction. All changes made during conversion are reported in the command-line shell and can be reviewed by the user.

See the command line manual for a more complete description of what the conversion process does.

NOTE: Before converting a protein structure to an ICM object make sure that the chemicals contained within the structure (e.g. ligands) are correct. If an error is found you can edit the ligand as described here.

To convert a PDB structure into an ICM object follow the steps shown below:

If your object is an ICM object it will display ICM next to the molecule in the ICM Workspace.

5.1.3 How to Edit and Convert a Chemical from the PDB into an ICM Object


[ ICM Workspace | Graphical Display ]

The protein data bank has not been storing any information about covalent bond types and formal charges of the chemical compounds interacting with proteins! This oversight makes it impossible to automatically convert those molecules to anything sensible and requires your manual interactive assignment of bond types and formal charges for each compound in a pdb-entry. Therefore, if you apply the convert command to a pdb-entry with ligands, the ligands will just become some crippled incomplete molecules that can not be further conformationally optimized.

Therefore, follow these steps to convert a chemical properly from a pdb form to a correct icm object. There are two ways to do this either via the ICM Workspace (recommended) or via the Graphical Display.

5.1.3.1 Converting a Chemical from the PDB using the ICM Workspace


Change bond orders:

NOTE: Keyboard shortcuts are provided to make editing faster.

Change atom and charge:

NOTE: Keyboard shortcuts are provided to make editing faster.

Convert to 3D in MMFF force field:

NOTE: If you need to add an extra bond you will need to use the full molecular editor. Right click on the name of the ligand in the ICM Workspace and select Edit/Edit Compound.

5.1.3.2 How to Convert a Chemical from the PDB using the Graphical Display


To change the bond types in your ligand:

You can either select (see selection menu section)the atoms you wish to change graphically using the rectangular or lasoo selection button OR

You can select the By two atoms tabs and right click on the atoms you wish to change and then selecting the atom descriptor with the left mouse button as shown below.

To set the formal charge of a compound:

Click on MolMechanics/Edit Structure/Set Formal Charge and then select the appropriate charge.

The final step is to convert the compound into an ICM object:


Prev
Protein Structure
Home
Up
Next
Pocket Display