MODULE
1.0
A Novel Interactive Tool for Rigid-Body Modeling of Multi-Domain
Macromolecules using Residual
Dipolar Couplings.
Volume I - Practical Manual
(Version 1.0 July 2001)
Patrice DOSSET, Jean-Christophe HUS and Martin BLACKLEDGE
Institut de Biologie Structurale - Jean-Pierre Ebel C.N.R.S.-C.E.A.
41, rue Jules Horowitz- 38027 Grenoble Cedex - France
e-mail module@rmn.ibs.fr
Reference - Dosset et al. Journal of Biomolecular NMR20, 223-231, 2001.
Required Material
Fitting the Alignment TensorFitting Multiple Modules
Choice of Modules from Primary SequenceMulti-Module Alignment
Common Alignment FrameAutomatic Calculation of Molecular Architecture
Axially Symmetric Alignment Tensor.
Examples
Distance Constraints
Hammerhead Ribozyme - Orientation of Secondary Structural Motifs.
Silicon Graphics running IRIX 6.5 or higher, PC Linux running RedHat 5.2 or higher, or SUN SPARC running Solaris 2.6 or higher.
The program is started by typing the command module. Data and coordinate files can be read using either the name of the files -
module datafile coords.pdb
or by reading the files in the File menu -:

Input File Format
Module requires two sources of input
information: the measured residual dipolar coupling values Dij,
their associated uncertainty sij
and
an estimation of the order parameter S (for many application this will
of course be assumed to be 1), and a standard coordinate file from the
Brookhaven data bank containing the structure under investigation (protein
or nucleic acid).
The data file must be of the form -
These columns contain, in order, the residue number, the atom name, the value of the coupling constant, the uncertainty in this coupling constant and the order parameter.3 CA 3 C -2.127479 0.195 1.004 CA 4 C 1.182786 0.349 1.00
5 CA 5 C 3.222452 0.245 1.00
- - - - - - -
- - - - - - -
2 N 2 HN 10.013671 0.500 1.00
3 N 3 HN 6.264468 0.500 1.00
4 N 4 HN 15.149721 0.500 1.00
5 N 5 HN -8.166057 0.500 1.00
- - - - - - -
- - - - - - -
These lines can be entered in any order.
The program will recognise any atoms whose equivalent names are present
in the pdb file, so no sub-headings are required.
Initial Display
The initial display of the program shows the molecular structure in the pdb reference frame:

Displaying
the Primary Sequence
The molecular sequence can be displayed
by selecting the option Definition from the Visualisation
menu -
Both sequence and structure can be displayed using the
2nd Display button -

Selection
of Type of Coupling
MODULE can treat different couplings
simultaneously or in combination. To select the couplings to be treated
for a given tensor calculation select Couplings Choice from the
Control
menu : The available couplings in the data file will be already highlighted
and can be selectively removed by clicking on the illuminated box.


Setting Internuclear
Distances
The couplings are calculated with the
appropriate pre-factors including the gyromagnetic ratio and the inter-nuclear
distance; this can be chosen to be a either a standard fixed distance from
an interactive table, or the actual distance (Å) present in the coordinate
file (select Inter-Atom Distances from the
Control menu)


While the program has been specifically
designed to treat multiple structures simultaneously,
in the simplest case the whole molecule will be considered to be a single
module, and a single tensor will be fitted - all amino acids for which
data are available have a dot above the appropriate letter in the primary
sequence.