2
0
mirror of https://github.com/boostorg/gil.git synced 2026-01-26 18:42:12 +00:00
Files
gil/develop/doc/html/reference/hough__transform_8hpp_source.html
github-actions[bot] fd0a1c322c deploy: 0b24f4cdbf
2021-11-10 17:22:11 +00:00

180 lines
23 KiB
HTML

<!-- HTML header for doxygen 1.8.13-->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.17"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Generic Image Library: hough_transform.hpp Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="doxygen-boost.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div class="boost-header">
<table border="0" cellpadding="7" cellspacing="0" width="100%" summary="header">
<tr>
<td valign="top" width="300">
<h3><a href="../index.html"><img alt="Boost GIL" src="../_static/gil.png" border="0"></a></h3>
</td>
<td ><h1 align="center"><a href="../index.html"></a></h1></td>
<td></td>
</tr>
</table>
</div>
<hr/>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<!-- Generated by Doxygen 1.8.17 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(function() {
initMenu('',false,false,'search.php','Search');
});
/* @license-end */</script>
<div id="main-nav"></div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_d44c64559bbebec7f509842c48db8b23.html">include</a></li><li class="navelem"><a class="el" href="dir_1878a3f4746a95c6aad317458cc7ef80.html">boost</a></li><li class="navelem"><a class="el" href="dir_df4750f408086f9b9c1b5ee4251365ff.html">gil</a></li><li class="navelem"><a class="el" href="dir_29d7d1879aced8e7726ea9a11f3c7333.html">image_processing</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">hough_transform.hpp</div> </div>
</div><!--header-->
<div class="contents">
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span>&#160;<span class="comment">// Boost.GIL (Generic Image Library) - tests</span></div>
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span>&#160;<span class="comment">//</span></div>
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span>&#160;<span class="comment">// Copyright 2020 Olzhas Zhumabek &lt;anonymous.from.applecity@gmail.com&gt;</span></div>
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span>&#160;<span class="comment">//</span></div>
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span>&#160;<span class="comment">// Use, modification and distribution are subject to the Boost Software License,</span></div>
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span>&#160;<span class="comment">// Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at</span></div>
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span>&#160;<span class="comment">// http://www.boost.org/LICENSE_1_0.txt)</span></div>
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span>&#160;<span class="comment">//</span></div>
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span>&#160;<span class="preprocessor">#ifndef BOOST_GIL_IMAGE_PROCESSING_HOUGH_TRANSFORM_HPP</span></div>
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span>&#160;<span class="preprocessor">#define BOOST_GIL_IMAGE_PROCESSING_HOUGH_TRANSFORM_HPP</span></div>
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span>&#160; </div>
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span>&#160;<span class="preprocessor">#include &lt;algorithm&gt;</span></div>
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span>&#160;<span class="preprocessor">#include &lt;boost/gil/image_processing/hough_parameter.hpp&gt;</span></div>
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span>&#160;<span class="preprocessor">#include &lt;boost/gil/rasterization/circle.hpp&gt;</span></div>
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span>&#160;<span class="preprocessor">#include &lt;cmath&gt;</span></div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span>&#160;<span class="preprocessor">#include &lt;cstddef&gt;</span></div>
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span>&#160;<span class="preprocessor">#include &lt;iterator&gt;</span></div>
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span>&#160;<span class="preprocessor">#include &lt;vector&gt;</span></div>
<div class="line"><a name="l00019"></a><span class="lineno"> 19</span>&#160; </div>
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span>&#160;<span class="keyword">namespace </span>boost { <span class="keyword">namespace </span>gil {</div>
<div class="line"><a name="l00029"></a><span class="lineno"> 29</span>&#160; </div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span>&#160;<span class="keyword">template</span> &lt;<span class="keyword">typename</span> InputView, <span class="keyword">typename</span> OutputView&gt;</div>
<div class="line"><a name="l00037"></a><span class="lineno"><a class="line" href="group___hough_transform.html#ga2573aec8de0799351116129f7bc6d6a0"> 37</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="group___hough_transform.html#ga2573aec8de0799351116129f7bc6d6a0">hough_line_transform</a>(<span class="keyword">const</span> InputView&amp; input_view, <span class="keyword">const</span> OutputView&amp; accumulator_array,</div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span>&#160; <span class="keyword">const</span> <a class="code" href="structboost_1_1gil_1_1hough__parameter.html">hough_parameter&lt;double&gt;</a>&amp; theta,</div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span>&#160; <span class="keyword">const</span> <a class="code" href="structboost_1_1gil_1_1hough__parameter.html">hough_parameter&lt;std::ptrdiff_t&gt;</a>&amp; radius)</div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span>&#160;{</div>
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span>&#160; std::ptrdiff_t r_lower_bound = radius.start_point;</div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span>&#160; std::ptrdiff_t r_upper_bound = r_lower_bound + radius.step_size * (radius.step_count - 1);</div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span>&#160; </div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span>&#160; <span class="keywordflow">for</span> (std::ptrdiff_t y = 0; y &lt; input_view.height(); ++y)</div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span>&#160; {</div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span>&#160; <span class="keywordflow">for</span> (std::ptrdiff_t x = 0; x &lt; input_view.width(); ++x)</div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span>&#160; {</div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span>&#160; <span class="keywordflow">if</span> (!input_view(x, y)[0])</div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span>&#160; {</div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span>&#160; <span class="keywordflow">continue</span>;</div>
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span>&#160; }</div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span>&#160; </div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span>&#160; <span class="keywordflow">for</span> (std::size_t theta_index = 0; theta_index &lt; theta.step_count; ++theta_index)</div>
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span>&#160; {</div>
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span>&#160; <span class="keywordtype">double</span> theta_current =</div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>&#160; theta.start_point + theta.step_size * <span class="keyword">static_cast&lt;</span><span class="keywordtype">double</span><span class="keyword">&gt;</span>(theta_index);</div>
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span>&#160; std::ptrdiff_t current_r =</div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span>&#160; std::llround(<span class="keyword">static_cast&lt;</span><span class="keywordtype">double</span><span class="keyword">&gt;</span>(x) * std::cos(theta_current) +</div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span>&#160; <span class="keyword">static_cast&lt;</span><span class="keywordtype">double</span><span class="keyword">&gt;</span>(y) * std::sin(theta_current));</div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span>&#160; <span class="keywordflow">if</span> (current_r &lt; r_lower_bound || current_r &gt; r_upper_bound)</div>
<div class="line"><a name="l00061"></a><span class="lineno"> 61</span>&#160; {</div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span>&#160; <span class="keywordflow">continue</span>;</div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span>&#160; }</div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span>&#160; std::size_t r_index = <span class="keyword">static_cast&lt;</span>std::size_t<span class="keyword">&gt;</span>(</div>
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span>&#160; std::llround((current_r - radius.start_point) / radius.step_size));</div>
<div class="line"><a name="l00066"></a><span class="lineno"> 66</span>&#160; <span class="comment">// one more safety guard to not get out of bounds</span></div>
<div class="line"><a name="l00067"></a><span class="lineno"> 67</span>&#160; <span class="keywordflow">if</span> (r_index &lt; radius.step_count)</div>
<div class="line"><a name="l00068"></a><span class="lineno"> 68</span>&#160; {</div>
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span>&#160; accumulator_array(theta_index, r_index)[0] += 1;</div>
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span>&#160; }</div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>&#160; }</div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span>&#160; }</div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span>&#160; }</div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span>&#160;}</div>
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span>&#160; </div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span>&#160;<span class="keyword">template</span> &lt;<span class="keyword">typename</span> ImageView, <span class="keyword">typename</span> ForwardIterator, <span class="keyword">typename</span> Rasterizer&gt;</div>
<div class="line"><a name="l00084"></a><span class="lineno"><a class="line" href="group___hough_transform.html#ga5b86b273ee7d26cc61f633c24164c70f"> 84</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="group___hough_transform.html#ga5b86b273ee7d26cc61f633c24164c70f">hough_circle_transform_brute</a>(<span class="keyword">const</span> ImageView&amp; input,</div>
<div class="line"><a name="l00085"></a><span class="lineno"> 85</span>&#160; <span class="keyword">const</span> <a class="code" href="structboost_1_1gil_1_1hough__parameter.html">hough_parameter&lt;std::ptrdiff_t&gt;</a> radius_parameter,</div>
<div class="line"><a name="l00086"></a><span class="lineno"> 86</span>&#160; <span class="keyword">const</span> <a class="code" href="structboost_1_1gil_1_1hough__parameter.html">hough_parameter&lt;std::ptrdiff_t&gt;</a> x_parameter,</div>
<div class="line"><a name="l00087"></a><span class="lineno"> 87</span>&#160; <span class="keyword">const</span> <a class="code" href="structboost_1_1gil_1_1hough__parameter.html">hough_parameter&lt;std::ptrdiff_t&gt;</a>&amp; y_parameter,</div>
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span>&#160; ForwardIterator d_first, Rasterizer rasterizer)</div>
<div class="line"><a name="l00089"></a><span class="lineno"> 89</span>&#160;{</div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span>&#160; <span class="keywordflow">for</span> (std::size_t radius_index = 0; radius_index &lt; radius_parameter.step_count; ++radius_index)</div>
<div class="line"><a name="l00091"></a><span class="lineno"> 91</span>&#160; {</div>
<div class="line"><a name="l00092"></a><span class="lineno"> 92</span>&#160; <span class="keyword">const</span> <span class="keyword">auto</span> radius = radius_parameter.start_point +</div>
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span>&#160; radius_parameter.step_size * <span class="keyword">static_cast&lt;</span>std::ptrdiff_t<span class="keyword">&gt;</span>(radius_index);</div>
<div class="line"><a name="l00094"></a><span class="lineno"> 94</span>&#160; std::vector&lt;point_t&gt; circle_points(rasterizer.point_count(radius));</div>
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span>&#160; rasterizer(radius, {0, 0}, circle_points.begin());</div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span>&#160; <span class="comment">// sort by scanline to improve cache coherence for row major images</span></div>
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span>&#160; std::sort(circle_points.begin(), circle_points.end(),</div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span>&#160; [](<span class="keyword">const</span> <a class="code" href="classboost_1_1gil_1_1point.html">point_t</a>&amp; lhs, <span class="keyword">const</span> <a class="code" href="classboost_1_1gil_1_1point.html">point_t</a>&amp; rhs) { return lhs.y &lt; rhs.y; });</div>
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span>&#160; <span class="keyword">const</span> <span class="keyword">auto</span> translate = [](std::vector&lt;point_t&gt;&amp; points, <a class="code" href="classboost_1_1gil_1_1point.html">point_t</a> offset) {</div>
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span>&#160; std::transform(points.begin(), points.end(), points.begin(), [offset](<a class="code" href="classboost_1_1gil_1_1point.html">point_t</a> <a class="code" href="classboost_1_1gil_1_1point.html">point</a>) {</div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>&#160; return point_t(point.x + offset.x, point.y + offset.y);</div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>&#160; });</div>
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>&#160; };</div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>&#160; </div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>&#160; <span class="comment">// in case somebody passes iterator to likes of std::vector&lt;bool&gt;</span></div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>&#160; <span class="keyword">typename</span> std::iterator_traits&lt;ForwardIterator&gt;::reference current_image = *d_first;</div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>&#160; </div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>&#160; <span class="comment">// the algorithm has to traverse over parameter space and look at input, instead</span></div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span>&#160; <span class="comment">// of vice versa, as otherwise it will call translate too many times, as input</span></div>
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>&#160; <span class="comment">// is usually bigger than the coordinate portion of parameter space.</span></div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span>&#160; <span class="comment">// This might cause extensive cache misses</span></div>
<div class="line"><a name="l00112"></a><span class="lineno"> 112</span>&#160; <span class="keywordflow">for</span> (std::size_t x_index = 0; x_index &lt; x_parameter.step_count; ++x_index)</div>
<div class="line"><a name="l00113"></a><span class="lineno"> 113</span>&#160; {</div>
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span>&#160; <span class="keywordflow">for</span> (std::size_t y_index = 0; y_index &lt; y_parameter.step_count; ++y_index)</div>
<div class="line"><a name="l00115"></a><span class="lineno"> 115</span>&#160; {</div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span>&#160; <span class="keyword">const</span> std::ptrdiff_t x = x_parameter.start_point + x_index * x_parameter.step_size;</div>
<div class="line"><a name="l00117"></a><span class="lineno"> 117</span>&#160; <span class="keyword">const</span> std::ptrdiff_t y = y_parameter.start_point + y_index * y_parameter.step_size;</div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span>&#160; </div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span>&#160; <span class="keyword">auto</span> translated_circle = circle_points;</div>
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span>&#160; translate(translated_circle, {x, y});</div>
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>&#160; <span class="keywordflow">for</span> (<span class="keyword">const</span> <span class="keyword">auto</span>&amp; <a class="code" href="classboost_1_1gil_1_1point.html">point</a> : translated_circle)</div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>&#160; {</div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>&#160; <span class="keywordflow">if</span> (input(<a class="code" href="classboost_1_1gil_1_1point.html">point</a>))</div>
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span>&#160; {</div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span>&#160; ++current_image(x_index, y_index)[0];</div>
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span>&#160; }</div>
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span>&#160; }</div>
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span>&#160; }</div>
<div class="line"><a name="l00129"></a><span class="lineno"> 129</span>&#160; }</div>
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span>&#160; ++d_first;</div>
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span>&#160; }</div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span>&#160;}</div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span>&#160; </div>
<div class="line"><a name="l00134"></a><span class="lineno"> 134</span>&#160;}} <span class="comment">// namespace boost::gil</span></div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span>&#160; </div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span>&#160;<span class="preprocessor">#endif</span></div>
</div><!-- fragment --></div><!-- contents -->
<div class="ttc" id="astructboost_1_1gil_1_1hough__parameter_html"><div class="ttname"><a href="structboost_1_1gil_1_1hough__parameter.html">boost::gil::hough_parameter</a></div><div class="ttdoc">A type to encapsulate Hough transform parameter range.</div><div class="ttdef"><b>Definition:</b> hough_parameter.hpp:26</div></div>
<div class="ttc" id="agroup___hough_transform_html_ga2573aec8de0799351116129f7bc6d6a0"><div class="ttname"><a href="group___hough_transform.html#ga2573aec8de0799351116129f7bc6d6a0">boost::gil::hough_line_transform</a></div><div class="ttdeci">void hough_line_transform(const InputView &amp;input_view, const OutputView &amp;accumulator_array, const hough_parameter&lt; double &gt; &amp;theta, const hough_parameter&lt; std::ptrdiff_t &gt; &amp;radius)</div><div class="ttdoc">Vote for best fit of a line in parameter space.</div><div class="ttdef"><b>Definition:</b> hough_transform.hpp:37</div></div>
<div class="ttc" id="aclassboost_1_1gil_1_1point_html"><div class="ttname"><a href="classboost_1_1gil_1_1point.html">boost::gil::point&lt; std::ptrdiff_t &gt;</a></div></div>
<div class="ttc" id="agroup___hough_transform_html_ga5b86b273ee7d26cc61f633c24164c70f"><div class="ttname"><a href="group___hough_transform.html#ga5b86b273ee7d26cc61f633c24164c70f">boost::gil::hough_circle_transform_brute</a></div><div class="ttdeci">void hough_circle_transform_brute(const ImageView &amp;input, const hough_parameter&lt; std::ptrdiff_t &gt; radius_parameter, const hough_parameter&lt; std::ptrdiff_t &gt; x_parameter, const hough_parameter&lt; std::ptrdiff_t &gt; &amp;y_parameter, ForwardIterator d_first, Rasterizer rasterizer)</div><div class="ttdoc">Vote for best fit of a circle in parameter space according to rasterizer.</div><div class="ttdef"><b>Definition:</b> hough_transform.hpp:84</div></div>
<!-- HTML footer for doxygen 1.8.13-->
<!-- start footer part -->
<hr class="footer"/>
<address class="footer">
<small>
Generated by &#160;<a href="http://www.doxygen.org/index.html">doxygen</a> 1.8.17
</small>
</address>
</body>
</html>