dcmp2pgm: lire une image DICOM et un presentation state, puis générer un bitmap

SYNOPSIS

dcmp2pgm [options] dcmimage-in [bitmap-out]

DESCRIPTION

L'utilitaire dcmp2pgm restitue une image DICOM monochrome sous la forme d'un bitmap monochrome à 8 bits/pixel, sous le contrôle d'un objet grayscale softcopy presentation state. Le bitmap est enregistré soit au format "Portable Gray Map" (PGM), soit comme objet image DICOM secondary capture. Si aucun presentation state n'est lu depuis un fichier, un presentation state par défaut est créé. L'utilitaire permet de lire, au démarrage, un fichier de configuration du Softcopy Presentation State Viewer. Dans ce cas, les paramètres du fichier de configuration qui affectent le rendu du presentation state sont utilisés, par exemple une correction de la plage de niveaux de gris selon le modèle de Barten (DICOM part 14) peut être effectuée si la courbe caractéristique du système d'affichage est disponible et définie dans le fichier de configuration.

PARAMÈTRES

dcmimage-in  input DICOM image ("-" for stdin)

bitmap-out   output DICOM image or PGM bitmap

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 de traitement

-p --pstate [f]ilename: string: traite en utilisant le fichier presentation state
-c --config [f]ilename: string: traite en utilisant les paramètres du fichier de configuration
-f --frame [f]rame: integer: traite en utilisant l'image f (par défaut : 1)

format de sortie

-D --pgm: enregistre l'image en PGM (par défaut)
+D --dicom: enregistre l'image en DICOM secondary capture

options de sortie

  +S   --save-pstate  [f]ilename: string
         save presentation state to file

NOTES

Limitations

Notez que l'outil dcmp2pgm ne restitue pas tous les aspects définis par l'objet Grayscale Softcopy Presentation State (GSPS), mais uniquement ceux pris en charge par les classes DCMTK sous-jacentes. En particulier, les annotations textuelles et graphiques ne seront pas visibles dans l'image de sortie. La raison en est que ces aspects d'un objet GSPS sont généralement restitués par DICOMscope, l'interface utilisateur graphique qui se superpose aux classes DCMTK concernées et qui est écrite en Java.

De même, les concepts introduits après la définition initiale de l'IOD GSPS (voir Supplement 33) sont ignorés. Cela inclut le Supplement 120, avec ses fonctionnalités étendues telles que Compound Graphics.

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 dcmp2pgm 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é.

FICHIERS

< etcdir>/dcmpstat.cfg - exemple de fichier de configuration