Structural Bioinformatics Library
Template C++ / Python API for developping structural bioinformatics applications.

Authors: N. MalodDognin and R. Andonov
Given a polypeptide chain, a protein contact map is a binary matrix such that the ijth element is one if the two corresponding are within a userdefined distance threshold, and zero otherwise. Alternatively, a contact map can be represented as a graph, with an edge between two iff the corresponding entry of the matrix is one.
In the CMO approach, the similarity between two proteins is determined by the extent of overlap of their contact maps.
See Protein Contact Map for more detail, and Fig. figCMO for an illustration.
Contact Map Overlap (A)Vertex set (1, 2, 4) from CM1 is matched with vertex set (1', 3', 4') from CM2. Common edges (two in this case) are denoted by the same number of vertical dashes. This is an order preserving MCES with maximum score 2. (B) Vertex set (1, 2, 3, 4) from CM1 is matched with vertex set (1', 4' , 2', 3') from CM2. This is a MCES with score 3. The order is not preserved. 
The formal definition of CMO is as follows. Let and be arbitrary subsets of vertices from the first and second contact maps, respectively.
Under the alignment (matching, onetoone map) , the edge is common (an overlap occurs) if and only if both edges and exist in the two contact maps processed.
The CMO problem is to find the optimal and , where optimality means maximum number of common edges. Since the sets of aminoacids are supposed linearly ordered, crossings are not allowed (see Fig. figCMO).
Apurva is a Contact Map Overlap maximization (CMO) solver. Given two protein structures represented by two contact maps, Apurva computes the aminoacid alignment that maximizes the number of common contacts. More information about the solver can be found in the articles [7] and [8] .
Apurva can process contact maps. A contact map file is divided in three sections, separated by an empty line.
The first section describes the contacts between the aminoacids. The first line contains an integer value X, which is the number of residues. Note that residues are labelled starting from one. The second line contains an integer value Y, which is the number of contacts. The next Y lines each contain two integer values i and j, i<j, the tail and head residues of each contact.
The second section describes the secondary structure assignment of the protein. It start with a line containing an integer value S, which is the number of secondary structure elements (SSE). It is then followed by S lines, each containing two integers (i and j) and a symbol t, where i is the first aminoacid of the SSE, j is the last aminoacid of the SSE, and t is the type of the SSE (either H for an alphahelix, or b for a betastrand).
The contact map files in the sequel were generated as follows: parameters:
Here is the contact map file for chain A in file 1vfb.pdb :
107 372 0 2 ... 104 106 10 3 6 b ... 101 105 b 13 0 2 13 ... 8 9 9
The first line indicates the number of residues, the second line the number of contacts, and then all contacts are enumerated by residue identifiers. After a blank line, the number of secondary structure elements (SSE) are indicated. Then, the start residue, the end residue, and the type of SSE (b for betasheet and H for alphahelix). Finally, the number of contacts between SSE is followed by the SSE identifiers and the number of residues in contact between the two SSE.
CMO is an NPhard problem [80] . The algorithms used here to solve CMO provided here are presented in [7] and [8] . These algorithms use an an integer programming model for CMO, and solve it with an an exact branchandbound algorithm with bounds obtained by a novel Lagrangian relaxation.
In this section, we present the executable , provided with the SBL .
Restrictions on PDB files.
Apurva can process .PDB files (.pdb or .ent), with the following restrictions:
Options.
Examples.
Apurva will align the two contact maps 1amkA.hcm and 1aw2A.hcm, and will display the corresponding alignment :
./sblapurva.exe cm1 ./1amkA.hcm cm2 ./1aw2A.hcm display 2
Apurva will align chain A of 1amk.pdb with chain A of 1aw2.pdb, and will generate two files for VMD that highlight the matching between the two protein chains :
./sblapurva.exe pdb1 1amk.pdb chain1 A pdb2 1aw2.pdb chain2 A vmd 1