ITK
6.0.0
Insight Toolkit
|
#include <itkRegionBasedLevelSetFunction.h>
LevelSet function that computes a speed image based on regional integrals.
This class implements a level set function that computes the speed image by integrating values on the image domain.
Based on the paper:
"An active contour model without edges" T. Chan and L. Vese. In Scale-Space Theories in Computer Vision, pages 141-151, 1999.
This code was taken from the Insight Journal paper:
"Cell Tracking using Coupled Active Surfaces for Nuclei and Membranes" https://doi.org/10.54294/wvwmf8
That is based on the papers:
"Level Set Segmentation: Active Contours without edge" https://doi.org/10.54294/8jk6oy and "Level set segmentation using coupled active surfaces" https://doi.org/10.54294/23ugmy
NOTE: The convention followed is inside of the level-set function is negative and outside is positive.
Definition at line 64 of file itkRegionBasedLevelSetFunction.h.
Classes | |
struct | GlobalDataStruct |
Static Public Attributes | |
static constexpr unsigned int | ImageDimension = Superclass::ImageDimension |
Static Public Attributes inherited from itk::FiniteDifferenceFunction< TInput > | |
static constexpr unsigned int | ImageDimension |
Static Protected Member Functions | |
static VectorType | InitializeZeroVectorConstant () |
Protected Attributes | |
ScalarValueType | m_AdvectionWeight {} |
ScalarValueType | m_AreaWeight {} |
OffsetValueType | m_Center {} |
ScalarValueType | m_CurvatureWeight {} |
HeavisideFunctionConstPointer | m_DomainFunction {} |
FeatureImageConstPointer | m_FeatureImage {} |
unsigned int | m_FunctionId {} |
InputImageConstPointer | m_InitialImage {} |
double | m_InvSpacing [Self::ImageDimension] {} |
ScalarValueType | m_Lambda1 {} |
ScalarValueType | m_Lambda2 {} |
ScalarValueType | m_OverlapPenaltyWeight {} |
ScalarValueType | m_ReinitializationSmoothingWeight {} |
SharedDataPointer | m_SharedData {} |
bool | m_UpdateC {} |
ScalarValueType | m_Volume {} |
ScalarValueType | m_VolumeMatchingWeight {} |
OffsetValueType | m_xStride [Self::ImageDimension] {} |
std::slice | x_slice [Self::ImageDimension] |
Protected Attributes inherited from itk::FiniteDifferenceFunction< TInput > | |
RadiusType | m_Radius |
PixelRealType | m_ScaleCoefficients [ImageDimension] |
Protected Attributes inherited from itk::LightObject | |
std::atomic< int > | m_ReferenceCount {} |
Static Protected Attributes | |
static double | m_DT |
static double | m_WaveDT |
static VectorType | m_ZeroVectorConstant |
Additional Inherited Members | |
Static Public Member Functions inherited from itk::LightObject | |
static void | BreakOnError () |
static Pointer | New () |
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::ConstPointer = SmartPointer<const Self> |
Definition at line 73 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::FeatureImageConstPointer = typename FeatureImageType::ConstPointer |
Definition at line 135 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::FeatureImageType = TFeature |
Definition at line 134 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::FeatureIndexType = typename FeatureImageType::IndexType |
Definition at line 137 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::FeatureOffsetType = typename FeatureImageType::OffsetType |
Definition at line 139 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::FeaturePixelType = typename FeatureImageType::PixelType |
Definition at line 136 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::FeatureSpacingType = typename FeatureImageType::SpacingType |
Definition at line 138 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::HeavisideFunctionConstPointer = typename HeavisideFunctionType::ConstPointer |
Definition at line 145 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::HeavisideFunctionType = HeavisideStepFunctionBase<InputPixelType, InputPixelType> |
Definition at line 144 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::InputImageConstPointer = typename InputImageType::ConstPointer |
Definition at line 124 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::InputImagePointer = typename InputImageType::Pointer |
Definition at line 125 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::InputImageType = TInput |
Definition at line 123 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::InputIndexType = typename InputImageType::IndexType |
Definition at line 127 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::InputIndexValueType = typename InputImageType::IndexValueType |
Definition at line 128 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::InputPixelType = typename InputImageType::PixelType |
Definition at line 126 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::InputPointType = typename InputImageType::PointType |
Definition at line 132 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::InputRegionType = typename InputImageType::RegionType |
Definition at line 131 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::InputSizeType = typename InputImageType::SizeType |
Definition at line 129 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::InputSizeValueType = typename InputImageType::SizeValueType |
Definition at line 130 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::Pointer = SmartPointer<Self> |
Definition at line 72 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::ScalarValueType = PixelType |
Definition at line 86 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::Self = RegionBasedLevelSetFunction |
Standard class type aliases.
Definition at line 70 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::SharedDataPointer = typename SharedDataType::Pointer |
Definition at line 142 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::SharedDataType = TSharedData |
Definition at line 141 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::Superclass = FiniteDifferenceFunction<TInput> |
Definition at line 71 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::TimeStepType = double |
Extract some parameters from the superclass.
Definition at line 83 of file itkRegionBasedLevelSetFunction.h.
using itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::VectorType = FixedArray<ScalarValueType, Self::ImageDimension> |
Definition at line 91 of file itkRegionBasedLevelSetFunction.h.
|
protected |
|
overrideprotecteddefault |
|
inlinevirtual |
Advection field. Default implementation returns a vector of zeros.
Definition at line 223 of file itkRegionBasedLevelSetFunction.h.
|
inlinevirtual |
This method must be defined in a subclass to implement a working function object. This method is called before the solver begins its work to produce the speed image used as the level set function's Advection field term. See LevelSetFunction for more information.
Definition at line 380 of file itkRegionBasedLevelSetFunction.h.
|
virtual |
|
protectedpure virtual |
|
protected |
Compute the global term as a combination of the internal, external, overlapping and volume regularization terms.
|
overridevirtual |
Computes the time step for an update given a global data structure. The data used in the computation may take different forms depending on the nature of the equations. This global data cannot be kept in the instance of the equation object itself since the equation object must remain stateless for thread safety. The global data is therefore managed for each thread by the finite difference solver filters.
Implements itk::FiniteDifferenceFunction< TInput >.
|
protected |
Compute Hessian Matrix.
|
protected |
|
protectedpure virtual |
|
protected |
Compute the laplacian term.
Compute the laplacian
|
protectedpure virtual |
Compute the overlap term.
[in] | featIndex | |
[out] | pr | = \( \prod_{i \neq j} H(\phi_i)\) |
Implemented in itk::ScalarRegionBasedLevelSetFunction< TInputImage, TFeatureImage, TSharedData >.
|
protectedpure virtual |
Compute Parameters for the inner and outer parts.
|
overridevirtual |
Compute the equation value.
Implements itk::FiniteDifferenceFunction< TInput >.
|
protected |
Compute the overlap term.
|
inlinevirtual |
Curvature speed can be used to spatially modify the effects of curvature . The default implementation returns one.
Definition at line 370 of file itkRegionBasedLevelSetFunction.h.
References itk::NumericTraits< T >::OneValue().
|
inline |
Definition at line 299 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Nu. Area regularization values
Definition at line 235 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Gamma. Scales all curvature weight values
Definition at line 287 of file itkRegionBasedLevelSetFunction.h.
|
inlinevirtual |
Definition at line 205 of file itkRegionBasedLevelSetFunction.h.
|
inlineoverridevirtual |
Returns a pointer to a global data structure that is passed to this object from the solver at each calculation. The idea is that the solver holds the state of any global values needed to calculate the time step, while the equation object performs the actual calculations.
The global data should also be initialized in this method.
Implements itk::FiniteDifferenceFunction< TInput >.
Definition at line 184 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Lambda1. Internal intensity difference weight
Definition at line 248 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Lambda2. External intensity difference weight
Definition at line 261 of file itkRegionBasedLevelSetFunction.h.
|
overridevirtual |
Reimplemented from itk::LightObject.
|
inline |
Gamma. Overlap penalty
Definition at line 274 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Weight of the laplacian smoothing term
Definition at line 311 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Pixel Volume = Number of pixels inside the level-set
Definition at line 337 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Volume matching weight.
Definition at line 324 of file itkRegionBasedLevelSetFunction.h.
|
inlinevirtual |
|
staticprotected |
This method's only purpose is to initialize the zero vector constant.
|
inlinevirtual |
Laplacian smoothing speed can be used to spatially modify the effects of laplacian smoothing of the level set function.
Definition at line 362 of file itkRegionBasedLevelSetFunction.h.
References itk::NumericTraits< T >::OneValue().
|
inlineoverridevirtual |
When the finite difference solver filter has finished using a global data pointer, it passes it to this method, which frees the memory.
The solver cannot free the memory because it does not know the type to which the pointer points.
Implements itk::FiniteDifferenceFunction< TInput >.
Definition at line 351 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Definition at line 294 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Nu. Area regularization values
Definition at line 230 of file itkRegionBasedLevelSetFunction.h.
|
inlinevirtual |
Gamma. Scales all curvature weight values
Definition at line 282 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Definition at line 148 of file itkRegionBasedLevelSetFunction.h.
|
inlinevirtual |
Definition at line 210 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Set function id.
Definition at line 345 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Definition at line 199 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Lambda1. Internal intensity difference weight
Definition at line 243 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Lambda2. External intensity difference weight
Definition at line 256 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Gamma. Overlap penalty
Definition at line 269 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Weight of the laplacian smoothing term
Definition at line 306 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Definition at line 174 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Pixel Volume = Number of pixels inside the level-set
Definition at line 332 of file itkRegionBasedLevelSetFunction.h.
|
inline |
Volume matching weight.
Definition at line 319 of file itkRegionBasedLevelSetFunction.h.
void itk::RegionBasedLevelSetFunction< TInput, TFeature, TSharedData >::UpdateSharedData | ( | bool | forceUpdate | ) |
|
protectedpure virtual |
Update and save the inner and outer parameters in the shared data structure.
|
staticconstexpr |
Definition at line 75 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Definition at line 418 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Area regularization weight
Definition at line 398 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Definition at line 426 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Curvature Regularization Weight
Definition at line 416 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Definition at line 395 of file itkRegionBasedLevelSetFunction.h.
|
staticprotected |
Definition at line 431 of file itkRegionBasedLevelSetFunction.h.
|
protected |
The feature image
Definition at line 391 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Definition at line 423 of file itkRegionBasedLevelSetFunction.h.
|
protected |
The initial level set image
Definition at line 388 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Definition at line 428 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Internal functional of the level set weight
Definition at line 401 of file itkRegionBasedLevelSetFunction.h.
|
protected |
External functional of the level set weight
Definition at line 404 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Overlap Penalty Weight
Definition at line 407 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Laplacian Regularization Weight
Definition at line 421 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Definition at line 393 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Definition at line 496 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Volume Constraint in pixels
Definition at line 413 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Volume Regularization Weight
Definition at line 410 of file itkRegionBasedLevelSetFunction.h.
|
staticprotected |
Definition at line 430 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Definition at line 427 of file itkRegionBasedLevelSetFunction.h.
|
staticprotected |
Zero vector constant.
Definition at line 504 of file itkRegionBasedLevelSetFunction.h.
|
protected |
Definition at line 425 of file itkRegionBasedLevelSetFunction.h.