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
|
/*=========================================================================
*
* 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 itkHessian3DToVesselnessMeasureImageFilter_h
#define itkHessian3DToVesselnessMeasureImageFilter_h
#include "itkSymmetricSecondRankTensor.h"
#include "itkSymmetricEigenAnalysisImageFilter.h"
namespace itk
{
/**
* \class Hessian3DToVesselnessMeasureImageFilter
* \brief Line filter to provide a vesselness measure for tubular objects from the
* hessian matrix.
*
* The filter takes as input an image of hessian pixels
* (SymmetricSecondRankTensor pixels) and preserves pixels that have
* eigen values \f$ \lambda_3 \f$ close to 0 and \f$\lambda_2\f$ and \f$\lambda_1\f$ as
* large negative values (for bright tubular structures).
*
* \f[ | \lambda_1 | < | \lambda_2 | < | \lambda_3 | \f]
*
* \par Notes:
* The filter takes into account that the eigen values play a crucial role in
* discriminating shape and orientation of structures.
*
* \li Bright tubular structures will have low \f$\lambda_1\f$ and large negative
* values of \f$\lambda_2\f$ and \f$\lambda_3\f$.
* \li Conversely dark tubular structures will have a low value of
* \f$\lambda_1\f$ and large positive values of \f$\lambda_2\f$ and
* \f$\lambda_3\f$.
* \li Bright plate like structures have low values of \f$\lambda_1\f$ and
* \f$\lambda_2\f$ and large negative values of \f$\lambda_3\f$
* \li Dark plate like structures have low values of \f$\lambda_1\f$ and
* \f$\lambda_2\f$ and large positive values of \f$\lambda_3\f$
* \li Bright spherical (blob) like structures have all three eigen values as
* large negative numbers
* \li Dark spherical (blob) like structures have all three eigen values as
* large positive numbers
*
* This filter is used to discriminate the Bright tubular structures.
*
* \par References:
* "3D Multi-scale line filter for segmentation and visualization of
* curvilinear structures in medical images",
* Yoshinobu Sato, Shin Nakajima, Hideki Atsumi, Thomas Koller,
* Guido Gerig, Shigeyuki Yoshida, Ron Kikinis.
*
* http://www.image.med.osaka-u.ac.jp/member/yoshi/paper/linefilter.pdf
*
*
* \sa HessianRecursiveGaussianImageFilter
* \sa SymmetricEigenAnalysisImageFilter
* \sa SymmetricSecondRankTensor
*
* \ingroup IntensityImageFilters TensorObjects
*
* \ingroup ITKImageFeature
*/
template <typename TPixel>
class ITK_TEMPLATE_EXPORT Hessian3DToVesselnessMeasureImageFilter
: public ImageToImageFilter<Image<SymmetricSecondRankTensor<double, 3>, 3>, Image<TPixel, 3>>
{
public:
ITK_DISALLOW_COPY_AND_MOVE(Hessian3DToVesselnessMeasureImageFilter);
/** Standard class type aliases. */
using Self = Hessian3DToVesselnessMeasureImageFilter;
using Superclass = ImageToImageFilter<Image<SymmetricSecondRankTensor<double, 3>, 3>, Image<TPixel, 3>>;
using Pointer = SmartPointer<Self>;
using ConstPointer = SmartPointer<const Self>;
using typename Superclass::InputImageType;
using typename Superclass::OutputImageType;
using InputPixelType = typename InputImageType::PixelType;
using OutputPixelType = TPixel;
/** Image dimension = 3. */
static constexpr unsigned int ImageDimension = InputImageType::ImageDimension;
static constexpr unsigned int InputPixelDimension = InputPixelType::Dimension;
using EigenValueArrayType = FixedArray<double, Self::InputPixelDimension>;
using EigenValueImageType = Image<EigenValueArrayType, Self::ImageDimension>;
using EigenAnalysisFilterType =
SymmetricEigenAnalysisFixedDimensionImageFilter<ImageDimension, InputImageType, EigenValueImageType>;
/** \see LightObject::GetNameOfClass() */
itkOverrideGetNameOfClassMacro(Hessian3DToVesselnessMeasureImageFilter);
/** Method for creation through the object factory. */
itkNewMacro(Self);
/** Set/Get macros for alpha_1. Please refer to
* http://www.image.med.osaka-u.ac.jp/member/yoshi/paper/linefilter.pdf */
itkSetMacro(Alpha1, double);
itkGetConstMacro(Alpha1, double);
/** Set/Get macros for alpha_2. Please refer to
* http://www.image.med.osaka-u.ac.jp/member/yoshi/paper/linefilter.pdf */
itkSetMacro(Alpha2, double);
itkGetConstMacro(Alpha2, double);
#ifdef ITK_USE_CONCEPT_CHECKING
// Begin concept checking
itkConceptMacro(DoubleConvertibleToOutputCheck, (Concept::Convertible<double, OutputPixelType>));
// End concept checking
#endif
protected:
Hessian3DToVesselnessMeasureImageFilter();
~Hessian3DToVesselnessMeasureImageFilter() override = default;
void
PrintSelf(std::ostream & os, Indent indent) const override;
/** Generate Data */
void
GenerateData() override;
private:
typename EigenAnalysisFilterType::Pointer m_SymmetricEigenValueFilter{};
double m_Alpha1{};
double m_Alpha2{};
};
} // end namespace itk
#ifndef ITK_MANUAL_INSTANTIATION
# include "itkHessian3DToVesselnessMeasureImageFilter.hxx"
#endif
#endif
|
