Skip to content

message.getDICOMGroup

Use when: You want to read values from the modified message during mapping. If you need the original incoming message, use source.getDICOMGroup.

Signature: message.getDICOMGroup(group)

Returns: DICOM Message group - a new DICOM object containing the DICOM tags that are part of the DICOM group

Finds all DICOM tags that are part of the given group.

Note

A Group is the first four digits of the DICOM tag: (Group,Element). "Patient Name" tag: (0010,0010). "Patient ID" tag: (0010,0020). "Patient DOB" tag: (0010,0030). All tags with a Group value of 0010 describe the Patient.

Parameters

Type Name Description Default
String group the Group portion of a DICOM tag: "0010"

Example

// assumes `message` is a DICOM message model object

// Retrieve all DICOM tags belonging to Group "0010" (Patient group)
var patientGroupTags = message.getDICOMGroup(
    "0010" // Group portion of the DICOM tag (e.g. 0010,xxxx)
);

// Result:
// patientGroupTags is a new DICOM Message containing all tags
// in Group 0010, such as:
// - (0010,0010) Patient Name
// - (0010,0020) Patient ID
// - (0010,0030) Patient Birth Date