dcmdecap: extraire un fichier encapsulé depuis un objet de stockage encapsulé DICOM

SYNOPSIS

dcmdecap [options] dcmfile-in encfile-out

DESCRIPTION

L'utilitaire dcmdecap lit un fichier DICOM appartenant à l'une des classes SOP de stockage encapsulé (dcmfile-in), extrait le document intégré et l'écrit dans un fichier de sortie (encfile-out). En option, une commande peut être exécutée après la création du fichier de sortie.

PARAMÈTRES

dcmfile-in   DICOM input filename ("-" for stdin)

encfile-out  Encapsulated document output filename ("-" 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 le journal

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 un jeu de données sans informations de méta-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 du méta-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 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 supérieure d'un octet traitement des éléments UN de longueur indéfinie :
+ui --enable-cp246: lit les UN de longueur indéfinie comme des VR implicites (par défaut)
-ui --disable-cp246: lit les UN de longueur indéfinie comme des VR explicites traitement 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 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 compressée par deflate :
+bd --bitstream-deflated: attend un bitstream deflate (par défaut)
+bz --bitstream-zlib: attend un bitstream deflate zlib

options de traitement

options d'exécution :

  -x   --exec  [c]ommand: string
         execute command c after document extraction

NOTES

L'option –exec permet d'exécuter une certaine ligne de commande après la création du document PDF. La ligne de commande à exécuter est transmise à cette option en tant que paramètre. La ligne de commande spécifiée peut contenir le marqueur substituable '#f', qui sera remplacé par le nom du fichier de sortie au moment de l'exécution. La ligne de commande spécifiée est exécutée au premier plan, c'est-à-dire que dcmdecap restera bloqué jusqu'à ce que la commande se termine.

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.

CODES DE SORTIE

L'utilitaire dcmdecap utilise les codes de sortie suivants à sa terminaison. Cela permet à l'utilisateur de vérifier la raison pour laquelle l'application s'est terminée.

général

EXITCODE_NO_ERROR                         0
EXITCODE_COMMANDLINE_SYNTAX_ERROR         1

erreurs de fichier d'entrée

EXITCODE_CANNOT_READ_INPUT_FILE          20
EXITCODE_NO_INPUT_FILES                  21
EXITCODE_INVALID_INPUT_FILE              22

erreurs de fichier de sortie

EXITCODE_CANNOT_WRITE_OUTPUT_FILE        40

erreurs de traitement

EXITCODE_EXEC_FAILED                     91

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 dcmdecap tentera 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 sera chargé, à moins que le dictionnaire ne soit 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é.

VOIR AUSSI

dcmencap(1)