DCMTK
Version 3.6.2
OFFIS DICOM Toolkit
|
Class for SR numeric values and measurements (extended version with additional support of the DICOM Content Mapping Resource). More...
Public Member Functions | |
CMR_SRNumericMeasurementValue () | |
default constructor | |
CMR_SRNumericMeasurementValue (const OFString &numericValue, const DSRCodedEntryValue &measurementUnit, const OFBool check=OFTrue) | |
constructor More... | |
CMR_SRNumericMeasurementValue (const CID42_NumericValueQualifier &valueQualifier, const OFBool check=OFTrue) | |
constructor More... | |
CMR_SRNumericMeasurementValue (const OFString &numericValue, const DSRCodedEntryValue &measurementUnit, const CID42_NumericValueQualifier &valueQualifier, const OFBool check=OFTrue) | |
constructor More... | |
CMR_SRNumericMeasurementValue (const CMR_SRNumericMeasurementValue &numericMeasurement) | |
copy constructor More... | |
CMR_SRNumericMeasurementValue (const DSRNumericMeasurementValue &numericMeasurement) | |
copy constructor More... | |
virtual | ~CMR_SRNumericMeasurementValue () |
destructor | |
CMR_SRNumericMeasurementValue & | operator= (const CMR_SRNumericMeasurementValue &numericMeasurement) |
assignment operator More... | |
OFCondition | setValue (const CID42_NumericValueQualifier &valueQualifier, const OFBool check=OFTrue) |
set empty numeric value and measurement unit with a numeric value qualifier. More... | |
OFCondition | setValue (const OFString &numericValue, const DSRCodedEntryValue &measurementUnit, const CID42_NumericValueQualifier &valueQualifier, const OFBool check=OFTrue) |
set numeric value, measurement unit and numeric value qualifier. More... | |
OFCondition | setNumericValueQualifier (const CID42_NumericValueQualifier &valueQualifier, const OFBool check=OFTrue) |
set numeric value qualifier. More... | |
![]() | |
DSRNumericMeasurementValue () | |
default constructor | |
DSRNumericMeasurementValue (const OFString &numericValue, const DSRCodedEntryValue &measurementUnit, const OFBool check=OFTrue) | |
constructor More... | |
DSRNumericMeasurementValue (const DSRCodedEntryValue &valueQualifier, const OFBool check=OFTrue) | |
constructor More... | |
DSRNumericMeasurementValue (const OFString &numericValue, const DSRCodedEntryValue &measurementUnit, const DSRCodedEntryValue &valueQualifier, const OFBool check=OFTrue) | |
constructor More... | |
DSRNumericMeasurementValue (const DSRNumericMeasurementValue &numericMeasurement) | |
copy constructor More... | |
virtual | ~DSRNumericMeasurementValue () |
destructor | |
DSRNumericMeasurementValue & | operator= (const DSRNumericMeasurementValue &numericMeasurement) |
assignment operator More... | |
virtual void | clear () |
clear all internal variables. More... | |
virtual OFBool | isValid () const |
check whether the current numeric measurement value is valid. More... | |
virtual OFBool | isEmpty () const |
check whether the current numeric measurement value is empty. More... | |
virtual OFBool | isComplete () const |
check whether the current numeric measurement value is complete, i.e. whether the numeric value is non-empty and the measurement unit is complete, or whether the value qualifier is complete. More... | |
virtual OFCondition | print (STD_NAMESPACE ostream &stream, const size_t flags) const |
print numeric measurement value. More... | |
virtual OFCondition | readXML (const DSRXMLDocument &doc, DSRXMLCursor cursor, const size_t flags) |
read numeric measurement value from XML document More... | |
virtual OFCondition | writeXML (STD_NAMESPACE ostream &stream, const size_t flags) const |
write numeric measurement value in XML format More... | |
virtual OFCondition | readSequence (DcmItem &dataset, const size_t flags) |
read measured value sequence and numeric value qualifier code sequence from dataset. More... | |
virtual OFCondition | writeSequence (DcmItem &dataset) const |
write measured value sequence and numeric value qualifier code sequence to dataset. More... | |
virtual OFCondition | renderHTML (STD_NAMESPACE ostream &docStream, STD_NAMESPACE ostream &annexStream, size_t &annexNumber, const size_t flags) const |
render numeric measurement value in HTML/XHTML format More... | |
const DSRNumericMeasurementValue & | getValue () const |
get reference to numeric measurement value More... | |
OFCondition | getValue (DSRNumericMeasurementValue &numericMeasurement) const |
get copy of numeric measurement value More... | |
const OFString & | getNumericValue () const |
get numeric value More... | |
const DSRCodedEntryValue & | getMeasurementUnit () const |
get measurement unit More... | |
const DSRCodedEntryValue & | getNumericValueQualifier () const |
get numeric value qualifier (optional) More... | |
OFCondition | getMeasurementUnit (DSRCodedEntryValue &measurementUnit) const |
get copy of measurement unit More... | |
OFCondition | getNumericValueQualifier (DSRCodedEntryValue &valueQualifier) const |
get copy of numeric value qualifier (optional). More... | |
OFCondition | getFloatingPointRepresentation (Float64 &floatingPoint) const |
get floating point representation of the numeric value (optional) More... | |
OFCondition | getRationalRepresentation (Sint32 &rationalNumerator, Uint32 &rationalDenominator) const |
get rational representation of the numeric value (optional) More... | |
OFCondition | setValue (const DSRNumericMeasurementValue &numericMeasurement, const OFBool check=OFTrue) |
set numeric measurement value. More... | |
OFCondition | setValue (const OFString &numericValue, const DSRCodedEntryValue &measurementUnit, const OFBool check=OFTrue) |
set numeric value and measurement unit. More... | |
OFCondition | setValue (const DSRCodedEntryValue &valueQualifier, const OFBool check=OFTrue) |
set empty numeric value and measurement unit with a numeric value qualifier. More... | |
OFCondition | setValue (const OFString &numericValue, const DSRCodedEntryValue &measurementUnit, const DSRCodedEntryValue &valueQualifier, const OFBool check=OFTrue) |
set numeric value, measurement unit and numeric value qualifier. More... | |
OFCondition | setNumericValue (const OFString &numericValue, const OFBool check=OFTrue) |
set numeric value. More... | |
OFCondition | setNumericValue (const DcmElement &delem, const unsigned long pos=0, const OFBool check=OFTrue) |
set numeric value from element. More... | |
OFCondition | setNumericValue (DcmItem &dataset, const DcmTagKey &tagKey, const unsigned long pos=0, const OFBool check=OFTrue) |
set numeric value from dataset. More... | |
OFCondition | setMeasurementUnit (const DSRCodedEntryValue &measurementUnit, const OFBool check=OFTrue) |
set measurement unit. More... | |
OFCondition | setNumericValueQualifier (const DSRCodedEntryValue &valueQualifier, const OFBool check=OFTrue) |
set numeric value qualifier. More... | |
OFCondition | setFloatingPointRepresentation (const Float64 floatingPoint, const OFBool check=OFTrue) |
set floating point representation of the numeric value. More... | |
OFCondition | setRationalRepresentation (const Sint32 rationalNumerator, const Uint32 rationalDenominator, const OFBool check=OFTrue) |
set rational representation of the numeric value. More... | |
void | removeFloatingPointRepresentation () |
remove floating point representation of the numeric value (if any). More... | |
void | removeRationalRepresentation () |
remove rational representation of the numeric value (if any). More... | |
Protected Member Functions | |
virtual OFCondition | checkNumericValueQualifier (const DSRCodedEntryValue &valueQualifier) const |
check the specified numeric value qualifier for validity. More... | |
![]() | |
DSRNumericMeasurementValue * | getValuePtr () |
get pointer to numeric measurement value More... | |
virtual OFCondition | readItem (DcmItem &dataset, const size_t flags) |
read numeric measurement value from dataset More... | |
virtual OFCondition | writeItem (DcmItem &dataset) const |
write numeric measurement value to dataset More... | |
virtual OFCondition | checkNumericValue (const OFString &numericValue) const |
check the specified numeric value for validity. More... | |
virtual OFCondition | checkMeasurementUnit (const DSRCodedEntryValue &measurementUnit) const |
check the specified measurement unit for validity. More... | |
virtual OFCondition | checkRationalRepresentation (const Sint32 rationalNumerator, const Uint32 rationalDenominator) const |
check the specified rational representation for validity. More... | |
virtual OFCondition | checkCurrentValue () const |
check the currently stored numeric measurement value for validity. More... | |
Class for SR numeric values and measurements (extended version with additional support of the DICOM Content Mapping Resource).
This class checks whether the optional value qualifier uses a coded entry from the Defined Context Group 42 (Numeric Value Qualifier), see DICOM PS 3.3 Table C.18.1-1.
CMR_SRNumericMeasurementValue::CMR_SRNumericMeasurementValue | ( | const OFString & | numericValue, |
const DSRCodedEntryValue & | measurementUnit, | ||
const OFBool | check = OFTrue |
||
) |
constructor
numericValue | numeric value (VR=DS, mandatory) |
measurementUnit | code representing the units of measurement (mandatory) |
check | if enabled, check 'numericValue' and 'measurementUnit' for validity before setting them. See corresponding setValue() method for details. |
CMR_SRNumericMeasurementValue::CMR_SRNumericMeasurementValue | ( | const CID42_NumericValueQualifier & | valueQualifier, |
const OFBool | check = OFTrue |
||
) |
constructor
valueQualifier | code representing the numeric value qualifier. Used to specify the reason for the absence of the measured value sequence, i.e. why the numeric value and measurement unit are empty. |
check | if enabled, check value for validity before setting it. See corresponding setValue() method for details. |
CMR_SRNumericMeasurementValue::CMR_SRNumericMeasurementValue | ( | const OFString & | numericValue, |
const DSRCodedEntryValue & | measurementUnit, | ||
const CID42_NumericValueQualifier & | valueQualifier, | ||
const OFBool | check = OFTrue |
||
) |
constructor
numericValue | numeric value (VR=DS, mandatory) |
measurementUnit | code representing the units of measurement (mandatory) |
valueQualifier | code representing the numeric value qualifier (optional). Can also be used to specify the reason for the absence of the measured value sequence (where 'numericValue' and 'measurementUnit' are stored). |
check | if enabled, check values for validity before setting them. See corresponding setValue() method for details. |
CMR_SRNumericMeasurementValue::CMR_SRNumericMeasurementValue | ( | const CMR_SRNumericMeasurementValue & | numericMeasurement | ) |
copy constructor
numericMeasurement | numeric measurement value to be copied (not checked !) |
CMR_SRNumericMeasurementValue::CMR_SRNumericMeasurementValue | ( | const DSRNumericMeasurementValue & | numericMeasurement | ) |
copy constructor
numericMeasurement | numeric measurement value to be copied (not checked !) |
|
protectedvirtual |
check the specified numeric value qualifier for validity.
In addition to DSRNumericMeasurementValue::checkNumericValueQualifier(), this method also checks the conformance with the Context Group 42 (see CID42_NumericValueQualifier).
valueQualifier | numeric value qualifier to be checked |
Reimplemented from DSRNumericMeasurementValue.
Referenced by CMR_SRNumericMeasurementValueWithUnits< T_Units, T_DefinedGroup >::setValue().
CMR_SRNumericMeasurementValue& CMR_SRNumericMeasurementValue::operator= | ( | const CMR_SRNumericMeasurementValue & | numericMeasurement | ) |
assignment operator
numericMeasurement | numeric measurement value to be copied (not checked !) |
Referenced by CMR_SRNumericMeasurementValueWithUnits< T_Units, T_DefinedGroup >::operator=().
OFCondition CMR_SRNumericMeasurementValue::setNumericValueQualifier | ( | const CID42_NumericValueQualifier & | valueQualifier, |
const OFBool | check = OFTrue |
||
) |
set numeric value qualifier.
This optional code specifies the qualification of the Numeric Value in the Measured Value Sequence, or the reason for the absence of the Measured Value Sequence Item. Before setting the code, it is usually checked. If the code is invalid the current code is not replaced and remains unchanged.
valueQualifier | numeric value qualifier to be set (optional). Use an empty code to remove the current value. |
check | if enabled, check value for validity before setting it. See checkNumericValueQualifier() method for details. |
OFCondition CMR_SRNumericMeasurementValue::setValue | ( | const CID42_NumericValueQualifier & | valueQualifier, |
const OFBool | check = OFTrue |
||
) |
set empty numeric value and measurement unit with a numeric value qualifier.
Before setting the value, it is usually checked. If the value is invalid, the current numeric measurement value is not replaced and remains unchanged.
valueQualifier | numeric value qualifier to be set. Used to specify the reason for the absence of the measured value sequence, i.e. why the numeric value and measurement unit are empty. |
check | if enabled, check value for validity before setting it. See checkNumericValueQualifier() method for details. |
Referenced by CMR_SRNumericMeasurementValueWithUnits< T_Units, T_DefinedGroup >::setValue().
OFCondition CMR_SRNumericMeasurementValue::setValue | ( | const OFString & | numericValue, |
const DSRCodedEntryValue & | measurementUnit, | ||
const CID42_NumericValueQualifier & | valueQualifier, | ||
const OFBool | check = OFTrue |
||
) |
set numeric value, measurement unit and numeric value qualifier.
Before setting the values, they are usually checked. Please note that both 'numericValue' and 'measurementUnit' either have to be empty or non-empty. If one of the three values is invalid, the current numeric measurement value is not replaced and remains unchanged. If the values are replaced, the optional floating point and rational representations are cleared, i.e. they have to be set manually if needed.
numericValue | numeric value to be set (VR=DS, mandatory) |
measurementUnit | measurement unit to be set (mandatory) |
valueQualifier | numeric value qualifier to be set (optional). Can also be used to specify the reason for the absence of the measured value sequence (where 'numericValue' and 'measurementUnit' are stored). Use an empty code to remove the current value. |
check | if enabled, check values for validity before setting them. See checkXXX() methods for details. |