1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2 <html xmlns="http://www.w3.org/1999/xhtml">
4 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5 <meta http-equiv="X-UA-Compatible" content="IE=9"/>
6 <title>RNAlib-2.1.2: Energy evaluation</title>
7 <link href="tabs.css" rel="stylesheet" type="text/css"/>
8 <script type="text/javascript" src="jquery.js"></script>
9 <script type="text/javascript" src="dynsections.js"></script>
10 <link href="navtree.css" rel="stylesheet" type="text/css"/>
11 <script type="text/javascript" src="resize.js"></script>
12 <script type="text/javascript" src="navtree.js"></script>
13 <script type="text/javascript">
14 $(document).ready(initResizable);
16 <link href="doxygen.css" rel="stylesheet" type="text/css" />
19 <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
21 <table cellspacing="0" cellpadding="0">
23 <tr style="height: 56px;">
24 <td style="padding-left: 0.5em;">
25 <div id="projectname">RNAlib-2.1.2
32 <!-- end header part -->
33 <!-- Generated by Doxygen 1.8.1.1 -->
34 <div id="navrow1" class="tabs">
36 <li><a href="index.html"><span>Main Page</span></a></li>
37 <li><a href="pages.html"><span>Related Pages</span></a></li>
38 <li><a href="modules.html"><span>Modules</span></a></li>
39 <li><a href="annotated.html"><span>Data Structures</span></a></li>
40 <li><a href="files.html"><span>Files</span></a></li>
44 <div id="side-nav" class="ui-resizable side-nav-resizable">
46 <div id="nav-tree-contents">
49 <div id="splitbar" style="-moz-user-select:none;"
50 class="ui-resizable-handle">
53 <script type="text/javascript">
54 $(document).ready(function(){initNavTree('group__eval.html','');});
56 <div id="doc-content">
59 <a href="#func-members">Functions</a> |
60 <a href="#var-members">Variables</a> </div>
61 <div class="headertitle">
62 <div class="title">Energy evaluation</div> </div>
63 <div class="ingroups"><a class="el" href="group__folding__routines.html">RNA Secondary Structure Folding</a></div></div><!--header-->
64 <div class="contents">
66 <p>This module contains all functions and variables related to energy evaluation of sequence/structure pairs.
67 <a href="#details">More...</a></p>
68 <div id="dynsection-0" onclick="return toggleVisibility(this)" class="dynheader closed" style="cursor:pointer;">
69 <img id="dynsection-0-trigger" src="closed.png" alt="+"/> Collaboration diagram for Energy evaluation:</div>
70 <div id="dynsection-0-summary" class="dynsummary" style="display:block;">
72 <div id="dynsection-0-content" class="dyncontent" style="display:none;">
73 <center><table><tr><td><img src="group__eval.png" border="0" alt="" usemap="#group____eval"/>
74 <map name="group____eval" id="group____eval">
75 <area shape="rect" id="node2" href="group__folding__routines.html" title="This module contains all functions related to thermodynamic folding of RNAs." alt="" coords="6,5,191,46"/></map>
76 </td></tr></table></center>
78 <table class="memberdecls">
79 <tr class="heading"><td colspan="2"><h2><a name="func-members"></a>
80 Functions</h2></td></tr>
81 <tr class="memitem:gaf93986cb3cb29770ec9cca69c9fab8cf"><td class="memItemLeft" align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="group__eval.html#gaf93986cb3cb29770ec9cca69c9fab8cf">energy_of_structure</a> (const char *string, const char *structure, int verbosity_level)</td></tr>
82 <tr class="memdesc:gaf93986cb3cb29770ec9cca69c9fab8cf"><td class="mdescLeft"> </td><td class="mdescRight">Calculate the free energy of an already folded RNA using global model detail settings. <a href="#gaf93986cb3cb29770ec9cca69c9fab8cf"></a><br/></td></tr>
83 <tr class="memitem:gab5169ea4f72f250e43811463a33f4e40"><td class="memItemLeft" align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="group__eval.html#gab5169ea4f72f250e43811463a33f4e40">energy_of_struct_par</a> (const char *string, const char *structure, <a class="el" href="structparamT.html">paramT</a> *parameters, int verbosity_level)</td></tr>
84 <tr class="memdesc:gab5169ea4f72f250e43811463a33f4e40"><td class="mdescLeft"> </td><td class="mdescRight">Calculate the free energy of an already folded RNA. <a href="#gab5169ea4f72f250e43811463a33f4e40"></a><br/></td></tr>
85 <tr class="memitem:gaeb14f3664aec67fc03268ac75253f0f8"><td class="memItemLeft" align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="group__eval.html#gaeb14f3664aec67fc03268ac75253f0f8">energy_of_circ_structure</a> (const char *string, const char *structure, int verbosity_level)</td></tr>
86 <tr class="memdesc:gaeb14f3664aec67fc03268ac75253f0f8"><td class="mdescLeft"> </td><td class="mdescRight">Calculate the free energy of an already folded circular RNA. <a href="#gaeb14f3664aec67fc03268ac75253f0f8"></a><br/></td></tr>
87 <tr class="memitem:ga75dc765ee4a1177832bc817c94cf88e5"><td class="memItemLeft" align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="group__eval.html#ga75dc765ee4a1177832bc817c94cf88e5">energy_of_circ_struct_par</a> (const char *string, const char *structure, <a class="el" href="structparamT.html">paramT</a> *parameters, int verbosity_level)</td></tr>
88 <tr class="memdesc:ga75dc765ee4a1177832bc817c94cf88e5"><td class="mdescLeft"> </td><td class="mdescRight">Calculate the free energy of an already folded circular RNA. <a href="#ga75dc765ee4a1177832bc817c94cf88e5"></a><br/></td></tr>
89 <tr class="memitem:ga8831445966b761417e713360791299d8"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__eval.html#ga8831445966b761417e713360791299d8">energy_of_structure_pt</a> (const char *string, short *ptable, short *s, short *s1, int verbosity_level)</td></tr>
90 <tr class="memdesc:ga8831445966b761417e713360791299d8"><td class="mdescLeft"> </td><td class="mdescRight">Calculate the free energy of an already folded RNA. <a href="#ga8831445966b761417e713360791299d8"></a><br/></td></tr>
91 <tr class="memitem:gada4701dd7519b29da75ceac147601f4e"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__eval.html#gada4701dd7519b29da75ceac147601f4e">energy_of_struct_pt_par</a> (const char *string, short *ptable, short *s, short *s1, <a class="el" href="structparamT.html">paramT</a> *parameters, int verbosity_level)</td></tr>
92 <tr class="memdesc:gada4701dd7519b29da75ceac147601f4e"><td class="mdescLeft"> </td><td class="mdescRight">Calculate the free energy of an already folded RNA. <a href="#gada4701dd7519b29da75ceac147601f4e"></a><br/></td></tr>
93 </table><table class="memberdecls">
94 <tr class="heading"><td colspan="2"><h2><a name="var-members"></a>
95 Variables</h2></td></tr>
96 <tr class="memitem:ga567530678f6260a1a649a5beca5da4c5"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga567530678f6260a1a649a5beca5da4c5"></a>
97 int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__eval.html#ga567530678f6260a1a649a5beca5da4c5">eos_debug</a></td></tr>
98 <tr class="memdesc:ga567530678f6260a1a649a5beca5da4c5"><td class="mdescLeft"> </td><td class="mdescRight">verbose info from energy_of_struct <br/></td></tr>
100 <hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
101 <p>This module contains all functions and variables related to energy evaluation of sequence/structure pairs. </p>
102 <hr/><h2>Function Documentation</h2>
103 <a class="anchor" id="gaf93986cb3cb29770ec9cca69c9fab8cf"></a>
104 <div class="memitem">
105 <div class="memproto">
106 <table class="memname">
108 <td class="memname">float energy_of_structure </td>
110 <td class="paramtype">const char * </td>
111 <td class="paramname"><em>string</em>, </td>
114 <td class="paramkey"></td>
116 <td class="paramtype">const char * </td>
117 <td class="paramname"><em>structure</em>, </td>
120 <td class="paramkey"></td>
122 <td class="paramtype">int </td>
123 <td class="paramname"><em>verbosity_level</em> </td>
131 </div><div class="memdoc">
133 <p>Calculate the free energy of an already folded RNA using global model detail settings. </p>
134 <p>If verbosity level is set to a value >0, energies of structure elements are printed to stdout</p>
135 <dl class="section note"><dt>Note:</dt><dd>OpenMP: This function relies on several global model settings variables and thus is not to be considered threadsafe. See <a class="el" href="group__eval.html#gab5169ea4f72f250e43811463a33f4e40" title="Calculate the free energy of an already folded RNA.">energy_of_struct_par()</a> for a completely threadsafe implementation.</dd></dl>
136 <dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__eval.html#gab5169ea4f72f250e43811463a33f4e40" title="Calculate the free energy of an already folded RNA.">energy_of_struct_par()</a>, <a class="el" href="group__eval.html#gaeb14f3664aec67fc03268ac75253f0f8" title="Calculate the free energy of an already folded circular RNA.">energy_of_circ_structure()</a></dd></dl>
137 <dl class="params"><dt>Parameters:</dt><dd>
138 <table class="params">
139 <tr><td class="paramname">string</td><td>RNA sequence </td></tr>
140 <tr><td class="paramname">structure</td><td>secondary structure in dot-bracket notation </td></tr>
141 <tr><td class="paramname">verbosity_level</td><td>a flag to turn verbose output on/off </td></tr>
145 <dl class="section return"><dt>Returns:</dt><dd>the free energy of the input structure given the input sequence in kcal/mol </dd></dl>
149 <a class="anchor" id="gab5169ea4f72f250e43811463a33f4e40"></a>
150 <div class="memitem">
151 <div class="memproto">
152 <table class="memname">
154 <td class="memname">float energy_of_struct_par </td>
156 <td class="paramtype">const char * </td>
157 <td class="paramname"><em>string</em>, </td>
160 <td class="paramkey"></td>
162 <td class="paramtype">const char * </td>
163 <td class="paramname"><em>structure</em>, </td>
166 <td class="paramkey"></td>
168 <td class="paramtype"><a class="el" href="structparamT.html">paramT</a> * </td>
169 <td class="paramname"><em>parameters</em>, </td>
172 <td class="paramkey"></td>
174 <td class="paramtype">int </td>
175 <td class="paramname"><em>verbosity_level</em> </td>
183 </div><div class="memdoc">
185 <p>Calculate the free energy of an already folded RNA. </p>
186 <p>If verbosity level is set to a value >0, energies of structure elements are printed to stdout</p>
187 <dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__eval.html#gaeb14f3664aec67fc03268ac75253f0f8" title="Calculate the free energy of an already folded circular RNA.">energy_of_circ_structure()</a>, <a class="el" href="group__eval.html#ga8831445966b761417e713360791299d8" title="Calculate the free energy of an already folded RNA.">energy_of_structure_pt()</a>, <a class="el" href="group__energy__parameters.html#gac2f3ca440b7eaf4d999fb27da949fe72" title="Get precomputed energy contributions for all the known loop types.">get_scaled_parameters()</a></dd></dl>
188 <dl class="params"><dt>Parameters:</dt><dd>
189 <table class="params">
190 <tr><td class="paramname">string</td><td>RNA sequence in uppercase letters </td></tr>
191 <tr><td class="paramname">structure</td><td>Secondary structure in dot-bracket notation </td></tr>
192 <tr><td class="paramname">parameters</td><td>A data structure containing the prescaled energy contributions and the model details. </td></tr>
193 <tr><td class="paramname">verbosity_level</td><td>A flag to turn verbose output on/off </td></tr>
197 <dl class="section return"><dt>Returns:</dt><dd>The free energy of the input structure given the input sequence in kcal/mol </dd></dl>
201 <a class="anchor" id="gaeb14f3664aec67fc03268ac75253f0f8"></a>
202 <div class="memitem">
203 <div class="memproto">
204 <table class="memname">
206 <td class="memname">float energy_of_circ_structure </td>
208 <td class="paramtype">const char * </td>
209 <td class="paramname"><em>string</em>, </td>
212 <td class="paramkey"></td>
214 <td class="paramtype">const char * </td>
215 <td class="paramname"><em>structure</em>, </td>
218 <td class="paramkey"></td>
220 <td class="paramtype">int </td>
221 <td class="paramname"><em>verbosity_level</em> </td>
229 </div><div class="memdoc">
231 <p>Calculate the free energy of an already folded circular RNA. </p>
232 <dl class="section note"><dt>Note:</dt><dd>OpenMP: This function relies on several global model settings variables and thus is not to be considered threadsafe. See <a class="el" href="group__eval.html#ga75dc765ee4a1177832bc817c94cf88e5" title="Calculate the free energy of an already folded circular RNA.">energy_of_circ_struct_par()</a> for a completely threadsafe implementation.</dd></dl>
233 <p>If verbosity level is set to a value >0, energies of structure elements are printed to stdout</p>
234 <dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__eval.html#ga75dc765ee4a1177832bc817c94cf88e5" title="Calculate the free energy of an already folded circular RNA.">energy_of_circ_struct_par()</a>, <a class="el" href="group__eval.html#gab5169ea4f72f250e43811463a33f4e40" title="Calculate the free energy of an already folded RNA.">energy_of_struct_par()</a></dd></dl>
235 <dl class="params"><dt>Parameters:</dt><dd>
236 <table class="params">
237 <tr><td class="paramname">string</td><td>RNA sequence </td></tr>
238 <tr><td class="paramname">structure</td><td>Secondary structure in dot-bracket notation </td></tr>
239 <tr><td class="paramname">verbosity_level</td><td>A flag to turn verbose output on/off </td></tr>
243 <dl class="section return"><dt>Returns:</dt><dd>The free energy of the input structure given the input sequence in kcal/mol </dd></dl>
247 <a class="anchor" id="ga75dc765ee4a1177832bc817c94cf88e5"></a>
248 <div class="memitem">
249 <div class="memproto">
250 <table class="memname">
252 <td class="memname">float energy_of_circ_struct_par </td>
254 <td class="paramtype">const char * </td>
255 <td class="paramname"><em>string</em>, </td>
258 <td class="paramkey"></td>
260 <td class="paramtype">const char * </td>
261 <td class="paramname"><em>structure</em>, </td>
264 <td class="paramkey"></td>
266 <td class="paramtype"><a class="el" href="structparamT.html">paramT</a> * </td>
267 <td class="paramname"><em>parameters</em>, </td>
270 <td class="paramkey"></td>
272 <td class="paramtype">int </td>
273 <td class="paramname"><em>verbosity_level</em> </td>
281 </div><div class="memdoc">
283 <p>Calculate the free energy of an already folded circular RNA. </p>
284 <p>If verbosity level is set to a value >0, energies of structure elements are printed to stdout</p>
285 <dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__eval.html#gab5169ea4f72f250e43811463a33f4e40" title="Calculate the free energy of an already folded RNA.">energy_of_struct_par()</a>, <a class="el" href="group__energy__parameters.html#gac2f3ca440b7eaf4d999fb27da949fe72" title="Get precomputed energy contributions for all the known loop types.">get_scaled_parameters()</a></dd></dl>
286 <dl class="params"><dt>Parameters:</dt><dd>
287 <table class="params">
288 <tr><td class="paramname">string</td><td>RNA sequence </td></tr>
289 <tr><td class="paramname">structure</td><td>Secondary structure in dot-bracket notation </td></tr>
290 <tr><td class="paramname">parameters</td><td>A data structure containing the prescaled energy contributions and the model details. </td></tr>
291 <tr><td class="paramname">verbosity_level</td><td>A flag to turn verbose output on/off </td></tr>
295 <dl class="section return"><dt>Returns:</dt><dd>The free energy of the input structure given the input sequence in kcal/mol </dd></dl>
299 <a class="anchor" id="ga8831445966b761417e713360791299d8"></a>
300 <div class="memitem">
301 <div class="memproto">
302 <table class="memname">
304 <td class="memname">int energy_of_structure_pt </td>
306 <td class="paramtype">const char * </td>
307 <td class="paramname"><em>string</em>, </td>
310 <td class="paramkey"></td>
312 <td class="paramtype">short * </td>
313 <td class="paramname"><em>ptable</em>, </td>
316 <td class="paramkey"></td>
318 <td class="paramtype">short * </td>
319 <td class="paramname"><em>s</em>, </td>
322 <td class="paramkey"></td>
324 <td class="paramtype">short * </td>
325 <td class="paramname"><em>s1</em>, </td>
328 <td class="paramkey"></td>
330 <td class="paramtype">int </td>
331 <td class="paramname"><em>verbosity_level</em> </td>
339 </div><div class="memdoc">
341 <p>Calculate the free energy of an already folded RNA. </p>
342 <p>If verbosity level is set to a value >0, energies of structure elements are printed to stdout</p>
343 <dl class="section note"><dt>Note:</dt><dd>OpenMP: This function relies on several global model settings variables and thus is not to be considered threadsafe. See <a class="el" href="group__eval.html#gada4701dd7519b29da75ceac147601f4e" title="Calculate the free energy of an already folded RNA.">energy_of_struct_pt_par()</a> for a completely threadsafe implementation.</dd></dl>
344 <dl class="section see"><dt>See also:</dt><dd><a class="el" href="utils_8h.html#a89c32307ee50a0026f4a3131fac0845a" title="Create a pair table of a secondary structure.">make_pair_table()</a>, <a class="el" href="group__eval.html#gada4701dd7519b29da75ceac147601f4e" title="Calculate the free energy of an already folded RNA.">energy_of_struct_pt_par()</a></dd></dl>
345 <dl class="params"><dt>Parameters:</dt><dd>
346 <table class="params">
347 <tr><td class="paramname">string</td><td>RNA sequence </td></tr>
348 <tr><td class="paramname">ptable</td><td>the pair table of the secondary structure </td></tr>
349 <tr><td class="paramname">s</td><td>encoded RNA sequence </td></tr>
350 <tr><td class="paramname">s1</td><td>encoded RNA sequence </td></tr>
351 <tr><td class="paramname">verbosity_level</td><td>a flag to turn verbose output on/off </td></tr>
355 <dl class="section return"><dt>Returns:</dt><dd>the free energy of the input structure given the input sequence in 10kcal/mol </dd></dl>
359 <a class="anchor" id="gada4701dd7519b29da75ceac147601f4e"></a>
360 <div class="memitem">
361 <div class="memproto">
362 <table class="memname">
364 <td class="memname">int energy_of_struct_pt_par </td>
366 <td class="paramtype">const char * </td>
367 <td class="paramname"><em>string</em>, </td>
370 <td class="paramkey"></td>
372 <td class="paramtype">short * </td>
373 <td class="paramname"><em>ptable</em>, </td>
376 <td class="paramkey"></td>
378 <td class="paramtype">short * </td>
379 <td class="paramname"><em>s</em>, </td>
382 <td class="paramkey"></td>
384 <td class="paramtype">short * </td>
385 <td class="paramname"><em>s1</em>, </td>
388 <td class="paramkey"></td>
390 <td class="paramtype"><a class="el" href="structparamT.html">paramT</a> * </td>
391 <td class="paramname"><em>parameters</em>, </td>
394 <td class="paramkey"></td>
396 <td class="paramtype">int </td>
397 <td class="paramname"><em>verbosity_level</em> </td>
405 </div><div class="memdoc">
407 <p>Calculate the free energy of an already folded RNA. </p>
408 <p>If verbosity level is set to a value >0, energies of structure elements are printed to stdout</p>
409 <dl class="section see"><dt>See also:</dt><dd><a class="el" href="utils_8h.html#a89c32307ee50a0026f4a3131fac0845a" title="Create a pair table of a secondary structure.">make_pair_table()</a>, <a class="el" href="group__eval.html#gab5169ea4f72f250e43811463a33f4e40" title="Calculate the free energy of an already folded RNA.">energy_of_struct_par()</a>, <a class="el" href="group__energy__parameters.html#gac2f3ca440b7eaf4d999fb27da949fe72" title="Get precomputed energy contributions for all the known loop types.">get_scaled_parameters()</a></dd></dl>
410 <dl class="params"><dt>Parameters:</dt><dd>
411 <table class="params">
412 <tr><td class="paramname">string</td><td>RNA sequence in uppercase letters </td></tr>
413 <tr><td class="paramname">ptable</td><td>The pair table of the secondary structure </td></tr>
414 <tr><td class="paramname">s</td><td>Encoded RNA sequence </td></tr>
415 <tr><td class="paramname">s1</td><td>Encoded RNA sequence </td></tr>
416 <tr><td class="paramname">parameters</td><td>A data structure containing the prescaled energy contributions and the model details. </td></tr>
417 <tr><td class="paramname">verbosity_level</td><td>A flag to turn verbose output on/off </td></tr>
421 <dl class="section return"><dt>Returns:</dt><dd>The free energy of the input structure given the input sequence in 10kcal/mol </dd></dl>
425 </div><!-- contents -->
426 </div><!-- doc-content -->
427 <!-- start footer part -->
428 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
430 <li class="footer">Generated on Wed Jul 24 2013 13:38:59 for RNAlib-2.1.2 by
431 <a href="http://www.doxygen.org/index.html">
432 <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.1.1 </li>