MON_LIB (CCP4: Formats)


Version 4.11

What is a Monomer Description?

The refinement program REFMAC requires a complete chemical description of all monomers (i.e. any molecular entity, e.g. 'protein residue' or 'ligand') which are referred to in the input coordinates.

Complete description

The complete description of a monomer includes lists of:

Note that values of VDW and ionic radii and definitions of inter-monomer restraints (e.g. to maintain a peptide bond) are not in the monomer description but in alternative files described below.

There are descriptions for commonly occurring residues and ligands in the library files in the directory $CLIBD_MON (i.e. $CCP4/lib/data/monomer) but for any novel monomer the crystallographer must provide the program Libcheck with a minimal description of the monomer from which the program can derive a complete description.

Minimal description

A minimal description must include a list of all non-hydrogen atoms (with the atom identifiers and element names), and all bonds and some extra information which can have any one of three forms:

Practically, the user can provide this information:

The easiest way to interact with Libcheck is using the CCP4i Sketcher even if you already have either a PDB or CIF coordinate file.

Please note that after generating a complete description from a minimal one it is advisable to check the complete description carefully. Also note that some of the entries in the library files are only minimal descriptions from which the complete description is derived. The minimal descriptions are derived from the PDB dictionary of ligands, which may contain errors for which the author(s) cannot take responsibility.

Library Files

The format of monomer descriptions and all library files is an extension of mmCIF. All attribute values in a CIF file are preceded by the name for that attribute. The recognised types of attribute are defined in a dictionary file which gives a definition for each attribute, and which should make the library files self-explanatory.

The monomer library files describe the internal geometry of a monomer - they may contain complete or minimal descriptions of the monomers. CCP4 distributed library files are in the directory $CLIBD_MON ($CCP4/lib/data/monomer). Do not alter these files in any way, as this would corrupt the running of Refmac! If you want to change some description, you can use your own additional library with the correct description. In this case the last correct description will be used instead of the distributed one.

See an example of a complete monomer description.

Distributed library files containing complete and minimal descriptions:

The descriptions are arranged in a directory structure according to, in general, their 3 letter code, eg l/LAT.cif

There are two additional files in the $CLIBD_MON directory:

contains a complete list of VdW and ionic radii and target values for bond distances, angles and torsions for the different atom chemical types. When Libcheck generates a complete monomer description from a minimal one, target values are usually taken from ener_lib.cif and associated with the bond, angle or torsion in the monomer description file. Alternatively Libcheck can extract target values from an input coordinate file (see COOR keyword). The user can edit the values in the monomer description file or they could change the values in ener_lib.cif.
When applying the monomer descriptions, the refinement procedure uses the chemical type in the monomer description to cross-reference the VdW and ionic radii in ener_lib.cif.
  • The chemical structure of links between polymers (e.g. cis- and trans-peptide bonds, disulfide bridges, glycosidic bonds for sugars, phosphate bridges for DNA)
  • Chemical details of common modifications of monomers (e.g. termini of polypeptide chains, sugar modifications, termini of DNA/RNA)
  • See details in library of monomers.