dicomfind

Find location and value of target attribute in DICOM metadata

Since R2021b

Syntax

attributeinfo = dicomfind(info,attribute)

attributeinfo = dicomfind(filename,attribute)

Description

attributeinfo = dicomfind(info,attribute) finds the location and value of the DICOM metadata field attribute of the DICOM metadata structure info. To extract the DICOM metadata structure from a DICOM file, use dicominfo. You can use dicomfind to help find values for metadata items that are deeply nested in the info structure.

attributeinfo = dicomfind(filename,attribute) finds the value of the metadata element attribute of the DICOM file filename.

Examples

Find Location and Value of DICOM Metadata in Info Structure

Create a DICOM metadata structure, info, by using the dicominfo function.

info = dicominfo("RTSTRUCT-VS-SEG-001.dcm");

Find the value and location in the info structure of the ROINumber metadata field. The dicomfind function returns the results in a table with two columns: Location and Value.

ROINumber = dicomfind(info,"ROINumber")

ROINumber=4×2 table
                      Location                      Value
    ____________________________________________    _____

    {'StructureSetROISequence.Item_1.ROINumber'}    {[1]}
    {'StructureSetROISequence.Item_2.ROINumber'}    {[2]}
    {'StructureSetROISequence.Item_3.ROINumber'}    {[3]}
    {'StructureSetROISequence.Item_4.ROINumber'}    {[4]}

Find Location and Value of DICOM Metadata in DICOM File

Find the value of the ROINumber metadata field and its location in the DICOM metadata structure. Specify the name of the metadata field and the name of the DICOM file. The function returns the results in a table with two columns: Location and Value.

ROINumber = dicomfind("RTSTRUCT-VS-SEG-001.dcm","ROINumber")

ROINumber=4×2 table
                      Location                      Value
    ____________________________________________    _____

    {'StructureSetROISequence.Item_1.ROINumber'}    {[1]}
    {'StructureSetROISequence.Item_2.ROINumber'}    {[2]}
    {'StructureSetROISequence.Item_3.ROINumber'}    {[3]}
    {'StructureSetROISequence.Item_4.ROINumber'}    {[4]}

Input Arguments

info — DICOM metadata

structure

DICOM metadata, specified as a structure. You can extract the DICOM metadata structure from a DICOM file by using the dicominfo function.

Data Types: struct

attribute — Name of DICOM metadata field

string scalar | character vector

Name of the DICOM metadata field, specified as a string scalar or character vector. The spelling and capitalization of attribute must match the full name of a metadata field in the input DICOM metadata structure, info.

Data Types: string | char

filename — Name of DICOM file

string scalar | character vector

Name of the DICOM file, specified as a string scalar or character vector.

Example: "rtstruct.dcm"

Data Types: string | char

Output Arguments

attributeinfo — Location and value of specified DICOM attribute

table

Location and value of the specified DICOM attribute, returned as a table with two columns: Location and Value. The Location column lists the attribute name using dot notation, providing its position within the nested DICOM metadata structure. The Value column lists the value assigned for each instance of the attribute within the DICOM metadata structure.

Extended Capabilities

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

Version History

Introduced in R2021b

R2024b: Support for thread-based environments

dicomfind now supports thread-based environments.