DCMTK Version 3.6.8
OFFIS DICOM Toolkit
Public Member Functions | Static Public Member Functions | List of all members
TrcTracksStatistic Class Reference

Class representing a statistic for Tracks in Track Set. More...

+ Inheritance diagram for TrcTracksStatistic:

Public Member Functions

 TrcTracksStatistic ()
 Constructor.
 
 ~TrcTracksStatistic ()
 Destructor, frees memory.
 
virtual OFCondition read (DcmItem &source, const OFBool clearOldData=OFTrue)
 Read attributes from given item into this class. More...
 
virtual OFCondition write (DcmItem &destination)
 Write attributes from this class into given item. More...
 
virtual void resetRules ()
 Resets rules to their original values.
 
virtual OFString getName () const
 Get name of component. More...
 
virtual OFCondition set (const CodeSequenceMacro &typeCode, const CodeSequenceMacro &typeModifierCode, const CodeSequenceMacro &unitsCode, const Float32 *statisticValues, const size_t numValues)
 Set Track statistic. More...
 
virtual OFCondition get (CodeSequenceMacro &typeCode, CodeSequenceMacro &typeModifierCode, CodeSequenceMacro &unitsCode, const Float32 *&statisticValues, unsigned long &numValues)
 Get Track statistic information. More...
 
virtual OFCondition get (CodeSequenceMacro &typeCode, CodeSequenceMacro &typeModifierCode, CodeSequenceMacro &unitsCode)
 Get descriptive information of statistic. More...
 
- Public Member Functions inherited from TrcStatistic
 TrcStatistic ()
 Constructor.
 
virtual ~TrcStatistic ()
 Destructor, frees memory.
 
virtual void clearData ()
 Clears all data.
 
virtual OFCondition read (DcmItem &source, const OFBool clearOldData=OFTrue)
 Read attributes from given item into this class. More...
 
virtual OFCondition write (DcmItem &destination)
 Write attributes from this class into given item. More...
 
virtual OFCondition get (CodeSequenceMacro &typeCode, CodeSequenceMacro &typeModifierCode, CodeSequenceMacro &unitsCode)
 Get descriptive information of statistic. More...
 
virtual void resetRules ()
 Resets rules to their original values.
 
- Public Member Functions inherited from IODComponent
 IODComponent (OFshared_ptr< DcmItem > item, OFshared_ptr< IODRules > rules, IODComponent *parent=NULL)
 Constructor. More...
 
 IODComponent (IODComponent *parent=NULL)
 Constructor, creates rules and item from scratch. More...
 
IODComponentoperator= (const IODComponent &rhs)
 Assignment operator, copies contained item and rule set from rhs to "this" attribute set. More...
 
 IODComponent (const IODComponent &rhs)
 Copy constructor, copies reference to contained item and rule set to "this" attribute set. More...
 
virtual ~IODComponent ()
 Virtual Destructor.
 
void clearData ()
 Clear all attributes from the data that are handled by this module. More...
 
virtual void inventMissing ()
 Set missing values by inventing "default values". More...
 
virtual void resetRules ()=0
 Resets rules to their original values.
 
OFshared_ptr< IODRulesgetRules ()
 Get rules handled by this module. More...
 
virtual void makeOptional ()
 Make component optional by turning all attributes requirement types of it to type 3. More...
 
virtual OFString getName () const =0
 Get name of component. More...
 
DcmItemgetData ()
 Get the data handled by this module. More...
 
virtual OFCondition read (DcmItem &source, const OFBool clearOldData=OFTrue)
 Read attributes from given item into this class. More...
 
virtual OFCondition write (DcmItem &destination)
 Write attributes from this class into given item. More...
 
virtual OFCondition check (const OFBool quiet=OFFalse)
 Check whether this component's data satisfies the underlying rules. More...
 
virtual int compare (const IODComponent &rhs) const
 Comparison operator for IOD Components. More...
 

Static Public Member Functions

static OFCondition create (const CodeSequenceMacro &typeCode, const CodeSequenceMacro &typeModifierCode, const CodeSequenceMacro &unitsCode, const Float32 *statisticValues, const size_t numValues, TrcTracksStatistic *&statistic)
 Create track statistic by providing the required information. More...
 
- Static Public Member Functions inherited from IODComponent
static OFCondition read (DcmItem &source, IODRules &rules, DcmItem &destination, const OFString &componentName)
 Static helper function that reads attributes from given item into destination item, as determined by the provided rules and component name. More...
 
static OFCondition write (DcmItem &source, IODRules &rules, DcmItem &destination, const OFString &componentName)
 Static helper function that writes attributes from given item into destination item, as determined by the provided rules and component name. More...
 

Additional Inherited Members

- Protected Member Functions inherited from TrcStatistic
virtual OFCondition setCommon (const CodeSequenceMacro &typeCode, const CodeSequenceMacro &typeModifierCode, const CodeSequenceMacro &unitsCode)
 Set descriptive information of statistic. More...
 
- Protected Attributes inherited from TrcStatistic
CodeSequenceMacro m_Type
 Single item from Concept Name Code Sequence.
 
CodeSequenceMacro m_TypeModifier
 Single item from Modifier Code Sequence.
 
CodeSequenceMacro m_Units
 Single item from Unit Code Sequence.
 
OFVector< Float32 * > m_Values
 Floating Point Value(s), one for each Track in Track Set (for Track Statistic), or a single value in case of Track Set Statistic.
 
- Protected Attributes inherited from IODComponent
OFshared_ptr< DcmItemm_Item
 Shared pointer to the data handled by this class. More...
 
OFshared_ptr< IODRulesm_Rules
 Rules describing the attributes governed by this class.
 
IODComponentm_Parent
 The parent component (may be NULL) of this class.
 

Detailed Description

Class representing a statistic for Tracks in Track Set.

Besides describing information like type of statistic, region o interest and units of the statistic values, the statistic defines a single statistic value for each track. Thus the number of statistic values must be identical to the number of tracks in the containing Track Set.

Member Function Documentation

◆ create()

static OFCondition TrcTracksStatistic::create ( const CodeSequenceMacro typeCode,
const CodeSequenceMacro typeModifierCode,
const CodeSequenceMacro unitsCode,
const Float32 *  statisticValues,
const size_t  numValues,
TrcTracksStatistic *&  statistic 
)
static

Create track statistic by providing the required information.

Parameters
typeCodeThe value for which the statistic is a summary. DICOM prescribes code from CID 7263 "Diffusion Tractography Measurement Types"
typeModifierCodeThe region of interest of the statistic. DICOM prescribes code from CID 7464 "General Region of Interest Measurement Modifiers"
unitsCodeThe physical units of the statistic value. DICOM prescribes code from CID 82 "Measurement Unit".
statisticValuesThe statistic values
numValuesThe number of statistic values in statisticValues, must be equal to number of Tracks in the Track Set that this statistic applies to
statisticReturns the resulting TrcTracksStatistic object (NULL in case of any error)
Returns
EC_Normal if creation was successful, error otherwise

◆ get() [1/2]

virtual OFCondition TrcStatistic::get ( CodeSequenceMacro typeCode,
CodeSequenceMacro typeModifierCode,
CodeSequenceMacro unitsCode 
)
virtual

Get descriptive information of statistic.

Parameters
typeCodeReturns type of statistic
typeModifierCodeReturns region of interest
unitsCodeReturns physical units of the statistic value
Returns
EC_Normal if getting was successful, error otherwise.

Reimplemented from TrcStatistic.

◆ get() [2/2]

virtual OFCondition TrcTracksStatistic::get ( CodeSequenceMacro typeCode,
CodeSequenceMacro typeModifierCode,
CodeSequenceMacro unitsCode,
const Float32 *&  statisticValues,
unsigned long &  numValues 
)
virtual

Get Track statistic information.

Parameters
typeCodeReturns value for which the statistic is a summary.
typeModifierCodeReturns region of interest of the statistic.
unitsCodeReturns physical units of the statistic value.
statisticValuesReturns statistic values
numValuesReturns number of statistic values in statisticValues, should be equal to number of tracks in containing Track Set
Returns
EC_Normal if data could be retrieved, error otherwise

◆ getName()

virtual OFString TrcTracksStatistic::getName ( ) const
virtual

Get name of component.

Returns
Name of the module ("TrackStatisticsSequenceItem")

Implements IODComponent.

◆ read()

virtual OFCondition TrcTracksStatistic::read ( DcmItem source,
const OFBool  clearOldData = OFTrue 
)
virtual

Read attributes from given item into this class.

Parameters
sourceThe source to read from
clearOldDataIf OFTrue, old data is cleared before reading. Otherwise old data is overwritten (or amended)
Returns
EC_Normal if reading was successful, error otherwise

Reimplemented from TrcStatistic.

◆ set()

virtual OFCondition TrcTracksStatistic::set ( const CodeSequenceMacro typeCode,
const CodeSequenceMacro typeModifierCode,
const CodeSequenceMacro unitsCode,
const Float32 *  statisticValues,
const size_t  numValues 
)
virtual

Set Track statistic.

Parameters
typeCodeThe value for which the statistic is a summary. DICOM prescribes code from CID 7263 "Diffusion Tractography Measurement Types"
typeModifierCodeThe region of interest of the statistic. DICOM prescribes code from CID 7464 "General Region of Interest Measurement Modifiers"
unitsCodeThe physical units of the statistic value. DICOM prescribes code from CID 82 "Measurement Unit".
statisticValuesThe statistic values
numValuesThe number of statistic values in statisticValues, must equal the number of tracks in containing Track Set
Returns
EC_Normal if setting was successful, error otherwise

◆ write()

virtual OFCondition TrcTracksStatistic::write ( DcmItem destination)
virtual

Write attributes from this class into given item.

Parameters
destinationThe item to write to
Returns
EC_Normal if writing was successful, error otherwise

Reimplemented from TrcStatistic.


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


Generated on Tue Dec 19 2023 for DCMTK Version 3.6.8 by Doxygen 1.9.4