1 {% extends "base.html" %}
3 {% load i18n lazysignup_tags %}
7 <H1 ALIGN=CENTER>DESCRIPTION OF THE OUTPUT FILES FROM THE UNRES SERVER</H1>
16 <H2><A NAME="SECTION00010000000000000000">
19 <!--Table of Contents-->
22 <LI><A NAME="tex2html30"
23 HREF="outputs.html#SECTION00020000000000000000">GENERAL INFORMATION</A>
24 <LI><A NAME="tex2html31"
25 HREF="outputs.html#SECTION00030000000000000000">UNRES OUTPUT FILES</A>
27 <LI><A NAME="tex2html32"
28 HREF="outputs.html#SECTION00031000000000000000">The main output file(s)</A>
29 <LI><A NAME="tex2html33"
30 HREF="outputs.html#SECTION00032000000000000000">Coordinate files</A>
31 <LI><A NAME="tex2html34"
32 HREF="outputs.html#SECTION00033000000000000000">The summary (STAT) file</A>
35 <LI><A NAME="tex2html35"
36 HREF="outputs.html#SECTION00040000000000000000">WHAM OUTPUT FILES</A>
38 <LI><A NAME="tex2html36"
39 HREF="outputs.html#SECTION00041000000000000000">Summary of the files</A>
40 <LI><A NAME="tex2html37"
41 HREF="outputs.html#SECTION00042000000000000000">The structure of the main output file (out)</A>
42 <LI><A NAME="tex2html38"
43 HREF="outputs.html#SECTION00043000000000000000">The thermodynamic quantity and ensemble average (thermal) files</A>
44 <LI><A NAME="tex2html39"
45 HREF="outputs.html#SECTION00044000000000000000">The conformation summary with classification (stat) files</A>
46 <LI><A NAME="tex2html40"
47 HREF="outputs.html#SECTION00045000000000000000">The histogram files</A>
48 <LI><A NAME="tex2html41"
49 HREF="outputs.html#SECTION00046000000000000000">The rmsd-radius of gyration potential of mean force files</A>
50 <LI><A NAME="tex2html42"
51 HREF="outputs.html#SECTION00047000000000000000">The PDB files</A>
52 <LI><A NAME="tex2html43"
53 HREF="outputs.html#SECTION00048000000000000000">The compressed Cartesian coordinates (cx) files</A>
56 <LI><A NAME="tex2html44"
57 HREF="outputs.html#SECTION00050000000000000000">CLUSTER OUTPUT FILES</A>
59 <LI><A NAME="tex2html45"
60 HREF="outputs.html#SECTION00051000000000000000">Summary of files</A>
61 <LI><A NAME="tex2html46"
62 HREF="outputs.html#SECTION00052000000000000000">Output coordinate files</A>
64 <!--End of Table of Contents-->
67 <H1><A NAME="SECTION00020000000000000000"></A>
68 <A NAME="sect:general"></A>
74 The output files produced by the UNRES server are those from UNRES and, if MREMD calculations
75 were requested, also from WHAM and CLUSTER and the final all-atom model files. The file names
76 begin with file_ for UNRES, WHAM, and cluster, while the files with the final all-atom models are
77 model01.pdb - model05.pdb. It should be noted that only the files correspoding to the
78 calculation types available when using the UNRES server are described in this document and
79 that, for non-server UNRES jobs,
80 other filename prefixes than file_ can be set; for details please see the
81 <a href="http://www.unres.pl/docs">UNRES web page</a>.
85 <H1><A NAME="SECTION00030000000000000000"></A>
86 <A NAME="sect:output"></A>
93 <H2><A NAME="SECTION00031000000000000000"></A>
94 <A NAME="sect:output:main"></A>
96 The main output file(s)
100 UNRES ``main'' output files (file.out_${POT}[processor], where, by defalut, ${POT} = GB,
101 the Gay-Berne-type sidechain-sidechain interaction potential)
103 a run. They contain the information of the molecule, force field, calculation
104 type, control parameters, etc.; however, not the structures produced during
105 the run or their energies except single-point energy evaluation and
106 minimization-related runs.
110 <H2><A NAME="SECTION00032000000000000000"></A>
111 <A NAME="sect:output:coord"></A>
117 The structural information is included in
118 coordinate files (*.int, *.x, *.pdb, *.mol2, *.cx) and statistics files (*.stat),
119 respectively; these files are further processed by WHAM and
120 CLUSTER or can be viewed by molecular viewers (pdb or mol2 files).
124 <H3><A NAME="SECTION00032100000000000000"></A>
125 <A NAME="sect:output:coord:int"></A>
127 The internal coordinate (INT) file
131 This file contains the internal coordinates of the conformations produced
132 by UNRES in non-MD runs. The virtual-bond lengths are assumed constant so
133 only the angular variables are provided.
136 IT,ENER,NSS,(IHPB(I),JHPB(I),I=1,NSS)
137 <BR>(I5,F12.5,I2,9(1X,2I3))
142 <DD>IT - the number of the conformation.
145 <DD>ENER - total energy.
148 <DD>NSS - the number of disulfide bridges.
151 <DD>(IHPB(I),JHPB(I),I=1,NSS) - the positions of the pairs of half-cystines .
152 forming the bridges. If NSS > 9, the remaining pairs are written in the
153 following lines in the (3X,11(1X,2I3)) format.
162 The virtual-bond angles THETA (in degrees)
169 The virtual-bond dihedral angles GAMMA (in degrees)
173 <BR>(OMEG(I),I=2,NRES-1)
177 The polar angles ALPHA and BETA of the side-chain centers (in degrees).
181 <H3><A NAME="SECTION00032200000000000000"></A>
182 <A NAME="sect:output:coord:cart"></A>
184 The plain Cartesian coordinate (X) files
188 (Subroutine CARTOUT.)
191 This file contains the Cartesian coordinates of the
193 side-chain-center coordinates. All conformations from an MD/MREMD
194 trajectory are collated to a single file. The structure of each
195 conformation's record is as follows:
198 1st line: time, potE, uconst, t_bath,nss, (ihpb(j), jhpb(j), j=1,nss),
199 nrestr, (qfrag(i), i=1,nfrag), (qpair(i), i=1,npair),
200 (utheta(i), ugamma(i), uscdiff(i), i=1,nfrag_back)
205 <DD>time: MD time (in ``molecular time units'' 1 mtu = 48.9 fs),
208 <DD>potE: potential energy,
211 <DD>uconst: restraint energy corresponding to restraints on Q and backbone geometry,
214 <DD>t_bath: thermostat temperature,
217 <DD>nss: number of disulfide bonds,
220 <DD>ihpb(j), jhpb(j): the numbers of linked cystines for jth disulfide bond,
223 <DD>nrestr: number of restraints on q and local geometry,
226 <DD>qfrag(i): q value for ith fragment,
229 <DD>qpair(i): q value for ith pair,
232 <DD>utheta(i): sum of squares of the differences between the theta angles
233 of the current conformation from those of the experimental conformation,
236 <DD>ugamma(i): sum of squares of the differences beaten the gamma angles
237 of the current conformation from those of the experimental conformation,
240 <DD>uscdiff(i): sum of squares of the differences between the Cartesian difference
241 of the unit vector of the Cα
242 -SC axis of the current conformation from
243 those of the experimental conformation.
248 Next lines: Cartesian coordinates of the Cα
249 atoms (including dummy atoms)
250 (sequentially, 10 coordinates per line)
251 Next lines: Cartesian coordinates of the SC atoms (including glycines and
252 dummy atoms) (sequentially, 10 coordinates per line)
256 <H3><A NAME="SECTION00032300000000000000"></A>
257 <A NAME="sect:output:coord:cx"></A>
259 The compressed Cartesian coordinate (CX) files
263 These files are compressed binary files (extension cx). For each conformation,
264 the items are written in the same order as specified in section <A HREF="#sect:output:coord:cx">2.2.3</A>. For
265 MREMD runs, if TRAJ1FILE is specified on MREMD record,
266 snapshots from all trajectories are written every time the coordinates
267 are dumped. Thus, the file contains snapshot 1 from trajectory 1, ...,
268 snapshot 1 from trajectory M, snapshot 2 from trajectory 1, ..., etc.
271 The compressed cx files can be converted to pdb file by using the xdrf2pdb
272 auxiliary program (single trajectory files) or xdrf2pdb-m program (multiple
273 trajectory files from MREMD runs generated by using the TRAJ1FILE option).
274 The multiple-trajectory cx files are also input files for the auxiliary
279 <H3><A NAME="SECTION00032400000000000000"></A>
280 <A NAME="sect:output:coord:PDB"></A>
282 The Brookhaven Protein Data Bank format (PDB) files
289 These files are written in PDB standard (see. e.g.,
290 ftp://ftp.wwpdb.org/pub/pdb/doc/format_descriptions/Format_v33_Letter.pdf<FONT COLOR="#0000ff">ftp://ftp.wwpdb.org/pub/pdb/doc/format_descriptions</FONT>). The REMARK, ATOM, SSBOND, HELIX, SHEET, CONECT, TER, and ENDMDL are used.
292 (marked CA) and SC (marked CB) coordinates are output. The CONECT
293 records specify the Cα - Cα and Cα - SC virtual bonds. Secondary
294 structure is detected based on peptide-group contacts, as specified in
295 ref 12. Dummy residues are omitted from the output. If the program has
296 multiple-chain function, the presence of a dummy residue in a sequence
297 starts a new chain, which is assigned the next alphabet letter as ID, and
298 residue numbering is started over.
302 <H3><A NAME="SECTION00032500000000000000"></A>
303 <A NAME="sect:output:coord:subyll"></A>
305 The SYBYLL (MOL2) files
309 See the description of mol2 format (e.g.,
310 http://tripos.com/data/support/mol2.pdfhttp://tripos.com/data/support/mol2.pdf.
311 Similar remarks apply as for
312 the PDB format (section <A HREF="#sect:output:coord:PDB">2.2.4</A>).
316 <H2><A NAME="SECTION00033000000000000000">
317 The summary (STAT) file</A>
321 Each line of the stat file generated by MD/MREMD runs contains the following
327 <DD>step - the number of the MD step
330 <DD>time - time [unit is MTU (molecular time unit) equal to 48.9 fs]
333 <DD>Ekin - kinetic energy [kcal/mol]
336 <DD>Epot - potential energy [kcal/mol]
339 <DD>Etot - total energy (Ekin+Epot)
342 <DD>H-H0 - the difference between the cureent and initial extended Hamiltionian
343 in Nose-Hoover or Nose-Poincare runs; not present for other thermostats.
346 <DD>RMSD - root mean square deviation from the reference structure (only in
347 REFSTR has been specified)
348 itemdamax - maximum change of acceleration between two MD steps
351 <DD>fracn - fraction of native side-chain concacts (very crude, based on
355 <DD>fracnn - fraction of non-native side-chain contacts
358 <DD>co - contact order
361 <DD>temp - actual temperature [K]
364 <DD>T0 - initial (microcanonical runs) or thermostat (other run types)
368 <DD>Rgyr - radius of gyration based on Cα coordinates [A]
371 <DD>proc - in MREMD runs the number of the processor (the number of the
372 trajectory less 1); not present for other runs.
377 For an USAMPL run, the following items follow the above list:
382 <DD>iset - the number of the restraint set
385 <DD>uconst - restraint energy pertaining to q-values
388 <DD>uconst_back - restraint energy pertaining to virtual-backbone restraints
391 <DD>(qfrag(i),i=1,nfrag) - q values of the specified fragments
394 <DD>(qpair(ii2),ii2=1,npair) - q values of the specified pairs of fragments
397 <DD>(utheta(i),ugamma(i),uscdiff(i),i=1,nfrag_back) - virtual-backbone and
398 side-chain-rotamer restraint energies of the fragments specified
403 If PRINT_COMPON has been specified, the energy components are printed
404 after the items described above.
408 <H1><A NAME="SECTION00040000000000000000"></A>
409 <A NAME="sect:whamoutfiles"></A>
416 <H2><A NAME="SECTION00041000000000000000"></A>
417 <A NAME="sect:whamoutfiles:summary"></A>
425 <DD>file.out_POTxxx - output files from different processors (file.out_000 is the main output file). POT is the identifier of the sidechain-sidechain potential.
430 <DD>file_POT_GB_xxx.stat or file_POT_slice_YYXXX.stat - the summary conformation-classification file from processor xxx (each processor handles part of conformations); the second occurs if the run is partitioned into slices.
435 <DD>file.thermal or file_slice_yy.thermal - thermodynamic functions and temperature profiles of the ensemble averages (the second form if the run is partitioned into slices).
440 <DD>file_T_xxx.pdb or file_slice_yy_T_xxx.pdb - top conformations the number of these conformations is selected by the user) in PDB format.
445 <DD>file.cx - the compressed UNRES coordinate file with information to compute the probability of a given conformation at any temperature.
450 <DD>file.hist, file_slice_xx.hist, file_par_yy.hist, file_par_yy_slice_zz.x - histograms of q at MREMD temperatures.
455 <DD>file.ent, file_slice_xx.ent, file_par_yy.ent, file_par_yy_slice_xx.ent - the histogram(s) of energy density.
460 <DD>file.rmsrgy, file_par_yy.rmsrgy, file_slice_xx.rmsrgy or file_par_yy_slice_xx.rmsrgy - the 2D histogram(s) of rmsd from the experimental structure and radius of gyration.
468 <H3><A NAME="SECTION00041100000000000000"></A>
469 <A NAME="sect:whamoutfile:main:reference"></A>
471 Information of reference structure and comparing scheme
475 The following records pertain to setting up the classification of conformation aimed ultimately at obtaining a class numbers. Fragments and pairs of fragments are specified and compared against those of reference structure in terms of secondary structure, number of contacts, rmsd, virtual-bond-valence and dihedral angles, etc. Then the class number is constructed as described in ref 3. A brief description of comparison procedure is as follows:
480 <LI>Elementary fragments usually corresponding to elements of secondary or supersecondary structure are selected. Based on division into fragments, levels of structural hierarchy are defined.
484 <LI>At level 1, each fragment is checked for agreement with the corresponding fragment in the native structure. Comparison is carried out at two levels: the secondary structure agreement and the contact-pattern agreement level.
487 At the secondary structure level the secondary structure (helix, strand or undefined) in the fragment is compared with that in the native fragment in a residue-wise manner. Score 0 is assigned if the structure is different in more than 1/3 of the fragment, 1 is assigned otherwise.
490 The contact-pattern agreement level compares the contacts between the peptide groups of the backbone of the fragment and the native fragment and also compares their virtual-bond dihedral angles gamma. It is allowed to shift the sequence by up to 3 residues to obtain contact pattern match. A score of 0 is assigned if more than 1/3 of native contacts do not occur or there is more than 60 deg (usually, but this cutoff can be changed) maximum difference in gamma. Otherwise score 1 is assigned.
493 The total score of a fragment is an octal number consisting of bits hereafter referred to S (secondary structure) C (contact match) and H (sHift) (they are in the order HCS). Their values are as follows:
498 <DD>S - 1 native secondary structure; 0 otherwise,
501 <DD>C - 1 native contact pattern; 0 otherwise,
504 <DD>H - 1 contact match obtained without sequence shift 0 otherwise.
510 octal 7 (111) corresponds to native secondary structure, native contact pattern, and no need to shift the sequence for contact match;
511 octal 1 (001) corresponds to native secondary structure only (i.e., nonnative contact pattern).
515 <LI>At level 2, contacts between (i) the peptide groups or (ii) the side chains within pairs of fragments are compared. Case (i) holds when we seek contacts between the strands of a larger beta-sheet formed by two fragments, case (ii) when we seek the interhelix or helix-beta sheet contacts. Additionally, the pairs of fragments are compared with their native counterparts by rmsd.
518 Score 0 is assigned to a pair of fragments, if it has less than 2/3 native contacts and too large rmsd (a cut-off of 0.1 A/residue is set), score 1 if it has enough native contacts and sufficiently low rmsd, but the sequence has to be shifted to obtain a match, and score 2, if sufficient match is obtained without shift.
522 <LI>At level 3 and higher, triads, quadruplets,..., etc. of fragments are compared in terms of rmsd from their native counterparts (the last level corresponds to comparing whole molecules). The score (0, 1, or 2) is assigned to each composite fragment as in the case of level 2.
526 <LI>The TOTAL class number of a structure is a binary number composed of parts of scores of fragments, fragment pairs, etc. It is illustrated on the following example; it is assumed that the molecule has three fragment as in the case of 1igd.
534 level 1 level 2 level 3
535 123 123 123||1-2 1-3 2-3 1-2 1-3 2-3 || 1-2-3 | 1-2-3 ||
536 sss|ccc|hhh|| c c c | h h h || r | h ||
540 Bits s, c, and h of level 1 are explained in point 2; bits c and h of level 2 pertain to contact-pattern match and shift; bits r and h of level 3 pertain to rmsd match and shift for level 3.
544 <H2><A NAME="SECTION00042000000000000000"></A>
545 <A NAME="sect:whamoutfiles:output:main"></A>
547 The structure of the main output file (out)
551 The initial portion of the main output file, named file.out_POT_000 contains information of parameter files specified in the C-shell script, compilation info, and the UNRES numeric code of the amino-acid sequence.
552 Subsequently, actual energy-term weights and parameter files are printed. If lprint was set at .true. in parmread.F, all energy-function parameters are printed. If REFSTR was specified in the control-data list, the program then outputs the read reference-structure coordinates and partition of structure into fragments.
553 Subsequently, the information about the number of structures read in and those that were rejected is printed followed by succinct information form the iteration process. Finally, the histograms (also output separately to specific histogram files; see section 6.6) and the data of the dependence of free energy, energy, heat capacity, and conformational averages on temperature are printed (these are also output separately to file described in section <A HREF="#sect:whamoutfiles:histograms">3.5</A>).
556 The output files corresponding to non-master processors (file.out_POT_xxx where xxx
557 > 0 contain only the information up to the iteration protocol. These files can be deleted right after the run.
561 <H2><A NAME="SECTION00043000000000000000"></A>
562 <A NAME="sect:whamoutfiles:outpput:thermo"></A>
564 The thermodynamic quantity and ensemble average (thermal) files
568 The files file.thermal or file_slice_yy.thermal contain thermodynamic, ensemble-averaged conformation-dependent quantities and their temperature derivatives. The structure of a record is as follows:
571 <TABLE CELLPADDING=3>
572 <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=57>T</TD>
573 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=57>F</TD>
574 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=57>E</TD>
575 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=57>
578 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=57>rmsd</TD>
579 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=57>Rgy</TD>
580 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=57>Cv</TD>
582 <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=57>298.0</TD>
583 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=57>-83.91454</TD>
584 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=57>-305.28112</TD>
585 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=57>0.30647</TD>
586 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=57>6.28347</TD>
587 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=57>11.61204</TD>
588 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=57>0.70886E+01</TD>
593 <TABLE CELLPADDING=3>
594 <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71>
595 var(q<sub>1</sub>) ...
597 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71>var(rmsd)</TD>
598 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71>var(Rgy)</TD>
599 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71>
600 cov(q<sub>1</sub>,E) ...
602 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71>cov(rmsd,E)</TD>
603 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71>cov(Rgy,E)</TD>
605 <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71>
608 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71> </TD>
609 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71> </TD>
610 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71>
613 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71> </TD>
614 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71> </TD>
616 <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71>0.35393E-02</TD>
617 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71>0.51539E+01</TD>
618 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71>0.57012E+00</TD>
619 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71>0.43802E+00</TD>
620 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71>0.62384E+01</TD>
621 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH=71>0.33912E+01</TD>
631 <DD>T - absolute temperature (in K),
636 <DD>F - free energy at T,
641 <DD>E - average energy at T,
647 q<sub>1</sub>..q<sub>n</sub>
648 : ensemble-averaged q values at T (usually only the total q corresponding to whole molecule is requested, as in the example above, but the user can specify more than one fragment or pair of fragments for which the q's are calculated, If there is no reference structure, this entry contains a 0,
653 <DD>rmsd - ensemble-averaged root mean square deviation at T,
658 <DD>Rgy - ensemble-averaged radius of gyration computed from Calpha coordinates at T,
665 - heat capacity at T,
671 var(q<sub>1</sub>)...var(q<sub>n</sub>)
672 - variances of q's at T,
677 <DD>var(rmsd) - variance of rmsd at T,
682 <DD>var(Rgy) - variance of radius of gyration at T,
688 cov(q<sub>1</sub>,E)...cov(q<sub>n</sub>,E)
689 - covariances of q's and energy at T,
694 <DD>cov(rmsd,E) - covariance of rmsd and energy at T,
699 <DD>cov(Rgy,E) - covariance of radius of gyration and energy at T.
706 According to Camacho and Thirumalali (Europhys. Lett., 35, 627, 1996), the maximum of the variance of the radius of gyration corresponds to the collapse point of a polypeptide chain and the maximum variance of q or rmsd corresponds to the midpoint of the transition to the native structure. More precisely, these points are inflection points in the plots of the respective quantities which, with temperature-independent force field, are proportional to their covariances with energy.
710 <H2><A NAME="SECTION00044000000000000000"></A>
711 <A NAME="sect:whamoutfiles:class"></A>
713 The conformation summary with classification (stat) files
717 The stat files (with names file_POT_xxx.stat or file_POT_sliceyyxxx.stat; where yy is the number of a slice and xxx is the rank of a processor) contain the output of the classification of subsequent conformations (equally partitioned between processors). The files can be concatenated by processor rank to get a summary file. Each line has the following structure (example values are also provided):
720 <TABLE CELLPADDING=3 BORDER="1">
721 <TR><TD ALIGN="CENTER"> </TD>
722 <TD ALIGN="CENTER"> </TD>
723 <TD ALIGN="CENTER" COLSPAN=3>whole molecule</TD>
725 <TR><TD ALIGN="CENTER">No</TD>
726 <TD ALIGN="CENTER">energy</TD>
727 <TD ALIGN="CENTER">rmsd</TD>
728 <TD ALIGN="CENTER">q</TD>
729 <TD ALIGN="CENTER">ang</TD>
731 <TR><TD ALIGN="CENTER">9999</TD>
732 <TD ALIGN="CENTER">-122.42</TD>
733 <TD ALIGN="CENTER">4.285</TD>
734 <TD ALIGN="CENTER">0.3751</TD>
735 <TD ALIGN="CENTER">47.8</TD>
740 <TABLE CELLPADDING=3 BORDER="1">
741 <TR><TD ALIGN="CENTER" COLSPAN=13>level 1</TD>
743 <TR><TD ALIGN="CENTER" COLSPAN=6>frag 1</TD>
744 <TD ALIGN="CENTER" COLSPAN=3>frag 2</TD>
745 <TD ALIGN="CENTER" COLSPAN=3>frag 3</TD>
746 <TD ALIGN="CENTER">class 1</TD>
748 <TR><TD ALIGN="CENTER">n1</TD>
749 <TD ALIGN="CENTER">n2</TD>
750 <TD ALIGN="CENTER">n3</TD>
751 <TD ALIGN="CENTER">rmsd</TD>
752 <TD ALIGN="CENTER">q</TD>
753 <TD ALIGN="CENTER">ang</TD>
754 <TD ALIGN="CENTER">rmsd</TD>
755 <TD ALIGN="CENTER">q</TD>
756 <TD ALIGN="CENTER">ang</TD>
757 <TD ALIGN="CENTER">rmsd</TD>
758 <TD ALIGN="CENTER">q</TD>
759 <TD ALIGN="CENTER">ang</TD>
760 <TD ALIGN="CENTER"> </TD>
762 <TR><TD ALIGN="CENTER">4</TD>
763 <TD ALIGN="CENTER">10</TD>
764 <TD ALIGN="CENTER">21</TD>
765 <TD ALIGN="CENTER">0.6</TD>
766 <TD ALIGN="CENTER">0.33</TD>
767 <TD ALIGN="CENTER">16.7</TD>
768 <TD ALIGN="CENTER">3.6</TD>
769 <TD ALIGN="CENTER">0.42</TD>
770 <TD ALIGN="CENTER">56.3</TD>
771 <TD ALIGN="CENTER">0.7</TD>
772 <TD ALIGN="CENTER">0.12</TD>
773 <TD ALIGN="CENTER">16.5</TD>
774 <TD ALIGN="CENTER">737</TD>
779 <TABLE CELLPADDING=3 BORDER="1">
780 <TR><TD ALIGN="CENTER" COLSPAN=7>level 2</TD>
781 <TD ALIGN="CENTER" COLSPAN=3>level 3</TD>
782 <TD ALIGN="CENTER"> </TD>
784 <TR><TD ALIGN="CENTER">nc1</TD>
785 <TD ALIGN="CENTER">nc2</TD>
786 <TD ALIGN="CENTER">rmsd</TD>
787 <TD ALIGN="CENTER">q</TD>
788 <TD ALIGN="CENTER">rmsd</TD>
789 <TD ALIGN="CENTER">q</TD>
790 <TD ALIGN="CENTER">class 2</TD>
791 <TD ALIGN="CENTER">rmsd</TD>
792 <TD ALIGN="CENTER">q</TD>
793 <TD ALIGN="CENTER">class 3</TD>
794 <TD ALIGN="CENTER">class</TD>
796 <TR><TD ALIGN="CENTER">9</TD>
797 <TD ALIGN="CENTER">0</TD>
798 <TD ALIGN="CENTER">1.6</TD>
799 <TD ALIGN="CENTER">0.20</TD>
800 <TD ALIGN="CENTER">4.3</TD>
801 <TD ALIGN="CENTER">0.20</TD>
802 <TD ALIGN="CENTER">20</TD>
803 <TD ALIGN="CENTER">0</TD>
804 <TD ALIGN="CENTER">4.0</TD>
805 <TD ALIGN="CENTER">2</TD>
806 <TD ALIGN="CENTER">737.20.2</TD>
816 <DD>No - the number of the conformation.
821 <DD>``whole molecule'' denotes the characteristics of the whole molecule q = 1-Wolynes'q.
826 <DD>level 1, 2, and 3 denote the characteristics computed for the respective fragments as these levels.
831 <DD>n1, n2, n3 - number of native contacts for a given segment.
836 <DD>cl1, cl2, cl3 - group of segment classes for segments at level 1, 2, and 3, respectively.
841 <DD>class - total class of the conformation.
848 The octal/quaternary/binary numbers denoting the class for a fragment at level 1, 2, and 3, respectively, are described in
849 (Oldziej et al., <I>J. Phys. Chem. B.</I>, <B>2004</B>, 108, 16934-16949).
853 <H2><A NAME="SECTION00045000000000000000"></A>
854 <A NAME="sect:whamoutfiles:histograms"></A>
860 The histogram file with names file_[par_yy][_slice_xx].hist where xx denotes the number of the slice and yy denotes the number of the parameter if SEPARATE_PARSET was specified in input contain histograms of q at replica temperatures and energy-parameter sets; with SEPARATE_PARSET histograms corresponding to subsequent parameter sets are saved in files with par_yy infixes. The histograms are multidimensional if q is a vector (usually, however, q corresponds to the entire molecule and, consequently, the histograms are one-dimensional). The histogram files are printed if histfile and histout was specified in the control data record.
863 Each line of a histogram file corresponds to a given (multidimensional) bin in q contains the following:
869 q<sub>1</sub>,...,q<sub>n</sub>
870 at a given bin (format f6.3 for each)
874 <LI>histogram values for subsequent replica temperatures (format e20.10 for each)
878 <LI>iparm (the number of parameter set; format i5)
882 <LI>If SEPARATE_PARSET was not specified, the entries corresponding to each parameter follow one another.
889 The state density is printed to file(s) file[_slice_xx].ent. Each line contains the left boundary of the energy bin and ln(state density) followed by ``ent'' string. At present, the state density is calculated correctly only if one energy-parameter set is used.</p>
893 <H2><A NAME="SECTION00046000000000000000"></A>
894 <A NAME="sect:whamoutfiles:rmsd-rgy"></A>
896 The rmsd-radius of gyration potential of mean force files
900 These files with names file[_par_yy][_slice_xx].rmsrgy contain the two-dimensional potentials of mean force in rmsd and radius of gyration at all replica-exchange temperatures and for all energy-parameter sets.
901 A line contains the left boundaries of the radius of gyration - rmsd bin (radius of gyration first) (format 2f8.2) and the PMF values at all replica-exchange temperatures (e14.5), followed by the number of the parameter set.
902 With SEPARATE_PARSET, the PMFs corresponding to different parameter sets are printed to separate files.
906 <H2><A NAME="SECTION00047000000000000000"></A>
907 <A NAME="sect:whamoutfiles:PDB"></A>
913 The PDB files with names file_[slice_xx_]Tyyy.pdb, where Tyyy specifies a given replica temperature contain the conformations whose probabilities at replica temperature T sum to 0.99, after sorting the conformations
914 by probabilities in descending order. The PDB files follow the standard format; see ftp://ftp.wwpdb.org/pub/pdb/doc/format_descriptions/Format_v33_Letter.pdf<FONT COLOR="#0000ff">ftp://ftp.wwpdb.org/pub/pdb/doc/format_descriptions</FONT>.
915 For single-chain proteins, an example is as follows:
919 REMARK CONF 9059 TEMPERATURE 330.0 RMS 8.86
920 REMARK DIMENSIONLESS FREE ENERGY -1.12726E+02
921 REMARK ENERGY -2.22574E+01 ENTROPY -7.87818E+01
922 ATOM 1 CA VAL 1 8.480 5.714 -34.044
923 ATOM 2 CB VAL 1 9.803 5.201 -33.968
924 ATOM 3 CA ASP 2 8.284 2.028 -34.925
925 ATOM 4 CB ASP 2 7.460 0.983 -33.832
929 ATOM 115 CA LYS 58 28.446 -3.448 -12.936
930 ATOM 116 CB LYS 58 26.613 -4.175 -14.514
946 <DD>CONF is the number of the conformation from the processed slice of MREMD trajectories.
951 <DD>TEMPERATURE is the replica temperature.
956 <DD>RMS is the Calpha rmsd from the reference (experimental) structure.
961 <DD>DIMENSIONLESS FREE ENERGY is -log(probability) (equation 14 of ref 2) for the conformation at this replica temperature calculated by WHAM.
966 <DD>ENERGY is the UNRES energy of the conformation at the replica temperature (note that UNRES energy is in general temperature dependent).
971 <DD>ENTROPY is the omega of equation 15 of ref 2 of the conformation.
978 In the ATOM entries, CA denotes a Calpha atom and CB denotes UNRES side-chain atom. The CONECT entries specify the
999 The PDB files generated for oligomeric proteins are similar except that chains are separated with TER and molecules with ENDMDL records and chain identifiers are included. An example is as follows:
1003 REMARK CONF 765 TEMPERATURE 301.0 RMS 11.89
1004 REMARK DIMENSIONLESS FREE ENERGY -4.48514E+02
1005 REMARK ENERGY -3.58633E+02 ENTROPY 1.51120E+02
1006 ATOM 1 CA GLY A 1 -0.736 11.305 24.600
1007 ATOM 2 CA TYR A 2 -3.184 9.928 21.998
1008 ATOM 3 CB TYR A 2 -1.474 10.815 20.433
1012 ATOM 40 CB MET A 21 -4.033 -2.913 27.189
1013 ATOM 41 CA GLY A 22 -5.795 -10.240 27.249
1015 ATOM 42 CA GLY B 1 6.750 -6.905 19.263
1016 ATOM 43 CA TYR B 2 5.667 -4.681 16.362
1020 ATOM 163 CB MET D 21 4.439 12.326 -4.950
1021 ATOM 164 CA GLY D 22 10.096 14.370 -9.301
1039 <H2><A NAME="SECTION00048000000000000000"></A>
1040 <A NAME="sect:whamoutfiles:cx"></A>
1042 The compressed Cartesian coordinates (cx) files
1046 These files contain compressed data in the Europort Data Compression XDRF library format written by Dr. F. van Hoesel, Groeningen University (http://hpcv100.rc.rug.nl/xdrfman.htmlhttp://hpcv100.rc.rug.nl/xdrfman.html.
1047 The files are written by the cxwrite subroutine. The resulting cx file contains the omega factors to compute probabilities of conformations at any temperature and any energy-function parameters if Hamiltonian replica
1048 exchange was performed in the preceding UNRES run. The files have general names file[_par_yy][_slice_xx].cx where xx is slice number and yy is parameter-set.
1051 The items written to the cx file are as follows (the precision is 5 significant digits):
1056 <LI>Cartesian coordinates of Calpha and SC sites</p>
1058 <LI>nss (number of disulfide bonds)
1063 <LI>ihpb (first residue of a disulfide link)
1065 <LI>jhpb (second residue of a disulfide link)
1067 <LI>UNRES energy at that replica temperature that the conformation was at snapshot-recording time,
1069 <LI>ln(omega) of eq 15 of (Liwo et al., <I>J. Phys. Chem. B</I>, <B>2007</B>, 111, 260-285),
1075 <LI>conformation class number (0 if CLASSIFY was not specified).
1081 <H1><A NAME="SECTION00050000000000000000"></A>
1082 <A NAME="sect:clustoutfiles"></A>
1084 CLUSTER OUTPUT FILES
1089 <H2><A NAME="SECTION00051000000000000000"></A>
1090 <A NAME="sect:clustoutfiles:summary"></A>
1098 <DD>file_clust.out (single-processor mode) or file_clust.out_xxx (parallel mode) -
1099 output file(s) (file.out_000 is the main output file for parallel mode).
1104 <DD>file_clust.int - leading (lowest-energy) members of the families.
1105 in internal-coordinate format.
1108 <DD>file_clust.x - leading members of the families in UNRES Cartesian coordinate
1112 <DD>file_xxxx.pdb or file_xxxx_yyy.pdb (CLUST-UNRES) - PDB file of member yyy
1113 of family xxxx; yyy is omitted if the family contains only one member
1114 within a given energy cut-off.
1117 <DD>file_TxxxK_yyyy.pdb - concatenated conformations in PDB format of the
1118 members of family yyyy clustered at T=xxxK ranked by probabilities in
1119 descending order at this temperature (CLUST-WHAM).
1122 <DD>file_T_xxxK_ave.pdb - cluster-averaged coordinates and coordinates of a
1123 member of each family that is closest to the cluster average in PDB
1124 format, concatenated in a single file (CLUST-WHAM).
1129 <DD>file_clust.tex - PicTeX code of the cluster tree (effectively obsolete).
1134 <DD>file.rms - rmsds between conformations.
1142 <H2><A NAME="SECTION00052000000000000000"></A>
1143 <A NAME="sect:clustutfiles:outcoord"></A>
1145 Output coordinate files
1150 <H3><A NAME="SECTION00052100000000000000"></A>
1151 <A NAME="sect:clustoutfiles:int"></A>
1153 The internal coordinate (int) files
1157 The file with name file_clust.int contains the angles theta, gamma, alpha,
1158 and beta of all residues of the leaders (lowest UNRES energy conformations
1159 from consecutive families for CLUST-UNRES runs and lowest free energy
1160 conformations for CLUST-WHAM runs). The format is the same as that of the
1161 file output by UNRES; see section 9.1.1 of UNRES description.
1164 For CLUST-WHAM runs, the first line contains more items:
1167 <TABLE CELLPADDING=3>
1168 <TR><TD ALIGN="LEFT">number of family</TD>
1169 <TD ALIGN="LEFT">(format i5)</TD>
1171 <TR><TD ALIGN="LEFT">UNRES free energy of the conformation</TD>
1172 <TD ALIGN="LEFT">(format f12.3)</TD>
1174 <TR><TD ALIGN="LEFT">Free energy of the entire family</TD>
1175 <TD ALIGN="LEFT">(format f12.3)</TD>
1177 <TR><TD ALIGN="LEFT">number of disulfide bonds</TD>
1178 <TD ALIGN="LEFT">(format i2)</TD>
1180 <TR><TD ALIGN="LEFT">list disulfide-bonded pairs</TD>
1181 <TD ALIGN="LEFT">(format 2i3)</TD>
1183 <TR><TD ALIGN="LEFT">conformation class number (0 if not provided)</TD>
1184 <TD ALIGN="LEFT">(format i10)</TD>
1190 <H3><A NAME="SECTION00052200000000000000"></A>
1191 <A NAME="sect:clustoutfiles:card"></A>
1193 The Cartesian coordinate (x) files
1197 The file with name file_clust.x contains the Cartesian coordinates of the
1198 alpha-carbon and side-chain-center coordinates. The coordinate format is
1199 as in section 9.1.2 of UNRES description and the first line contains the
1203 <TABLE CELLPADDING=3>
1204 <TR><TD ALIGN="LEFT">Number of the family</TD>
1205 <TD ALIGN="LEFT">(format I5)</TD>
1207 <TR><TD ALIGN="LEFT">UNRES free energy of the conformation</TD>
1208 <TD ALIGN="LEFT">(format f12.3)</TD>
1210 <TR><TD ALIGN="LEFT">Free energy of the entire family</TD>
1211 <TD ALIGN="LEFT">(format f12.3)</TD>
1213 <TR><TD ALIGN="LEFT">number of disulfide bonds</TD>
1214 <TD ALIGN="LEFT">(format i2)</TD>
1216 <TR><TD ALIGN="LEFT">list disulfide-bonded pairs</TD>
1217 <TD ALIGN="LEFT">(format 2i3)</TD>
1219 <TR><TD ALIGN="LEFT">conformation class number (0 if not provided)</TD>
1220 <TD ALIGN="LEFT">(format i10)</TD>
1226 <H3><A NAME="SECTION00052300000000000000"></A>
1227 <A NAME="sect:clustoutfiles:PDB"></A>
1233 The PDB files are in standard format (see
1234 ftp://ftp.wwpdb.org/pub/pdb/doc/format_descriptions/Format_v33_Letter.pdfftp://ftp.wwpdb.org/pub/pdb/doc/format_descriptions).
1235 The ATOM records contain Calpha coordinates (CA) or UNRES side-chain-center
1236 coordinates (CB). For oligomeric proteins chain identifiers are present
1237 (A, B, ..., etc.) and each chain ends with a TER record. Coordinates of a
1238 single conformation or multiple conformations The header (REMARK) records
1239 and the contents depends on cluster run type. The next subsections are devoted
1240 to different run types.
1243 The program generates a file for each family of conformations and a summary
1244 file with ensemble-averaged conformations for all families. These are described
1245 in the two next sections.
1249 <H4><A NAME="SECTION00052310000000000000"></A>
1250 <A NAME="sect:clustoutfiles:PDB:clust-unres:family"></A>
1252 Conformation family files
1258 For each family, the file name is file_TxxxK_yyyy.pdb, where yyyy is the
1259 number of the family and xxx is the integer part of the temperature (K).
1260 The first REMARK line in the file contains the information about the free
1261 energy and average rmsd of the entire cluster and, for each conformation,
1262 the initial REMARK line contains these quantities for this conformation.
1263 Same applies to oligomeric proteins, for which the TER records separate the
1264 chains and the ENDMDL record separates conformations.
1265 An example is given below.
1269 REMARK CLUSTER 1 FREE ENERGY -7.65228E+01 AVE RMSD 8.22
1270 REMARK 1BDD L18G full clust ENERGY -7.33241E+01 RMS 10.40
1271 ATOM 1 CA VAL 1 18.059 -33.585 4.616 1.00 5.00
1272 ATOM 2 CB VAL 1 18.720 -32.797 3.592 1.00 5.00
1276 ATOM 115 CA LYS 58 29.641 -44.596 -8.159 1.00 5.00
1277 ATOM 116 CB LYS 58 27.593 -45.927 -8.930 1.00 5.00
1286 REMARK 1BDD L18G full clust ENERGY -7.33240E+01 RMS 10.04
1287 ATOM 1 CA VAL 1 3.174 2.833 -34.386 1.00 5.00
1288 ATOM 2 CB VAL 1 3.887 2.811 -33.168 1.00 5.00
1291 ATOM 115 CA LYS 58 16.682 6.695 -20.438 1.00 5.00
1292 ATOM 116 CB LYS 58 18.925 5.540 -20.776 1.00 5.00
1303 <H4><A NAME="SECTION00052320000000000000"></A>
1304 <A NAME="sect:clustoutfiles:PDB:clust-unres:average"></A>
1306 Average-structure file
1312 The file name is file_T_xxxK_ave.pdb. The entries are in pairs; the first
1313 one is cluster-averaged conformation and the second is a family member which
1314 has the lowest rmsd from this average conformation. Computing average
1315 conformations is explained in section 2.5 of ref 3. Example excerpts from
1316 an entry corresponding to a given family are shown below.
1320 REMAR AVERAGE CONFORMATIONS AT TEMPERATURE 300.00
1322 REMARK 2HEP clustering 300K ENERGY -8.22572E+01 RMS 3.29
1323 ATOM 1 CA MET 1 -17.748 48.148 -19.284 1.00 5.96
1324 ATOM 2 CB MET 1 -17.373 47.911 -19.294 1.00 6.34
1325 ATOM 3 CA ILE 2 -18.770 49.138 -18.133 1.00 3.98
1329 ATOM 80 CB PHE 41 -14.353 44.680 -15.642 1.00 2.62
1330 ATOM 81 CA ARG 42 -11.619 41.645 -13.117 1.00 4.06
1331 ATOM 82 CB ARG 42 -11.330 40.378 -13.313 1.00 5.19
1343 REMARK 2HEP clustering 300K ENERGY -8.22572E+01 RMS 3.29
1344 ATOM 1 CA MET 1 -37.698 40.489 -32.408 1.00 5.96
1345 ATOM 2 CB MET 1 -38.477 39.426 -34.159 1.00 6.34
1349 ATOM 80 CB PHE 41 -35.345 50.342 -31.371 1.00 2.62
1350 ATOM 81 CA ARG 42 -33.603 54.332 -27.130 1.00 4.06
1351 ATOM 82 CB ARG 42 -33.832 53.074 -24.415 1.00 5.19
1371 Prepared by Adam Liwo, 04/10/18