FunctionalGroupDataSet(Int32,Int32,Int32) Method

In This Topic

Locate the required functional group within a DicomDataSet

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Function FunctionalGroupDataSet( _
   ByVal FunctionalGroup As System.Integer, _
   ByVal FunctionalElement As System.Integer, _
   ByVal Frame As System.Integer _
) As DicomDataSet

public DicomDataSet FunctionalGroupDataSet( 
   System.int FunctionalGroup,
   System.int FunctionalElement,
   System.int Frame
)

Parameters

FunctionalGroup: The Group of the requested dataset
FunctionalElement: The Element of the requested dataset
Frame: The frame number to which the dataset should apply

Return Value

The requested dataset

Remarks

The enhanced DICOM multi-frame objects (e.g. enhanced CT and MRI) allow many attributes to be held in functional group macros, which may be either:

The same for all frames - in the "Shared Functional Groups Sequence" (5200,9229)
Different for different frames - in the "Per-frame Functional Groups Sequence" (5200,9230)

This method allows the designated dataset to be located, irrespective of which sequence it is in. Note that the Group and Element used to identify the functional group are independent of the Group and Element of individual attributes within that DataSet.

Example

DicomDataSet enhancedDs = new DicomDataSet("Enhanced_Dataset.dcm");
                    
// Functional Group Tag: Pixel Value Transformation Sequence (0028,9145)
int group = 0x0028;
int element = 0x9145;
int frameNumber = 5;
                    
DicomDataSet functionalGroup = ds.FunctionalGroupDataSet(group, element, frameNumber);
                    
// Access an attribute inside the functional group, e.g., Rescale Slope (0028,1053)
if (functionalGroup[Keyword.RescaleSlope].Value != null)
{
    double slope = Convert.ToDouble(functionalGroup[Keyword.RescaleSlope].Value);    
}

Requirements

Target Platforms: .NET CLR 4.8 or higher

Reference

DicomDataSet Class
DicomDataSet Members
Overload List

Send Feedback