Medical Imaging Interaction Toolkit  2026.06.00
Medical Imaging Interaction Toolkit
mitk::AterialInputFunctionGenerator Class Reference

Computes the Arterial Input Function (AIF) from a 4D dynamic image and an artery mask. More...

#include <mitkAterialInputFunctionGenerator.h>

Inheritance diagram for mitk::AterialInputFunctionGenerator:
Collaboration diagram for mitk::AterialInputFunctionGenerator:

Public Member Functions

 mitkClassMacroItkParent (AterialInputFunctionGenerator, itk::Object)
 
virtual void SetDynamicImage (const Image *_arg)
 Sets the 4D input image (already in concentration units) for AIF computation. More...
 
virtual const Image * GetDynamicImage ()
 Returns the currently set 4D dynamic input image. More...
 
virtual void SetMask (const Image *_arg)
 Sets the 3D mask image defining the tumour-supplying artery ROI. More...
 
virtual const Image * GetMask ()
 Returns the currently set artery mask image. More...
 
virtual void SetHCL (double _arg)
 Sets the hematocrit level for plasma curve conversion. More...
 
virtual const double & GetHCL ()
 Returns the currently set hematocrit level. More...
 
void SetDefaultHematocritLevel ()
 Resets the hematocrit level to the default value (0.45). More...
 
double GetDefaultHematocritLevel ()
 Returns the default hematocrit level constant (0.45). More...
 
AIFBasedModelBase::AterialInputFunctionType GetAterialInputFunction ()
 Computes and returns the AIF concentration values. More...
 
ModelBase::TimeGridType GetAterialInputFunctionTimeGrid ()
 Computes and returns the AIF time grid. More...
 

Static Public Member Functions

static Pointer New ()
 

Static Public Attributes

static const double DEFAULT_HEMATOCRIT_LEVEL
 Default hematocrit level value (0.45). More...
 

Protected Member Functions

 AterialInputFunctionGenerator ()
 
 ~AterialInputFunctionGenerator () override
 
virtual void CalculateAIFAndGetResult ()
 Passes m_DynamicImage and m_Mask to the itkMaskedNaryStatisticsImageFilter and mitkExtractTimeGrid and inserts the result into m_AIFValues and m_AIFTimeGrid and modifies the Timestamp. More...
 
virtual void CheckValidInputs () const
 Makes sure that m_DynamicImage and m_Mask are set. More...
 
bool HasOutdatedResults ()
 

Protected Attributes

itk::TimeStamp m_GenerationTimeStamp
 

Detailed Description

Computes the Arterial Input Function (AIF) from a 4D dynamic image and an artery mask.

This generator takes a 4D dynamic image (already converted to concentration values) and a corresponding 3D mask defining the tumour-supplying artery. It computes the mean concentration within the mask at each time point and returns the resulting AIF values and time grid.

No signal-to-concentration conversion is performed internally; the input image must already contain concentration values. The generator uses itkMaskedNaryStatisticsImageFilter for spatial averaging and mitkExtractTimeGrid for time grid extraction.

Precondition
Both dynamic image and mask must be set before calling GetAterialInputFunction().
See also
AIFBasedModelBase, ConcentrationCurveGenerator

Definition at line 37 of file mitkAterialInputFunctionGenerator.h.

Constructor & Destructor Documentation

◆ AterialInputFunctionGenerator()

mitk::AterialInputFunctionGenerator::AterialInputFunctionGenerator ( )
inlineprotected

Definition at line 92 of file mitkAterialInputFunctionGenerator.h.

◆ ~AterialInputFunctionGenerator()

mitk::AterialInputFunctionGenerator::~AterialInputFunctionGenerator ( )
inlineoverrideprotected

Definition at line 99 of file mitkAterialInputFunctionGenerator.h.

Member Function Documentation

◆ CalculateAIFAndGetResult()

virtual void mitk::AterialInputFunctionGenerator::CalculateAIFAndGetResult ( )
protectedvirtual

Passes m_DynamicImage and m_Mask to the itkMaskedNaryStatisticsImageFilter and mitkExtractTimeGrid and inserts the result into m_AIFValues and m_AIFTimeGrid and modifies the Timestamp.

◆ CheckValidInputs()

virtual void mitk::AterialInputFunctionGenerator::CheckValidInputs ( ) const
protectedvirtual

Makes sure that m_DynamicImage and m_Mask are set.

◆ GetAterialInputFunction()

AIFBasedModelBase::AterialInputFunctionType mitk::AterialInputFunctionGenerator::GetAterialInputFunction ( )

Computes and returns the AIF concentration values.

Triggers recalculation if inputs have changed since the last computation.

Precondition
DynamicImage and Mask must be set.
Returns
Array of mean concentration values within the artery mask at each time point.

◆ GetAterialInputFunctionTimeGrid()

ModelBase::TimeGridType mitk::AterialInputFunctionGenerator::GetAterialInputFunctionTimeGrid ( )

Computes and returns the AIF time grid.

Triggers recalculation if inputs have changed since the last computation.

Precondition
DynamicImage and Mask must be set.
Returns
Time grid extracted from the dynamic image.

◆ GetDefaultHematocritLevel()

double mitk::AterialInputFunctionGenerator::GetDefaultHematocritLevel ( )
inline

Returns the default hematocrit level constant (0.45).

Returns
The default hematocrit level.

Definition at line 73 of file mitkAterialInputFunctionGenerator.h.

◆ GetDynamicImage()

virtual const Image* mitk::AterialInputFunctionGenerator::GetDynamicImage ( )
virtual

Returns the currently set 4D dynamic input image.

◆ GetHCL()

virtual const double& mitk::AterialInputFunctionGenerator::GetHCL ( )
virtual

Returns the currently set hematocrit level.

Returns
The hematocrit level.

◆ GetMask()

virtual const Image* mitk::AterialInputFunctionGenerator::GetMask ( )
virtual

Returns the currently set artery mask image.

◆ HasOutdatedResults()

bool mitk::AterialInputFunctionGenerator::HasOutdatedResults ( )
protected

◆ mitkClassMacroItkParent()

mitk::AterialInputFunctionGenerator::mitkClassMacroItkParent ( AterialInputFunctionGenerator  ,
itk::Object   
)

◆ New()

static Pointer mitk::AterialInputFunctionGenerator::New ( )
static

◆ SetDefaultHematocritLevel()

void mitk::AterialInputFunctionGenerator::SetDefaultHematocritLevel ( )
inline

Resets the hematocrit level to the default value (0.45).

Definition at line 67 of file mitkAterialInputFunctionGenerator.h.

◆ SetDynamicImage()

virtual void mitk::AterialInputFunctionGenerator::SetDynamicImage ( const Image *  _arg)
virtual

Sets the 4D input image (already in concentration units) for AIF computation.

Parameters
[in]_argThe 4D dynamic concentration image.

◆ SetHCL()

virtual void mitk::AterialInputFunctionGenerator::SetHCL ( double  _arg)
virtual

Sets the hematocrit level for plasma curve conversion.

Parameters
[in]_argHematocrit level as a fraction (e.g. 0.45).

◆ SetMask()

virtual void mitk::AterialInputFunctionGenerator::SetMask ( const Image *  _arg)
virtual

Sets the 3D mask image defining the tumour-supplying artery ROI.

Parameters
[in]_argThe artery mask image.

Member Data Documentation

◆ DEFAULT_HEMATOCRIT_LEVEL

const double mitk::AterialInputFunctionGenerator::DEFAULT_HEMATOCRIT_LEVEL
static

Default hematocrit level value (0.45).

Definition at line 64 of file mitkAterialInputFunctionGenerator.h.

◆ m_GenerationTimeStamp

itk::TimeStamp mitk::AterialInputFunctionGenerator::m_GenerationTimeStamp
protected

Definition at line 114 of file mitkAterialInputFunctionGenerator.h.


The documentation for this class was generated from the following file: