$extrastylesheet
Olena  User documentation 2.1
An Image Processing Platform
 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
morpho/tree/max.hh
1 // Copyright (C) 2008, 2009 EPITA Research and Development Laboratory (LRDE)
2 //
3 // This file is part of Olena.
4 //
5 // Olena is free software: you can redistribute it and/or modify it under
6 // the terms of the GNU General Public License as published by the Free
7 // Software Foundation, version 2 of the License.
8 //
9 // Olena is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 // General Public License for more details.
13 //
14 // You should have received a copy of the GNU General Public License
15 // along with Olena. If not, see <http://www.gnu.org/licenses/>.
16 //
17 // As a special exception, you may use this file as part of a free
18 // software project without restriction. Specifically, if other files
19 // instantiate templates or use macros or inline functions from this
20 // file, or you compile this file and link it with other files to produce
21 // an executable, this file does not by itself cause the resulting
22 // executable to be covered by the GNU General Public License. This
23 // exception does not however invalidate any other reasons why the
24 // executable file might be covered by the GNU General Public License.
25 
26 #ifndef MLN_MORPHO_TREE_MAX_HH
27 # define MLN_MORPHO_TREE_MAX_HH
28 
32 
33 # include <mln/morpho/tree/compute_parent.hh>
34 # include <mln/data/sort_psites.hh>
35 
36 
37 namespace mln
38 {
39 
40  namespace morpho
41  {
42 
43  namespace tree
44  {
45 
46  // Remember:
47  // p is root iff parent(p) == p
48  // p is node iff either p is root or f(parent(p)) != f(p)
49 
50  template <typename I, typename N>
51  mln_ch_value(I, mln_psite(I))
52  max(const Image<I>& f, const Neighborhood<N>& nbh);
53 
54 
55 
56 # ifndef MLN_INCLUDE_ONLY
57 
58 
59  template <typename I, typename N>
60  inline
61  mln_ch_value(I, mln_psite(I))
62  max(const Image<I>& f_, const Neighborhood<N>& nbh_)
63  {
64  mln_trace("morpho::tree::max");
65 
66  const I& f = exact(f_);
67  const N& nbh = exact(nbh_);
68 
69  mln_precondition(f.is_valid());
70  mln_precondition(nbh.is_valid());
71 
72  // For the max-tree, childhood maps "increasing level":
73  p_array<mln_psite(I)> s = mln::data::sort_psites_increasing(f);
74  mln_ch_value(I, mln_psite(I)) output = compute_parent(f, nbh, s);
75 
76  return output;
77  }
78 
79 # endif // ! MLN_INCLUDE_ONLY
80 
81  } // end of namespace mln::morpho::tree
82 
83  } // end of namespace mln::morpho
84 
85 } // end of namespace mln
86 
87 
88 #endif // ! MLN_MORPHO_TREE_MAX_HH