f5df689ff49ecefe6ae39bacfcb0db27527ece18
[jabaws.git] / binaries / src / ViennaRNA / doc / html / group__kl__neighborhood__stochbt.html
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">
3 <head>
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: Stochastic Backtracking of Structures from Distance Based Partitioning</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);
15 </script>
16 <link href="doxygen.css" rel="stylesheet" type="text/css" />
17 </head>
18 <body>
19 <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
20 <div id="titlearea">
21 <table cellspacing="0" cellpadding="0">
22  <tbody>
23  <tr style="height: 56px;">
24   <td style="padding-left: 0.5em;">
25    <div id="projectname">RNAlib-2.1.2
26    </div>
27   </td>
28  </tr>
29  </tbody>
30 </table>
31 </div>
32 <!-- end header part -->
33 <!-- Generated by Doxygen 1.8.1.1 -->
34   <div id="navrow1" class="tabs">
35     <ul class="tablist">
36       <li><a href="index.html"><span>Main&#160;Page</span></a></li>
37       <li><a href="pages.html"><span>Related&#160;Pages</span></a></li>
38       <li><a href="modules.html"><span>Modules</span></a></li>
39       <li><a href="annotated.html"><span>Data&#160;Structures</span></a></li>
40       <li><a href="files.html"><span>Files</span></a></li>
41     </ul>
42   </div>
43 </div><!-- top -->
44 <div id="side-nav" class="ui-resizable side-nav-resizable">
45   <div id="nav-tree">
46     <div id="nav-tree-contents">
47     </div>
48   </div>
49   <div id="splitbar" style="-moz-user-select:none;" 
50        class="ui-resizable-handle">
51   </div>
52 </div>
53 <script type="text/javascript">
54 $(document).ready(function(){initNavTree('group__kl__neighborhood__stochbt.html','');});
55 </script>
56 <div id="doc-content">
57 <div class="header">
58   <div class="summary">
59 <a href="#func-members">Functions</a>  </div>
60   <div class="headertitle">
61 <div class="title">Stochastic Backtracking of Structures from Distance Based Partitioning</div>  </div>
62 <div class="ingroups"><a class="el" href="group__kl__neighborhood.html">Distance based partitioning of the Secondary Structure Space</a> &#124; <a class="el" href="group__subopt__stochbt.html">Stochastic backtracking in the Ensemble</a></div></div><!--header-->
63 <div class="contents">
64
65 <p>Contains functions related to stochastic backtracking from a specified distance class.  
66 <a href="#details">More...</a></p>
67 <div id="dynsection-0" onclick="return toggleVisibility(this)" class="dynheader closed" style="cursor:pointer;">
68   <img id="dynsection-0-trigger" src="closed.png" alt="+"/> Collaboration diagram for Stochastic Backtracking of Structures from Distance Based Partitioning:</div>
69 <div id="dynsection-0-summary" class="dynsummary" style="display:block;">
70 </div>
71 <div id="dynsection-0-content" class="dyncontent" style="display:none;">
72 <center><table><tr><td><img src="group__kl__neighborhood__stochbt.png" border="0" alt="" usemap="#group____kl____neighborhood____stochbt"/>
73 <map name="group____kl____neighborhood____stochbt" id="group____kl____neighborhood____stochbt">
74 <area shape="rect" id="node2" href="group__kl__neighborhood.html" title="Compute Thermodynamic properties for a Distance Class Partitioning of the Secondary Structure Space..." alt="" coords="5,5,248,46"/><area shape="rect" id="node3" href="group__subopt__stochbt.html" title="Stochastic backtracking\l in the Ensemble" alt="" coords="39,70,214,111"/></map>
75 </td></tr></table></center>
76 </div>
77 <table class="memberdecls">
78 <tr class="heading"><td colspan="2"><h2><a name="func-members"></a>
79 Functions</h2></td></tr>
80 <tr class="memitem:gae251288f50dd4ae7d315af0085775f71"><td class="memItemLeft" align="right" valign="top">char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__kl__neighborhood__stochbt.html#gae251288f50dd4ae7d315af0085775f71">TwoDpfold_pbacktrack</a> (<a class="el" href="structTwoDpfold__vars.html">TwoDpfold_vars</a> *vars, int d1, int d2)</td></tr>
81 <tr class="memdesc:gae251288f50dd4ae7d315af0085775f71"><td class="mdescLeft">&#160;</td><td class="mdescRight">Sample secondary structure representatives from a set of distance classes according to their Boltzmann probability.  <a href="#gae251288f50dd4ae7d315af0085775f71"></a><br/></td></tr>
82 <tr class="memitem:ga13430ac6a7f90df426774f131647d2c7"><td class="memItemLeft" align="right" valign="top">char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__kl__neighborhood__stochbt.html#ga13430ac6a7f90df426774f131647d2c7">TwoDpfold_pbacktrack5</a> (<a class="el" href="structTwoDpfold__vars.html">TwoDpfold_vars</a> *vars, int d1, int d2, unsigned int length)</td></tr>
83 <tr class="memdesc:ga13430ac6a7f90df426774f131647d2c7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Sample secondary structure representatives with a specified length from a set of distance classes according to their Boltzmann probability.  <a href="#ga13430ac6a7f90df426774f131647d2c7"></a><br/></td></tr>
84 </table>
85 <hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
86 <p>Contains functions related to stochastic backtracking from a specified distance class. </p>
87 <hr/><h2>Function Documentation</h2>
88 <a class="anchor" id="gae251288f50dd4ae7d315af0085775f71"></a>
89 <div class="memitem">
90 <div class="memproto">
91       <table class="memname">
92         <tr>
93           <td class="memname">char* TwoDpfold_pbacktrack </td>
94           <td>(</td>
95           <td class="paramtype"><a class="el" href="structTwoDpfold__vars.html">TwoDpfold_vars</a> *&#160;</td>
96           <td class="paramname"><em>vars</em>, </td>
97         </tr>
98         <tr>
99           <td class="paramkey"></td>
100           <td></td>
101           <td class="paramtype">int&#160;</td>
102           <td class="paramname"><em>d1</em>, </td>
103         </tr>
104         <tr>
105           <td class="paramkey"></td>
106           <td></td>
107           <td class="paramtype">int&#160;</td>
108           <td class="paramname"><em>d2</em>&#160;</td>
109         </tr>
110         <tr>
111           <td></td>
112           <td>)</td>
113           <td></td><td></td>
114         </tr>
115       </table>
116 </div><div class="memdoc">
117
118 <p>Sample secondary structure representatives from a set of distance classes according to their Boltzmann probability. </p>
119 <p>If the argument 'd1' is set to '-1', the structure will be backtracked in the distance class where all structures exceeding the maximum basepair distance to either of the references reside.</p>
120 <dl class="section pre"><dt>Precondition:</dt><dd>The argument 'vars' must contain precalculated partition function matrices, i.e. a call to <a class="el" href="group__kl__neighborhood__pf.html#ga3e1cd3b24eb635c65181182cbb4ae3eb" title="Compute the partition function for all distance classes.">TwoDpfoldList()</a> preceding this function is mandatory!</dd></dl>
121 <dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__kl__neighborhood__pf.html#ga3e1cd3b24eb635c65181182cbb4ae3eb" title="Compute the partition function for all distance classes.">TwoDpfoldList()</a></dd></dl>
122 <dl class="params"><dt>Parameters:</dt><dd>
123   <table class="params">
124     <tr><td class="paramdir">[in]</td><td class="paramname">vars</td><td>the datastructure containing all necessary folding attributes and matrices </td></tr>
125     <tr><td class="paramdir">[in]</td><td class="paramname">d1</td><td>the distance to reference1 (may be -1) </td></tr>
126     <tr><td class="paramdir">[in]</td><td class="paramname">d2</td><td>the distance to reference2 </td></tr>
127   </table>
128   </dd>
129 </dl>
130 <dl class="section return"><dt>Returns:</dt><dd>A sampled secondary structure in dot-bracket notation </dd></dl>
131
132 </div>
133 </div>
134 <a class="anchor" id="ga13430ac6a7f90df426774f131647d2c7"></a>
135 <div class="memitem">
136 <div class="memproto">
137       <table class="memname">
138         <tr>
139           <td class="memname">char* TwoDpfold_pbacktrack5 </td>
140           <td>(</td>
141           <td class="paramtype"><a class="el" href="structTwoDpfold__vars.html">TwoDpfold_vars</a> *&#160;</td>
142           <td class="paramname"><em>vars</em>, </td>
143         </tr>
144         <tr>
145           <td class="paramkey"></td>
146           <td></td>
147           <td class="paramtype">int&#160;</td>
148           <td class="paramname"><em>d1</em>, </td>
149         </tr>
150         <tr>
151           <td class="paramkey"></td>
152           <td></td>
153           <td class="paramtype">int&#160;</td>
154           <td class="paramname"><em>d2</em>, </td>
155         </tr>
156         <tr>
157           <td class="paramkey"></td>
158           <td></td>
159           <td class="paramtype">unsigned int&#160;</td>
160           <td class="paramname"><em>length</em>&#160;</td>
161         </tr>
162         <tr>
163           <td></td>
164           <td>)</td>
165           <td></td><td></td>
166         </tr>
167       </table>
168 </div><div class="memdoc">
169
170 <p>Sample secondary structure representatives with a specified length from a set of distance classes according to their Boltzmann probability. </p>
171 <p>This function does essentially the same as TwoDpfold_pbacktrack with the only difference that partial structures, i.e. structures beginning from the 5' end with a specified length of the sequence, are backtracked</p>
172 <dl class="section note"><dt>Note:</dt><dd>This function does not work (since it makes no sense) for circular RNA sequences! </dd></dl>
173 <dl class="section pre"><dt>Precondition:</dt><dd>The argument 'vars' must contain precalculated partition function matrices, i.e. a call to <a class="el" href="group__kl__neighborhood__pf.html#ga3e1cd3b24eb635c65181182cbb4ae3eb" title="Compute the partition function for all distance classes.">TwoDpfoldList()</a> preceding this function is mandatory!</dd></dl>
174 <dl class="section see"><dt>See also:</dt><dd><a class="el" href="group__kl__neighborhood__stochbt.html#gae251288f50dd4ae7d315af0085775f71" title="Sample secondary structure representatives from a set of distance classes according to their Boltzman...">TwoDpfold_pbacktrack()</a>, <a class="el" href="group__kl__neighborhood__pf.html#ga3e1cd3b24eb635c65181182cbb4ae3eb" title="Compute the partition function for all distance classes.">TwoDpfoldList()</a></dd></dl>
175 <dl class="params"><dt>Parameters:</dt><dd>
176   <table class="params">
177     <tr><td class="paramdir">[in]</td><td class="paramname">vars</td><td>the datastructure containing all necessary folding attributes and matrices </td></tr>
178     <tr><td class="paramdir">[in]</td><td class="paramname">d1</td><td>the distance to reference1 (may be -1) </td></tr>
179     <tr><td class="paramdir">[in]</td><td class="paramname">d2</td><td>the distance to reference2 </td></tr>
180     <tr><td class="paramdir">[in]</td><td class="paramname">length</td><td>the length of the structure beginning from the 5' end </td></tr>
181   </table>
182   </dd>
183 </dl>
184 <dl class="section return"><dt>Returns:</dt><dd>A sampled secondary structure in dot-bracket notation </dd></dl>
185
186 </div>
187 </div>
188 </div><!-- contents -->
189 </div><!-- doc-content -->
190 <!-- start footer part -->
191 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
192   <ul>
193     <li class="footer">Generated on Wed Jul 24 2013 13:39:00 for RNAlib-2.1.2 by
194     <a href="http://www.doxygen.org/index.html">
195     <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.1.1 </li>
196   </ul>
197 </div>
198 </body>
199 </html>