dcmpsmk: création d'une presentation state DICOM en niveaux de gris

SYNOPSIS

dcmpsmk [options] dcmfile-in dcmfile-out

DESCRIPTION

L'utilitaire dcmpsmk lit un fichier image DICOM et crée un objet Grayscale Softcopy Presentation State conformément au Supplement 33. L'objet presentation state ainsi créé est réécrit dans un fichier. Plusieurs options en ligne de commande permettent de préciser comment certaines constructions susceptibles d'être présentes dans le fichier image doivent être référencés ou activés dans la presentation state. La presentation state nouvellement créée référence l'image source et contient des valeurs qui devraient permettre un affichage "raisonnable" de l'image lorsqu'elle est rendue sous le contrôle de la presentation state.

PARAMÈTRES

dcmfile-in   DICOM image file(s) to be read ("-" for stdin)

dcmfile-out  DICOM presentation state file to be created ("-" for stdout)

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 fichier ou le jeu de données (par défaut)
+fo --read-file-only: lit uniquement le format fichier
-f --read-dataset: lit le jeu de données sans les métadonnées du fichier syntaxe de transfert d'entrée :
-t= --read-xfer-auto: utilise la reconnaissance de syntaxe de transfert (par défaut)
-td --read-xfer-detect: ignore la syntaxe de transfert indiquée dans le méta-en-tête du fichier
-te --read-xfer-little: lit avec la syntaxe de transfert explicit VR little endian
-tb --read-xfer-big: lit avec la syntaxe de transfert explicit VR big endian
-ti --read-xfer-implicit: lit avec la syntaxe de transfert implicit VR little endian

options de traitement

+Vl --voi-lut: utilise la première VOI LUT si elle est présente (par défaut)
+Vw --voi-window: utilise le premier window center/width si présent
-V --voi-ignore: ignore la VOI LUT et le window center/width traitement des courbes :
+c --curve-activate: active les données de courbe si présentes (par défaut)
-c --curve-ignore: ignore les données de courbe traitement des overlays :
+oc --overlay-copy: copie les overlays s'ils ne sont pas incorporés, sinon les active (par défaut)
+oa --overlay-activate: active les overlays
-o --overlay-ignore: ignore les overlays traitement du shutter :
+s --shutter-activate: utilise le shutter s'il est présent dans l'image (par défaut)
-s --shutter-ignore: ignore le shutter traitement de la forme de la presentation LUT :
+p --plut-activate: utilise la forme de la presentation LUT si présente (par défaut)
-p --plut-ignore: ignore la forme de la presentation LUT gestion des couches :
+l1 --layer-single: toutes les courbes et tous les overlays sont placés dans une seule couche
+l2 --layer-double: une couche pour les courbes, une pour les overlays (par défaut)
+ls --layer-separate: couches distinctes pour chaque courbe et chaque overlay emplacement de l'image référencée :
-lx --location-none: référence d'image sans emplacement (par défaut)
-ln --location-network [a]etitle: string: image localisée sur l'entité applicative a
-lm --location-media [f]ilesetID, fileset[UID]: string: image localisée sur un support de stockage

options de validation

--validate-std: les images référencées par la GSPS doivent appartenir à la même classe SOP (par défaut)
--validate-related: les images référencées par la GSPS peuvent appartenir aux classes SOP associées 'for presentation' et 'for processing'
--validate-relaxed: les images référencées par la GSPS peuvent être de classe SOP quelconque

options de sortie

+t= --write-xfer-same: écrit avec la même syntaxe de transfert que le fichier image (par défaut)
+te --write-xfer-little: écrit avec la syntaxe de transfert explicit VR little endian
+tb --write-xfer-big: écrit avec la syntaxe de transfert explicit VR big endian
+ti --write-xfer-implicit: écrit avec la syntaxe de transfert implicit VR little endian

NOTES

Si plus d'un fichier d'entrée (dcmfile-in) est indiqué, les fichiers image supplémentaires sont uniquement référencés depuis le fichier de presentation state créé, mais aucune information complémentaire (par exemple liée à l'affichage) n'est reprise.

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