dicominfo

Leer los metadatos de un mensaje DICOM

Sintaxis

info = dicominfo(filename)

info = dicominfo(filename,"dictionary",D)

info = dicominfo(___,Name=Value)

Descripción

info = dicominfo(filename) lee los metadatos del archivo compatible con DICOM (Imágenes y comunicaciones digitales en medicina) o con DICOS (Imágenes y comunicaciones digitales en seguridad), filename.

info = dicominfo(filename,"dictionary",D) lee el mensaje DICOM utilizando el archivo del diccionario de datos, D.

info = dicominfo(___,Name=Value) especifica las opciones utilizando uno o más argumentos de nombre-valor, además de cualquier combinación de los argumentos de entrada de las sintaxis anteriores.

Ejemplos

Leer metadatos de un mensaje DICOM

Lea los metadatos de un archivo DICOM.

info = dicominfo("CT-MONO2-16-ankle.dcm")

info = struct with fields:
                          Filename: 'B:\matlab\toolbox\images\imdata\CT-MONO2-16-ankle.dcm'
                       FileModDate: '18-Dec-2000 12:06:43'
                          FileSize: 525436
                            Format: 'DICOM'
                     FormatVersion: 3
                             Width: 512
                            Height: 512
                          BitDepth: 16
                         ColorType: 'grayscale'
    FileMetaInformationGroupLength: 192
        FileMetaInformationVersion: [2×1 uint8]
           MediaStorageSOPClassUID: '1.2.840.10008.5.1.4.1.1.7'
        MediaStorageSOPInstanceUID: '1.2.840.113619.2.1.2411.1031152382.365.1.736169244'
                 TransferSyntaxUID: '1.2.840.10008.1.2'
            ImplementationClassUID: '1.2.840.113619.6.5'
         ImplementationVersionName: '1_2_5'
      SourceApplicationEntityTitle: 'CTN_STORAGE'
            IdentifyingGroupLength: 414
                         ImageType: 'DERIVED\SECONDARY\3D'
                       SOPClassUID: '1.2.840.10008.5.1.4.1.1.7'
                    SOPInstanceUID: '1.2.840.113619.2.1.2411.1031152382.365.1.736169244'
                         StudyDate: '1993.04.30'
                        SeriesDate: '1993.04.30'
                       ContentDate: '1993.04.30'
                         StudyTime: '11:27:24'
                        SeriesTime: '11:27:24'
                       ContentTime: '11:27:24'
                          Modality: 'CT'
                    ConversionType: 'WSD'
                      Manufacturer: 'GE MEDICAL SYSTEMS'
                   InstitutionName: 'JFK IMAGING CENTER'
            ReferringPhysicianName: [1×1 struct]
                       StationName: 'CT01OC0'
                  StudyDescription: 'RT ANKLE'
      NameOfPhysiciansReadingStudy: [1×1 struct]
                     OperatorsName: [1×1 struct]
             ManufacturerModelName: 'GENESIS_ZEUS'
                PatientGroupLength: 18
                       PatientName: [1×1 struct]
            AcquisitionGroupLength: 10
                  SoftwareVersions: '03'
           RelationshipGroupLength: 134
                  StudyInstanceUID: '1.2.840.113619.2.1.1.322987881.621.736170080.681'
                 SeriesInstanceUID: '1.2.840.113619.2.1.2411.1031152382.365.736169244'
                      SeriesNumber: 365
                    InstanceNumber: 1
      ImagePresentationGroupLength: 168
                   SamplesPerPixel: 1
         PhotometricInterpretation: 'MONOCHROME2'
                              Rows: 512
                           Columns: 512
                     BitsAllocated: 16
                        BitsStored: 16
                           HighBit: 15
               PixelRepresentation: 1
           SmallestImagePixelValue: 0
                 PixelPaddingValue: 0
                      WindowCenter: 1024
                       WindowWidth: 4095
                  RescaleIntercept: -1024
                      RescaleSlope: 1
                       RescaleType: 'US'
              PixelDataGroupLength: 524296

Argumentos de entrada

filename — Nombre del archivo DICOM

vector de caracteres | escalar de cadena

Nombre del archivo DICOM, especificado como vector de caracteres o escalar de cadena.

Tipos de datos: char | string

D — Archivo del diccionario de datos

'dicom-dict.mat' (predeterminado) | vector de caracteres | escalar de cadena

Archivo del diccionario de datos, especificado como vector de caracteres o escalar de cadena. El archivo de D debe estar en la ruta de búsqueda de MATLAB^®.

Tipos de datos: char | string

Argumentos de par nombre-valor

Especifique pares de argumentos opcionales como Name1=Value1,...,NameN=ValueN, donde Name es el nombre del argumento y Value es el valor correspondiente. Los argumentos de nombre-valor deben aparecer después de otros argumentos. Sin embargo, el orden de los pares no importa.

Ejemplo: dicominfo("CT-MONO2-16-ankle.dcm",UseVRHeuristic=false) lee los metadatos del archivo DICOM sin usar una heurística.

En las versiones anteriores a la R2021a, utilice comas para separar cada nombre y valor, y encierre Name entre comillas.

Ejemplo: dicominfo("CT-MONO2-16-ankle.dcm","UseVRHeuristic",false) lee los metadatos del archivo DICOM sin usar una heurística.

UseVRHeuristic — Leer archivos no compatibles con DICOM que intercambian los modos VR de forma incorrecta

true o 1 (predeterminado) | false o 0

Lea archivos no compatibles con DICOM que intercambian los modos de representación de valores (VR) de forma incorrecta, especificados como 1 (true) lógico o 0 (false).

Cuando se establece en true, dicominfo utiliza una heurística para ayudar a leer determinados archivos no compatibles con DICOM que intercambian modos VR de forma incorrecta. dicominfo muestra una advertencia si se utiliza esta heurística. Si esta heurística está habilitada, un pequeño número de archivos compatibles no se leerá correctamente. Establezca UseVRHeuristic en false para leer estos archivos compatibles.

Tipos de datos: logical

UseDictionaryVR — Ajustar los tipos de datos al diccionario de datos

false o 0 (predeterminado) | true o 1

Ajuste los tipos de datos al diccionario de datos, especificado como 0 (false) lógico o 1 (true). Si este argumento se especifica como true, la estructura de salida info utiliza los tipos de datos en el diccionario de datos, con independencia de la información que aparezca en el archivo. Si se especifica como false, la salida info utiliza los códigos VR del archivo, aunque sean distintos del diccionario de datos. Como el contenido del archivo y el diccionario de datos prácticamente siempre concuerdan, no suele ser necesario especificar este argumento como true.

Sin embargo, si el archivo y el diccionario de datos no concuerdan y UseDictionaryVR está establecido en false, entonces dicominfo emite una advertencia y el usuario puede experimentar errores al pasar de info a dicomwrite. Para resolver estos errores, especifique UseDictionaryVR como true para utilizar los códigos VR del diccionario de datos.

Tipos de datos: logical

Argumentos de salida

info — Metadatos DICOM

Estructura

Metadatos DICOM, devueltos como una estructura.

Capacidades ampliadas

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con los entornos basados en hilos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Historial de versiones

Introducido antes de R2006a

R2024b: Compatibilidad con entornos basados en hilos

Ahora dicominfo es compatible con los entornos basados en hilos.

Consulte también

dicomanon | dicomdict | dicomdisp | dicomwrite | dicomlookup | dicomread | dicomuid | dicomFile (Medical Imaging Toolbox) | getAttribute (Medical Imaging Toolbox) | findAttribute (Medical Imaging Toolbox)