~ubuntu-branches/ubuntu/vivid/tesseract/vivid

« back to all changes in this revision

Viewing changes to doc/html/a00744_source.html

  • Committer: Package Import Robot
  • Author(s): Jeff Breidenbach
  • Date: 2014-02-03 11:10:20 UTC
  • mfrom: (1.3.1) (19.1.1 experimental)
  • Revision ID: package-import@ubuntu.com-20140203111020-igquodd7pjlp3uri
Tags: 3.03.01-1
* New upstream release, includes critical fix to PDF rendering
* Complete leptonlib transition (see bug #735509)
* Promote from experimental to unstable

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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>tesseract: /usr/local/google/home/jbreiden/tesseract-ocr-read-only/ccstruct/dppoint.cpp Source File</title>
 
7
 
 
8
<link href="tabs.css" rel="stylesheet" type="text/css"/>
 
9
<link href="doxygen.css" rel="stylesheet" type="text/css" />
 
10
<link href="navtree.css" rel="stylesheet" type="text/css"/>
 
11
<script type="text/javascript" src="jquery.js"></script>
 
12
<script type="text/javascript" src="resize.js"></script>
 
13
<script type="text/javascript" src="navtree.js"></script>
 
14
<script type="text/javascript">
 
15
  $(document).ready(initResizable);
 
16
</script>
 
17
<link href="search/search.css" rel="stylesheet" type="text/css"/>
 
18
<script type="text/javascript" src="search/search.js"></script>
 
19
<script type="text/javascript">
 
20
  $(document).ready(function() { searchBox.OnSelectItem(0); });
 
21
</script>
 
22
 
 
23
</head>
 
24
<body>
 
25
<div id="top"><!-- do not remove this div! -->
 
26
 
 
27
 
 
28
<div id="titlearea">
 
29
<table cellspacing="0" cellpadding="0">
 
30
 <tbody>
 
31
 <tr style="height: 56px;">
 
32
  
 
33
  
 
34
  <td style="padding-left: 0.5em;">
 
35
   <div id="projectname">tesseract
 
36
   &#160;<span id="projectnumber">3.03</span>
 
37
   </div>
 
38
   
 
39
  </td>
 
40
  
 
41
  
 
42
  
 
43
 </tr>
 
44
 </tbody>
 
45
</table>
 
46
</div>
 
47
 
 
48
<!-- Generated by Doxygen 1.7.6.1 -->
 
49
<script type="text/javascript">
 
50
var searchBox = new SearchBox("searchBox", "search",false,'Search');
 
51
</script>
 
52
  <div id="navrow1" class="tabs">
 
53
    <ul class="tablist">
 
54
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
 
55
      <li><a href="pages.html"><span>Related&#160;Pages</span></a></li>
 
56
      <li><a href="modules.html"><span>Modules</span></a></li>
 
57
      <li><a href="namespaces.html"><span>Namespaces</span></a></li>
 
58
      <li><a href="annotated.html"><span>Classes</span></a></li>
 
59
      <li class="current"><a href="files.html"><span>Files</span></a></li>
 
60
      <li>
 
61
        <div id="MSearchBox" class="MSearchBoxInactive">
 
62
        <span class="left">
 
63
          <img id="MSearchSelect" src="search/mag_sel.png"
 
64
               onmouseover="return searchBox.OnSearchSelectShow()"
 
65
               onmouseout="return searchBox.OnSearchSelectHide()"
 
66
               alt=""/>
 
67
          <input type="text" id="MSearchField" value="Search" accesskey="S"
 
68
               onfocus="searchBox.OnSearchFieldFocus(true)" 
 
69
               onblur="searchBox.OnSearchFieldFocus(false)" 
 
70
               onkeyup="searchBox.OnSearchFieldChange(event)"/>
 
71
          </span><span class="right">
 
72
            <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
 
73
          </span>
 
74
        </div>
 
75
      </li>
 
76
    </ul>
 
77
  </div>
 
78
  <div id="navrow2" class="tabs2">
 
79
    <ul class="tablist">
 
80
      <li><a href="files.html"><span>File&#160;List</span></a></li>
 
81
      <li><a href="globals.html"><span>File&#160;Members</span></a></li>
 
82
    </ul>
 
83
  </div>
 
84
</div>
 
85
<div id="side-nav" class="ui-resizable side-nav-resizable">
 
86
  <div id="nav-tree">
 
87
    <div id="nav-tree-contents">
 
88
    </div>
 
89
  </div>
 
90
  <div id="splitbar" style="-moz-user-select:none;" 
 
91
       class="ui-resizable-handle">
 
92
  </div>
 
93
</div>
 
94
<script type="text/javascript">
 
95
  initNavTree('a00744.html','');
 
96
</script>
 
97
<div id="doc-content">
 
98
<div class="header">
 
99
  <div class="headertitle">
 
100
<div class="title">/usr/local/google/home/jbreiden/tesseract-ocr-read-only/ccstruct/dppoint.cpp</div>  </div>
 
101
</div><!--header-->
 
102
<div class="contents">
 
103
<a href="a00744.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/**********************************************************************</span>
 
104
<a name="l00002"></a>00002 <span class="comment"> * File:        dppoint.cpp</span>
 
105
<a name="l00003"></a>00003 <span class="comment"> * Description: Simple generic dynamic programming class.</span>
 
106
<a name="l00004"></a>00004 <span class="comment"> * Author:      Ray Smith</span>
 
107
<a name="l00005"></a>00005 <span class="comment"> * Created:     Wed Mar 25 19:08:01 PDT 2009</span>
 
108
<a name="l00006"></a>00006 <span class="comment"> *</span>
 
109
<a name="l00007"></a>00007 <span class="comment"> * (C) Copyright 2009, Google Inc.</span>
 
110
<a name="l00008"></a>00008 <span class="comment"> ** Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);</span>
 
111
<a name="l00009"></a>00009 <span class="comment"> ** you may not use this file except in compliance with the License.</span>
 
112
<a name="l00010"></a>00010 <span class="comment"> ** You may obtain a copy of the License at</span>
 
113
<a name="l00011"></a>00011 <span class="comment"> ** http://www.apache.org/licenses/LICENSE-2.0</span>
 
114
<a name="l00012"></a>00012 <span class="comment"> ** Unless required by applicable law or agreed to in writing, software</span>
 
115
<a name="l00013"></a>00013 <span class="comment"> ** distributed under the License is distributed on an &quot;AS IS&quot; BASIS,</span>
 
116
<a name="l00014"></a>00014 <span class="comment"> ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
 
117
<a name="l00015"></a>00015 <span class="comment"> ** See the License for the specific language governing permissions and</span>
 
118
<a name="l00016"></a>00016 <span class="comment"> ** limitations under the License.</span>
 
119
<a name="l00017"></a>00017 <span class="comment"> *</span>
 
120
<a name="l00018"></a>00018 <span class="comment"> **********************************************************************/</span>
 
121
<a name="l00019"></a>00019 
 
122
<a name="l00020"></a>00020 <span class="preprocessor">#include &quot;<a class="code" href="a00745.html">dppoint.h</a>&quot;</span>
 
123
<a name="l00021"></a>00021 <span class="preprocessor">#include &quot;<a class="code" href="a00860.html">tprintf.h</a>&quot;</span>
 
124
<a name="l00022"></a>00022 
 
125
<a name="l00023"></a>00023 <span class="keyword">namespace </span><a class="code" href="a01266.html#afed58feacb84df2de88bdd613cfdba6d">tesseract</a> {
 
126
<a name="l00024"></a>00024 
 
127
<a name="l00025"></a>00025 <span class="comment">// Solve the dynamic programming problem for the given array of points, with</span>
 
128
<a name="l00026"></a>00026 <span class="comment">// the given size and cost function.</span>
 
129
<a name="l00027"></a>00027 <span class="comment">// Steps backwards are limited to being between min_step and max_step</span>
 
130
<a name="l00028"></a>00028 <span class="comment">// inclusive.</span>
 
131
<a name="l00029"></a>00029 <span class="comment">// The return value is the tail of the best path.</span>
 
132
<a name="l00030"></a><a class="code" href="a00359.html#a9d0050679afe827f7e0434c70916a07a">00030</a> <a class="code" href="a00359.html">DPPoint</a>* <a class="code" href="a00359.html#a9d0050679afe827f7e0434c70916a07a">DPPoint::Solve</a>(<span class="keywordtype">int</span> min_step, <span class="keywordtype">int</span> max_step, <span class="keywordtype">bool</span> debug,
 
133
<a name="l00031"></a>00031                         CostFunc cost_func, <span class="keywordtype">int</span> size, <a class="code" href="a00359.html">DPPoint</a>* points) {
 
134
<a name="l00032"></a>00032   <span class="keywordflow">if</span> (size &lt;= 0 || max_step &lt; min_step || min_step &gt;= size)
 
135
<a name="l00033"></a>00033     <span class="keywordflow">return</span> NULL;  <span class="comment">// Degenerate, but not necessarily an error.</span>
 
136
<a name="l00034"></a>00034   <a class="code" href="a00823.html#a93a603f4063a6b9403d81caa245a583b">ASSERT_HOST</a>(min_step &gt; 0);  <span class="comment">// Infinite loop possible if this is not true.</span>
 
137
<a name="l00035"></a>00035   <span class="keywordflow">if</span> (debug)
 
138
<a name="l00036"></a>00036     <a class="code" href="a00860.html#a02aa7cca2c3857c14716e8cca96ace6c">tprintf</a>(<span class="stringliteral">&quot;min = %d, max=%d\n&quot;</span>,
 
139
<a name="l00037"></a>00037             min_step, max_step);
 
140
<a name="l00038"></a>00038   <span class="comment">// Evaluate the total cost at each point.</span>
 
141
<a name="l00039"></a>00039   <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i = 0; i &lt; size; ++i) {
 
142
<a name="l00040"></a>00040     <span class="keywordflow">for</span> (<span class="keywordtype">int</span> offset = min_step; offset &lt;= max_step; ++offset) {
 
143
<a name="l00041"></a>00041       <a class="code" href="a00359.html">DPPoint</a>* prev = offset &lt;= i ? points + i - offset : NULL;
 
144
<a name="l00042"></a>00042       <a class="code" href="a00831.html#ac53c9cafaf7fe16f985994c49f6b0964">inT64</a> new_cost = (points[i].*cost_func)(prev);
 
145
<a name="l00043"></a>00043       <span class="keywordflow">if</span> (points[i].best_prev_ != NULL &amp;&amp; offset &gt; min_step * 2 &amp;&amp;
 
146
<a name="l00044"></a>00044           new_cost &gt; points[i].total_cost_)
 
147
<a name="l00045"></a>00045         <span class="keywordflow">break</span>;  <span class="comment">// Find only the first minimum if going over twice the min.</span>
 
148
<a name="l00046"></a>00046     }
 
149
<a name="l00047"></a>00047     points[i].total_cost_ += points[i].local_cost_;
 
150
<a name="l00048"></a>00048     <span class="keywordflow">if</span> (debug) {
 
151
<a name="l00049"></a>00049       <a class="code" href="a00860.html#a02aa7cca2c3857c14716e8cca96ace6c">tprintf</a>(<span class="stringliteral">&quot;At point %d, local cost=%d, total_cost=%d, steps=%d\n&quot;</span>,
 
152
<a name="l00050"></a>00050               i, points[i].local_cost_, points[i].total_cost_,
 
153
<a name="l00051"></a>00051               points[i].total_steps_);
 
154
<a name="l00052"></a>00052     }
 
155
<a name="l00053"></a>00053   }
 
156
<a name="l00054"></a>00054   <span class="comment">// Now find the end of the best path and return it.</span>
 
157
<a name="l00055"></a>00055   <span class="keywordtype">int</span> best_cost = points[size - 1].total_cost_;
 
158
<a name="l00056"></a>00056   <span class="keywordtype">int</span> best_end = size - 1;
 
159
<a name="l00057"></a>00057   <span class="keywordflow">for</span> (<span class="keywordtype">int</span> end = best_end - 1; end &gt;= size - min_step; --end) {
 
160
<a name="l00058"></a>00058     <span class="keywordtype">int</span> cost = points[end].total_cost_;
 
161
<a name="l00059"></a>00059     <span class="keywordflow">if</span> (cost &lt; best_cost) {
 
162
<a name="l00060"></a>00060       best_cost = cost;
 
163
<a name="l00061"></a>00061       best_end = end;
 
164
<a name="l00062"></a>00062     }
 
165
<a name="l00063"></a>00063   }
 
166
<a name="l00064"></a>00064   <span class="keywordflow">return</span> points + best_end;
 
167
<a name="l00065"></a>00065 }
 
168
<a name="l00066"></a>00066 
 
169
<a name="l00067"></a>00067 <span class="comment">// A CostFunc that takes the variance of step into account in the cost.</span>
 
170
<a name="l00068"></a><a class="code" href="a00359.html#a4d01fa4702020ea2e3cbd89f754fc9e5">00068</a> <a class="code" href="a00831.html#ac53c9cafaf7fe16f985994c49f6b0964">inT64</a> <a class="code" href="a00359.html#a4d01fa4702020ea2e3cbd89f754fc9e5">DPPoint::CostWithVariance</a>(<span class="keyword">const</span> <a class="code" href="a00359.html">DPPoint</a>* prev) {
 
171
<a name="l00069"></a>00069   <span class="keywordflow">if</span> (prev == NULL || prev == <span class="keyword">this</span>) {
 
172
<a name="l00070"></a>00070     UpdateIfBetter(0, 1, NULL, 0, 0, 0);
 
173
<a name="l00071"></a>00071     <span class="keywordflow">return</span> 0;
 
174
<a name="l00072"></a>00072   }
 
175
<a name="l00073"></a>00073 
 
176
<a name="l00074"></a>00074   <span class="keywordtype">int</span> delta = <span class="keyword">this</span> - prev;
 
177
<a name="l00075"></a>00075   <a class="code" href="a00831.html#aba1f582fd0168f3ff9225d8c90fa9eb8">inT32</a> n = prev-&gt;n_ + 1;
 
178
<a name="l00076"></a>00076   <a class="code" href="a00831.html#aba1f582fd0168f3ff9225d8c90fa9eb8">inT32</a> sig_x = prev-&gt;sig_x_ + delta;
 
179
<a name="l00077"></a>00077   <a class="code" href="a00831.html#ac53c9cafaf7fe16f985994c49f6b0964">inT64</a> sig_xsq = prev-&gt;sig_xsq_ + delta * delta;
 
180
<a name="l00078"></a>00078   <a class="code" href="a00831.html#ac53c9cafaf7fe16f985994c49f6b0964">inT64</a> cost = (sig_xsq - sig_x * sig_x / n) / n;
 
181
<a name="l00079"></a>00079   cost += prev-&gt;total_cost_;
 
182
<a name="l00080"></a>00080   UpdateIfBetter(cost, prev-&gt;total_steps_ + 1, prev, n, sig_x, sig_xsq);
 
183
<a name="l00081"></a>00081   <span class="keywordflow">return</span> cost;
 
184
<a name="l00082"></a>00082 }
 
185
<a name="l00083"></a>00083 
 
186
<a name="l00084"></a>00084 <span class="comment">// Update the other members if the cost is lower.</span>
 
187
<a name="l00085"></a>00085 <span class="keywordtype">void</span> DPPoint::UpdateIfBetter(<a class="code" href="a00831.html#ac53c9cafaf7fe16f985994c49f6b0964">inT64</a> cost, <a class="code" href="a00831.html#aba1f582fd0168f3ff9225d8c90fa9eb8">inT32</a> steps, <span class="keyword">const</span> <a class="code" href="a00359.html">DPPoint</a>* prev,
 
188
<a name="l00086"></a>00086                              <a class="code" href="a00831.html#aba1f582fd0168f3ff9225d8c90fa9eb8">inT32</a> n, <a class="code" href="a00831.html#aba1f582fd0168f3ff9225d8c90fa9eb8">inT32</a> sig_x, <a class="code" href="a00831.html#ac53c9cafaf7fe16f985994c49f6b0964">inT64</a> sig_xsq) {
 
189
<a name="l00087"></a>00087   <span class="keywordflow">if</span> (cost &lt; total_cost_) {
 
190
<a name="l00088"></a>00088     total_cost_ = cost;
 
191
<a name="l00089"></a>00089     total_steps_ = steps;
 
192
<a name="l00090"></a>00090     best_prev_ = prev;
 
193
<a name="l00091"></a>00091     n_ = n;
 
194
<a name="l00092"></a>00092     sig_x_ = sig_x;
 
195
<a name="l00093"></a>00093     sig_xsq_ = sig_xsq;
 
196
<a name="l00094"></a>00094   }
 
197
<a name="l00095"></a>00095 }
 
198
<a name="l00096"></a>00096 
 
199
<a name="l00097"></a>00097 }  <span class="comment">// namespace tesseract.</span>
 
200
<a name="l00098"></a>00098 
 
201
</pre></div></div><!-- contents -->
 
202
</div>
 
203
<!-- window showing the filter options -->
 
204
<div id="MSearchSelectWindow"
 
205
     onmouseover="return searchBox.OnSearchSelectShow()"
 
206
     onmouseout="return searchBox.OnSearchSelectHide()"
 
207
     onkeydown="return searchBox.OnSearchSelectKey(event)">
 
208
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Classes</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&#160;</span>Namespaces</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&#160;</span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&#160;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&#160;</span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark">&#160;</span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark">&#160;</span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark">&#160;</span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark">&#160;</span>Friends</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(10)"><span class="SelectionMark">&#160;</span>Defines</a></div>
 
209
 
 
210
<!-- iframe showing the search results (closed by default) -->
 
211
<div id="MSearchResultsWindow">
 
212
<iframe src="javascript:void(0)" frameborder="0" 
 
213
        name="MSearchResults" id="MSearchResults">
 
214
</iframe>
 
215
</div>
 
216
 
 
217
  <div id="nav-path" class="navpath">
 
218
    <ul>
 
219
      <li class="navelem"><a class="el" href="a00744.html">dppoint.cpp</a>      </li>
 
220
 
 
221
    <li class="footer">Generated on Mon Feb 3 2014 10:59:07 for tesseract by
 
222
    <a href="http://www.doxygen.org/index.html">
 
223
    <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.6.1 </li>
 
224
   </ul>
 
225
 </div>
 
226
 
 
227
 
 
228
</body>
 
229
</html>