1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
/*
//
// Copyright 2004-2011, 2013 SRI International
//
// Copyright 1997-2010 Torsten Rohlfing
//
// This file is part of the Computational Morphometry Toolkit.
//
// http://www.nitrc.org/projects/cmtk/
//
// The Computational Morphometry Toolkit is free software: you can
// redistribute it and/or modify it under the terms of the GNU General Public
// License as published by the Free Software Foundation, either version 3 of
// the License, or (at your option) any later version.
//
// The Computational Morphometry Toolkit is distributed in the hope that it
// will be useful, but WITHOUT ANY WARRANTY; without even the implied
// warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License along
// with the Computational Morphometry Toolkit. If not, see
// <http://www.gnu.org/licenses/>.
//
// $Revision: 5436 $
//
// $LastChangedDate: 2018-12-10 19:01:20 -0800 (Mon, 10 Dec 2018) $
//
// $LastChangedBy: torstenrohlfing $
//
*/
#ifndef __cmtkDataGridMorphologicalOperators_h_included_
#define __cmtkDataGridMorphologicalOperators_h_included_
#include <cmtkconfig.h>
#include <System/cmtkCannotBeCopied.h>
#include <Base/cmtkDataGrid.h>
namespace
cmtk
{
/** \addtogroup Base */
//@{
/** Morphological operators applied to a 3D grid of data.
* This class provides a selection of morphological operators that act on data arranged on
* a regular 3D grid, but do not require the real-world spacing of the grid points for
* their operation.
*/
class DataGridMorphologicalOperators :
/// Prevent copying by inheritance.
private CannotBeCopied
{
public:
/// This class.
typedef DataGridMorphologicalOperators Self;
/// Constructor: link to DataGrid object.
DataGridMorphologicalOperators( const DataGrid::SmartConstPtr& dataGrid );
/** Return map of region boundaries.
* This function returns a byte data array where each pixel is one if it is
* a boundary pixel, i.e., if one of its neighbours in this object has a
* different value than it has itself. All other pixels are set to zero.
*\param multiValued If this is set (default: false), then the resulting
* boundary map is multi valued, i.e., instead of setting boundary pixels
* to "1", they are set to the value present in the image at that location.
*\note The boundary contours are at least 2 pixels wide since "boundaryness"
* is a symmetric relationship.
*/
TypedArray::SmartPtr GetBoundaryMap( const bool multiValued = false ) const;
/// Get data after erosion operator.
TypedArray::SmartPtr GetEroded( const int iterations = 1 /*!< Number of erosion iterations. */ ) const;
/// Get data after dilation operator.
TypedArray::SmartPtr GetDilated( const int iterations = 1 /*!< Number of dilation iterations. */ ) const;
/** Get connected components of a binary image.
* All pixels with non-zero values are considered "foreground," and the result
* of this function is a partitioning of the foreground into connected components.
* Connectivity is determined based on 8 neighbours in the 3D grid.
*/
TypedArray::SmartPtr GetBinaryConnectedComponents() const;
/** Get data with region labels renumbered by decreasing region size.
* This is typically run after GetBinaryConnectedComponents() to order the
* components and be able to easily select, say, the largest k components.
*/
TypedArray::SmartPtr GetRegionsRenumberedBySize() const;
private:
/// The DataGrid object we're working on.
DataGrid::SmartConstPtr m_DataGrid;
};
} // namespace cmtk
#endif // #ifndef __cmtkDataGridMorphologicalOperators_h_included_
|
