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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
|
/*=========================================================================
*
* Copyright NumFOCUS
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0.txt
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*=========================================================================*/
#ifndef itkFastMarchingExtensionImageFilter_h
#define itkFastMarchingExtensionImageFilter_h
#include "itkFastMarchingImageFilter.h"
namespace itk
{
/**
* \class FastMarchingExtensionImageFilter
* \brief Extend auxiliary variables smoothly using Fast Marching.
*
* Fast marching can be used to extend auxiliary variables smoothly
* from the zero level set. Starting from an initial position on the
* front, this class simultaneously calculate the signed distance and
* extend a set of auxiliary values.
*
* This class is templated over the level set image type, the auxiliary
* variable type and the number of auxiliary variables to extended. The initial
* front is specified by two containers: one containing the known points
* and one containing the trial points. The auxiliary variables on the front
* are represented by two auxiliary variable containers: one containing
* the value of the variables at the know points and on containing the
* value of the variables at the trail points.
*
* Implementation of this class is based on Chapter 11 of
* "Level Set Methods and Fast Marching Methods", J.A. Sethian,
* Cambridge Press, Second edition, 1999.
*
* For an alternative implementation, see itk::FastMarchingExtensionImageFilterBase.
*
* \sa FastMarchingExtensionImageFilterBase
* \sa FastMarchingImageFilter
* \sa LevelSetTypeDefault
* \sa AuxVarTypeDefault
* \ingroup LevelSetSegmentation
* \ingroup ITKFastMarching
*/
template <typename TLevelSet,
typename TAuxValue,
unsigned int VAuxDimension = 1,
typename TSpeedImage = Image<float, TLevelSet::ImageDimension>>
class ITK_TEMPLATE_EXPORT FastMarchingExtensionImageFilter : public FastMarchingImageFilter<TLevelSet, TSpeedImage>
{
public:
ITK_DISALLOW_COPY_AND_MOVE(FastMarchingExtensionImageFilter);
/** Standard class typedefs. */
using Self = FastMarchingExtensionImageFilter;
using Superclass = FastMarchingImageFilter<TLevelSet, TSpeedImage>;
using Pointer = SmartPointer<Self>;
using ConstPointer = SmartPointer<const Self>;
/** Method for creation through the object factory. */
itkNewMacro(Self);
/** \see LightObject::GetNameOfClass() */
itkOverrideGetNameOfClassMacro(FastMarchingExtensionImageFilter);
/** Inherited type alias. */
using typename Superclass::LevelSetType;
using typename Superclass::SpeedImageType;
using typename Superclass::LevelSetImageType;
/** The dimension of the level set. */
static constexpr unsigned int SetDimension = Superclass::SetDimension;
/** Number of auxiliary variables to be extended. */
static constexpr unsigned int AuxDimension = VAuxDimension;
/** AuxVarType type alias support */
using AuxVarType = AuxVarTypeDefault<TAuxValue, Self::AuxDimension, Self::SetDimension>;
using AuxValueType = typename AuxVarType::AuxValueType;
using AuxValueVectorType = typename AuxVarType::AuxValueVectorType;
using AuxValueContainer = typename AuxVarType::AuxValueContainer;
using AuxImageType = typename AuxVarType::AuxImageType;
using AuxImagePointer = typename AuxVarType::AuxImagePointer;
/** Index type alias support */
using IndexType = Index<Self::SetDimension>;
/** Get one of the extended auxiliary variable image. */
AuxImageType *
GetAuxiliaryImage(unsigned int idx);
/** Set the container auxiliary values at the initial alive points. */
void
SetAuxiliaryAliveValues(AuxValueContainer * values)
{
m_AuxAliveValues = values;
}
/** Get the container of auxiliary values at the initial alive points. */
AuxValueContainer *
GetAuxiliaryAliveValues()
{
return m_AuxAliveValues.GetPointer();
}
/** Set the container of auxiliary values at the initial trial points. */
void
SetAuxiliaryTrialValues(AuxValueContainer * values)
{
m_AuxTrialValues = values;
}
/** Get the container of auxiliary values at the initial trial points. */
typename AuxValueContainer::Pointer
GetAuxiliaryTrialValues()
{
return m_AuxTrialValues;
}
#ifdef ITK_USE_CONCEPT_CHECKING
// Begin concept checking
itkConceptMacro(AuxValueHasNumericTraitsCheck, (Concept::HasNumericTraits<TAuxValue>));
// End concept checking
#endif
protected:
FastMarchingExtensionImageFilter();
~FastMarchingExtensionImageFilter() override = default;
void
PrintSelf(std::ostream & os, Indent indent) const override;
void
Initialize(LevelSetImageType *) override;
double
UpdateValue(const IndexType & index, const SpeedImageType * speed, LevelSetImageType * output) override;
/** Generate the output image meta information */
void
GenerateOutputInformation() override;
void
EnlargeOutputRequestedRegion(DataObject * output) override;
private:
typename AuxValueContainer::Pointer m_AuxAliveValues{};
typename AuxValueContainer::Pointer m_AuxTrialValues{};
AuxImageType * m_AuxImages[AuxDimension]{};
};
} // namespace itk
#ifndef ITK_MANUAL_INSTANTIATION
# include "itkFastMarchingExtensionImageFilter.hxx"
#endif
#endif
|
