dcmdump: afficher un fichier DICOM et un jeu de données

SYNOPSIS

dcmdump [options] dcmfile-in...

DESCRIPTION

dcmdump est un utilitaire qui affiche le contenu d'un fichier DICOM (format de fichier ou jeu de données brut) sur stdout, sous forme de texte. Les attributs dont le champ de valeur est très volumineux (par exemple les données de pixels) peuvent être signalés par "(not loaded)". Les champs de valeur de type chaîne sont délimités par des crochets ([]). Les UID connus sont affichés sous leur nom, précédé d'un signe égal (par exemple "=MRImageStorage"), sauf si cette correspondance est explicitement désactivée. Les champs de valeur vides sont signalés par "(no value available)".

Si dcmdump lit un jeu de données brut (données DICOM sans en-tête méta de format de fichier), il tente de deviner la syntaxe de transfert en examinant les premiers octets du fichier. Il n'est pas toujours possible de deviner correctement la syntaxe de transfert, et il est préférable de convertir un jeu de données au format de fichier chaque fois que possible (à l'aide de l'utilitaire dcmconv). Il est également possible d'utiliser les options -f et -t[ieb] pour forcer dcmdump à lire un jeu de données avec une syntaxe de transfert particulière.

PARAMÈTRES

dcmfile-in  DICOM input file or directory to be dumped ("-" for stdin)

OPTIONS

options générales

-h --help: affiche cette aide et quitte
--version: affiche les informations de version et quitte
--arguments: affiche les arguments de ligne de commande développés
-q --quiet: mode silencieux, n'affiche ni avertissements ni erreurs
-v --verbose: mode détaillé, affiche les détails du traitement
-d --debug: mode débogage, affiche les informations de débogage
-ll --log-level [l]evel: string constant: (fatal, error, warn, info, debug, trace) utilise le niveau l pour la journalisation
-lc --log-config [f]ilename: string: utilise le fichier de configuration f pour la journalisation

options d'entrée

+f --read-file: lit le format de fichier ou le jeu de données (par défaut)
+fo --read-file-only: lit uniquement le format de fichier
-f --read-dataset: lit le jeu de données sans les informations méta du fichier. syntaxe de transfert d'entrée :
-t= --read-xfer-auto: utilise la reconnaissance de la TS (par défaut)
-td --read-xfer-detect: ignore la TS spécifiée dans l'en-tête méta du fichier
-te --read-xfer-little: lit avec la TS explicit VR little endian
-tb --read-xfer-big: lit avec la TS explicit VR big endian
-ti --read-xfer-implicit: lit avec la TS implicit VR little endian. fichiers d'entrée :
+sd --scan-directories: parcourt les répertoires à la recherche des fichiers d'entrée (dcmfile-in)
+sp --scan-pattern [p]attern: string (only with --scan-directories): motif de correspondance des noms de fichiers (caractères génériques) # peut ne pas être disponible sur tous les systèmes
-r --no-recurse: ne traite pas les répertoires de façon récursive (par défaut)
+r --recurse: traite les répertoires indiqués de façon récursive. valeurs de tag longues :
+M --load-all: charge les valeurs de tag très longues (par défaut)
-M --load-short: ne charge pas les valeurs très longues (par exemple les données de pixels)
+R --max-read-length [k]bytes: integer (4..4194302, default: 4): définit le seuil des valeurs longues à k kilooctets. analyse des informations méta du fichier :
+ml --use-meta-length: utilise la longueur de groupe des informations méta du fichier (par défaut)
-ml --ignore-meta-length: ignore la longueur de groupe des informations méta du fichier. analyse des attributs de longueur impaire :
+ao --accept-odd-length: accepte les attributs de longueur impaire (par défaut)
+ae --assume-even-length: suppose que la longueur réelle est plus grande d'un octet. gestion de l'explicit VR :
+ev --use-explicit-vr: utilise l'explicit VR du jeu de données (par défaut)
-ev --ignore-explicit-vr: ignore l'explicit VR (privilégie le dictionnaire de données). gestion des VR non standard :
+vr --treat-as-unknown: traite les VR non standard comme unknown (par défaut)
-vr --assume-implicit: tente de lire avec la TS implicit VR little endian. gestion des éléments UN de longueur non définie :
+ui --enable-cp246: lit les UN de longueur non définie comme implicit VR (par défaut)
-ui --disable-cp246: lit les UN de longueur non définie comme explicit VR. gestion des éléments UN de longueur définie :
-uc --retain-un: conserve les éléments en UN (par défaut)
+uc --convert-un: convertit vers la VR réelle si elle est connue. gestion des éléments privés de longueur maximale (implicit VR) :
-sq --maxlength-dict: lit comme défini dans le dictionnaire (par défaut)
+sq --maxlength-seq: lit comme une séquence de longueur non définie. gestion des éléments de délimitation incorrects :
-rd --use-delim-items: utilise les éléments de délimitation du jeu de données (par défaut)
+rd --replace-wrong-delim: remplace les éléments de délimitation de séquence/item incorrects. gestion des éléments OB/OW illégaux de longueur non définie :
-oi --illegal-obow-rej: rejette le jeu de données contenant un élément illégal (par défaut)
+oi --illegal-obow-conv: convertit l'élément OB/OW de longueur non définie en SQ. gestion de la VOI LUT Sequence en VR OW et de longueur explicite :
-vi --illegal-voi-rej: rejette le jeu de données contenant une VOI LUT illégale (par défaut)
+vi --illegal-voi-conv: convertit la VOI LUT illégale en SQ. gestion des données de pixels de longueur explicite pour les syntaxes de transfert encapsulées :
-pe --abort-expl-pixdata: interrompt en cas de données de pixels de longueur explicite (par défaut)
+pe --use-expl-pixdata: utilise les données de pixels de longueur explicite. gestion générale des erreurs d'analyse :
+Ep --ignore-parse-errors: tente de se rétablir après des erreurs d'analyse
-Ep --handle-parse-errors: traite les erreurs d'analyse et arrête l'analyse (par défaut). autres options d'analyse :
+st --stop-after-elem [t]ag: "gggg,eeee" or dictionary name: arrête l'analyse après l'élément spécifié par t
+sb --stop-before-elem [t]ag: "gggg,eeee" or dictionary name: arrête l'analyse avant l'élément spécifié par t # ne prend en compte que les éléments du niveau principal du jeu de # données et fonctionne également si le tag donné n'est pas présent dans le fichier. correction automatique des données :
+dc --enable-correction: active la correction automatique des données (par défaut)
-dc --disable-correction: désactive la correction automatique des données. format bitstream de l'entrée deflate :
+bd --bitstream-deflated: attend un bitstream deflate (par défaut)
+bz --bitstream-zlib: attend un bitstream zlib deflate

options de traitement

specific character set:

  +U8  --convert-to-utf8
         convert all element values that are affected
         by Specific Character Set (0008,0005) to UTF-8

         # requires support from an underlying character encoding library
         # (see output of --version on which one is available)

options de sortie

+L --print-all: affiche les valeurs de tag longues en entier
-L --print-short: affiche les valeurs de tag longues sous forme raccourcie (par défaut)
+T --print-tree: affiche la structure hiérarchique sous forme d'arborescence simple
-T --print-indented: affiche la structure hiérarchique avec indentation (par défaut)
+F --print-filename: affiche un en-tête avec le nom de fichier pour chaque fichier d'entrée
+Fs --print-file-search: affiche un en-tête avec le nom de fichier uniquement pour les fichiers d'entrée contenant l'un des tags recherchés. correspondance :
+Un --map-uid-names: associe les numéros UID bien connus à leur nom (par défaut)
-Un --no-uid-names: n'associe pas les numéros UID bien connus à leur nom. citation :
+Qn --quote-nonascii: représente les caractères non-ASCII et de contrôle sous forme de balisage XML
+Qo --quote-as-octal: représente les caractères non-ASCII et de contrôle sous forme de nombres octaux
-Qn --print-nonascii: affiche les caractères non-ASCII et de contrôle tels quels (par défaut). couleur :
+C --print-color: utilise des codes d'échappement ANSI pour une sortie colorée
-C --no-color: n'utilise aucun code d'échappement ANSI (par défaut). gestion des erreurs :
-E --stop-on-error: n'affiche rien si le fichier est endommagé (par défaut)
+E --ignore-errors: tente d'afficher le contenu même si le fichier est endommagé. recherche :
+P --search [t]ag: "gggg,eeee" or dictionary name: affiche le dump textuel du tag t. cette option peut être spécifiée plusieurs fois (par défaut : le fichier complet est affiché)
+s --search-all: affiche toutes les occurrences des tags recherchés (par défaut)
-s --search-first: affiche uniquement la première occurrence des tags recherchés
+p --prepend: ajoute la hiérarchie de séquence en préfixe du tag affiché, selon la notation suivante : (gggg,eeee).(gggg,eeee).* (uniquement en association avec --search)
-p --no-prepend: n'ajoute pas la hiérarchie en préfixe du tag (par défaut). écriture :
+W --write-pixel [d]irectory: string: écrit les données de pixels dans un fichier .raw stocké dans d (little endian, nom de fichier généré automatiquement)

NOTES

Indiquer des répertoires en paramètre de la ligne de commande n'a de sens que si l'option –scan-directories est également spécifiée. Si les fichiers des répertoires fournis doivent être sélectionnés selon un motif de nom particulier (par exemple au moyen de caractères génériques), l'option –scan-pattern doit être utilisée. Notez que ce motif de fichiers ne s'applique qu'aux fichiers situés dans les répertoires parcourus, et que, si d'autres motifs sont spécifiés sur la ligne de commande en dehors de l'option –scan-pattern (par exemple pour sélectionner d'autres fichiers), ceux-ci ne s'appliquent pas aux répertoires indiqués.

JOURNALISATION

Le niveau de détail de la journalisation des différents outils en ligne de commande et des bibliothèques sous-jacentes peut être spécifié par l'utilisateur. Par défaut, seules les erreurs et les avertissements sont écrits dans le flux d'erreur standard. L'option –verbose permet également de signaler des messages d'information tels que les détails du traitement. L'option –debug permet d'obtenir plus de détails sur l'activité interne, par exemple à des fins de débogage. L'option –log-level permet de sélectionner d'autres niveaux de journalisation. En mode –quiet, seules les erreurs fatales sont signalées. Dans de tels cas d'erreur très graves, l'application se termine généralement. Pour plus de détails sur les différents niveaux de journalisation, consultez la documentation du module "oflog".

Si la sortie de la journalisation doit être écrite dans un fichier (éventuellement avec rotation des fichiers journaux), vers syslog (Unix) ou le journal des événements (Windows), l'option –log-config peut être utilisée. Ce fichier de configuration permet également de diriger uniquement certains messages vers un flux de sortie particulier et de filtrer certains messages en fonction du module ou de l'application qui les génère. Un exemple de fichier de configuration est fourni dans < etcdir>/logger.cfg.

LIGNE DE COMMANDE

Tous les outils en ligne de commande utilisent la notation suivante pour les paramètres : les crochets entourent les valeurs facultatives (0-1), trois points de suspension à la fin indiquent que plusieurs valeurs sont autorisées (1-n), et la combinaison des deux signifie de 0 à n valeurs.

Les options de la ligne de commande se distinguent des paramètres par un signe '+' ou '-' en tête. En général, l'ordre et la position des options de la ligne de commande sont arbitraires (c'est-à-dire qu'elles peuvent apparaître n'importe où). Toutefois, si des options s'excluent mutuellement, c'est la dernière occurrence, la plus à droite, qui est utilisée. Ce comportement est conforme aux règles d'évaluation standard des shells Unix courants.

De plus, un ou plusieurs fichiers de commandes peuvent être spécifiés en utilisant un signe '@' comme préfixe du nom de fichier (par exemple @command.txt). Un tel argument de commande est remplacé par le contenu du fichier texte correspondant (les espaces multiples sont traités comme un séparateur unique, sauf s'ils apparaissent entre deux guillemets) avant toute évaluation ultérieure. Notez qu'un fichier de commandes ne peut pas contenir un autre fichier de commandes. Cette approche simple mais efficace permet de regrouper des combinaisons courantes d'options/paramètres et évite des lignes de commande longues et peu lisibles (un exemple est fourni dans le fichier < datadir>/dumppat.txt).

ENVIRONNEMENT

L'utilitaire dcmdump tente de charger les dictionnaires de données DICOM spécifiés dans la variable d'environnement DCMDICTPATH. Par défaut, c'est-à-dire si la variable d'environnement DCMDICTPATH n'est pas définie, le fichier < datadir>/dicom.dic est chargé, sauf si le dictionnaire est intégré à l'application (par défaut sous Windows).

Il est préférable de conserver le comportement par défaut et de n'utiliser la variable d'environnement DCMDICTPATH que lorsque des dictionnaires de données alternatifs sont nécessaires. La variable d'environnement DCMDICTPATH a le même format que la variable PATH des shells Unix, en ce sens que les deux-points (":") séparent les entrées. Sur les systèmes Windows, le point-virgule (";") est utilisé comme séparateur. Le code du dictionnaire de données tente de charger chaque fichier spécifié dans la variable d'environnement DCMDICTPATH. C'est une erreur si aucun dictionnaire de données ne peut être chargé.

Selon les options de ligne de commande spécifiées, l'utilitaire dcmdump tente de charger des tables de correspondance de jeux de caractères. Cela se produit lorsque DCMTK a été compilé avec la bibliothèque oficonv (ce qui est le cas par défaut) et que les tables de correspondance ne sont pas intégrées à la bibliothèque (par défaut lorsque DCMTK utilise des bibliothèques partagées).

Les fichiers de tables de correspondance sont attendus dans le < datadir> de DCMTK. La variable d'environnement DCMICONVPATH peut être utilisée pour indiquer un autre emplacement. Si un autre emplacement est indiqué, ces tables de correspondance remplacent également toutes les tables intégrées.

VOIR AUSSI

dump2dcm(1), dcmconv(1)