FunctionalGroupOrRootLevelAttribute(Int32,Int32,Int32,Int32,Int32) Method

In This Topic

Return the required DicomAttribute within a specified functional group within a DicomDataSet

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Function FunctionalGroupOrRootLevelAttribute( _
   ByVal FunctionalGroup As System.Integer, _
   ByVal FunctionalElement As System.Integer, _
   ByVal Frame As System.Integer, _
   ByVal Group As System.Integer, _
   ByVal Element As System.Integer _
) As DicomAttribute

public DicomAttribute FunctionalGroupOrRootLevelAttribute( 
   System.int FunctionalGroup,
   System.int FunctionalElement,
   System.int Frame,
   System.int Group,
   System.int Element
)

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
Group: The Group number of the requested attribute within the dataset
Element: The Element number of the requested attribute within the dataset

Return Value

The requested DicomAttribute

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 an attribute to be retrieved from the chosen dataset, 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 macro: Pixel Value Transformation Sequence (0028,9145)
int functionalGroup = 0x0028;
int functionalElement = 0x9145;
                    
int frame = 10;
                    
// Target attribute: Rescale Intercept (0028,1052)
int targetGroup = 0x0028;
int targetElement = 0x1052;
                    
var attr = enhancedDs.FunctionalGroupOrRootLevelAttribute(functionalGroup, functionalElement, frame, targetGroup, targetElement);
                    
if (attr != null)
{
    Console.WriteLine($"Rescale Intercept for Frame {frame}: {attr.Value}");
}
else
{
    Console.WriteLine("Attribute not found.");
}

Requirements

Target Platforms: .NET CLR 4.8 or higher

Reference

DicomDataSet Class
DicomDataSet Members
Overload List

Send Feedback