xml2dcm - En ligne dans le Cloud

PROGRAMME:

Nom

xml2dcm - Convertir un document XML en fichier DICOM ou en ensemble de données

SYNOPSIS

xml2dcm [options] xmlfile-in dcmfile-out

DESCRIPTION

La xml2dcm l'utilitaire convertit le contenu d'un document XML (Extensible Markup Language)
vers un fichier DICOM ou un ensemble de données. Le document XML doit être validé par rapport à la DTD
(Document Type Definition) qui est décrit dans le fichier dcm2xml.dtd. Un fichier XML approprié
peut être créé à l'aide du dcm2xml outil (option +Wb recommandé d'inclure des données binaires).

PARAMETRES

xmlfile-in Nom du fichier d'entrée XML à convertir (stdin : "-")

dcmfile-out nom du fichier de sortie DICOM

OPTIONS

général Options
-h --aide
imprimer ce texte d'aide et quitter

--version
imprimer les informations sur la version et quitter

--arguments
imprimer les arguments de ligne de commande étendus

-q --silencieux
mode silencieux, n'imprime aucun avertissement ni erreur

-v --verbeux
mode verbeux, détails de traitement d'impression

-d --débogage
mode de débogage, imprimer les informations de débogage

-ll --log-level [l] niveau : chaîne constante
(fatal, erreur, avertissement, info, débogage, trace)
utiliser le niveau l pour l'enregistreur

-lc --log-config [fichier] nom de fichier : chaîne
utiliser le fichier de configuration f pour l'enregistreur

contribution Options
format de fichier d'entrée :

+f --read-meta-info
lire les méta-informations si elles sont présentes (par défaut)

-f --ignore-méta-info
ignorer les méta-informations du fichier

traitement Options
validation:

+Vd --valider-document
valider le document XML par rapport à la DTD

+Vn --check-espace de noms
vérifier l'espace de noms XML dans la racine du document

identifiants uniques :

+Ug --generate-new-uids
générer un nouvel UID d'instance d'étude/série/SOP

-Uo --dont-overwrite-uids
ne pas écraser les UID existants (par défaut)

+Uo --overwrite-uids
écraser les UID existants

sortie Options
format de fichier de sortie :

+F --écrire-fichier
format de fichier d'écriture (par défaut)

-F --écrire-ensemble de données
écrire un ensemble de données sans méta-informations de fichier

+Fu --update-meta-info
mettre à jour les métadonnées d'un fichier particulier

syntaxe de transfert de sortie :

+t= --write-xfer-même
écrire avec le même TS en entrée (par défaut)

+te --write-xfer-petit
écrire avec un TS VR little endian explicite

+tb --write-xfer-big
écrire avec un TS big endian VR explicite

+ti --write-xfer-implicite
écrire avec VR implicite TS little endian

+td --write-xfer-déflaté
écrivez avec un petit endian TS VR explicite dégonflé

représentations de valeur après 1993 :

+u --enable-new-vr
activer la prise en charge des nouveaux VR (UN/UT) (par défaut)

-u --disable-new-vr
désactiver la prise en charge des nouveaux VR, convertir en OB

codage de la longueur du groupe :

+g= --group-length-recalc
recalculer les longueurs de groupe si présent (par défaut)

+g --group-length-create
toujours écrire avec des éléments de longueur de groupe

-g --group-length-remove
toujours écrire sans éléments de longueur de groupe

codage de longueur dans les séquences et les éléments :

+e --longueur-explicite
écrire avec des longueurs explicites (par défaut)

-e --longueur-indéfinie
écrire avec des longueurs indéfinies

remplissage de fin d'ensemble de données (pas avec --write-dataset):

-p= --padding-retain
ne pas modifier le remplissage (par défaut sinon --write-dataset)

-p --padding-off
pas de remplissage (implicite si --write-dataset)

+p --padding-create [fichier-pad [i]tem-pad : entier
aligner le fichier sur plusieurs octets et éléments sur
multiple de i octets

dégonfler le niveau de compression (uniquement avec --write-xfer-deflated) :

+cl --compression-level [l]evel : entier (par défaut : 6)
0=non compressé, 1=le plus rapide, 9=meilleure compression

NOTES

La structure de base de l'entrée XML attendue ressemble à ce qui suit :



<format de fichier xmlns="http://dicom.offis.de/dcmtk">

<element tag="0002,0000" vr="UL" vm="1" len="4"
name="MetaElementGroupLength">
166


<element tag="0002,0013" vr="SH" vm="1" len="16"
name="ImplementationVersionName">
OFFIS_DCMTK_353



<element tag="0008,0005" vr="CS" vm="1" len="10"
name="SpecificCharacterSet">
ISO_IR100




<element tag="0028,3002" vr="xs" vm="3" len="6"
name="LUTDescriptor">
256 \ 0 \ 8






<element tag="7fe0,0010" vr="OW" vm="1" len="262144"
name="PixelData" chargé="no" binary="hidden">




Les balises 'file-format' et 'meta-header' peuvent être absentes pour les ensembles de données DICOM.

Personnage Codage
L'encodage des caractères DICOM est déterminé automatiquement à partir de l'élément avec balise
'0008,0005' (Jeu de caractères spécifiques) - si présent. Les jeux de caractères suivants sont
actuellement pris en charge (nécessite libxml pour inclure iconv soutien, voir --version production):

ASCII (ISO_IR 6) (UTF-8)
UTF-8 "ISO_IR 192" (UTF-8)
ISO Latin 1 "ISO_IR 100" (ISO-8859-1)
ISO Latin 2 "ISO_IR 101" (ISO-8859-2)
ISO Latin 3 "ISO_IR 109" (ISO-8859-3)
ISO Latin 4 "ISO_IR 110" (ISO-8859-4)
ISO Latin 5 "ISO_IR 148" (ISO-8859-9)
Cyrillique "ISO_IR 144" (ISO-8859-5)
Arabe "ISO_IR 127" (ISO-8859-6)
Grec "ISO_IR 126" (ISO-8859-7)
Hébreu "ISO_IR 138" (ISO-8859-8)

Les jeux de caractères multiples ne sont pas pris en charge (seule la première valeur du "Caractère spécifique
Set' est utilisé pour l'encodage des caractères en cas de multiplicité des valeurs).

See dcm2xml documentation pour plus de détails sur la structure XML.

binaire Données
Les données binaires peuvent être codées soit sous la forme d'une séquence de nombres hexadécimaux séparés par une barre oblique inverse
'\' ou au format Base64 (binary='base64'). De plus, les données binaires peuvent également être lues à partir de
fichier (binaire='fichier'). Dans ce cas, le nom du fichier doit être spécifié comme valeur de l'élément,
par exemple

sous-répertoire/pixeldata.raw

Veuillez noter que le contenu du fichier sera lu tel quel. Les données OW devraient être
little endian commandé et sera échangé si nécessaire. Aucun contrôle ne sera effectué pour s'assurer
que la quantité de données est raisonnable en termes d'autres attributs tels que les lignes ou
Colonnes.

Compression
Si libxml est compilé avec le support zlib, le fichier d'entrée (fichier xml-in) peut également être
compressé avec ZIP, ce qui donne généralement des fichiers beaucoup plus petits. Voir sortie de l'option
--version afin de vérifier si le support zlib est disponible.

Limites
Différentes versions de libxml peuvent avoir des limites différentes pour la longueur maximale d'un XML
valeur de l'élément. Par conséquent, il convient d'éviter d'utiliser des valeurs d'élément très longues (par exemple pour
données de pixels).

Gardez à l'esprit que xml2dcm ne prend actuellement pas entièrement en charge les fichiers DICOMDIR. Spécifiquement,
la valeur des différentes données d'offset n'est pas mise à jour automatiquement par cet outil.

Journalisation

Le niveau de sortie de journalisation des divers outils de ligne de commande et des bibliothèques sous-jacentes peut
être spécifié par l'utilisateur. Par défaut, seuls les erreurs et les avertissements sont écrits dans la norme
flux d'erreurs. Utilisation de l'option --verbeux également des messages d'information comme les détails du traitement
sont rapportés. Option --déboguer peut être utilisé pour obtenir plus de détails sur l'activité interne,
par exemple à des fins de débogage. D'autres niveaux de journalisation peuvent être sélectionnés à l'aide de l'option --Journal-
niveau. En --silencieux mode seules les erreurs fatales sont signalées. Dans des événements d'erreur aussi graves,
l'application se terminera généralement. Pour plus de détails sur les différents niveaux de journalisation,
voir la documentation du module 'oflog'.

Dans le cas où la sortie de journalisation doit être écrite dans un fichier (éventuellement avec rotation du fichier journal),
vers syslog (Unix) ou l'option du journal des événements (Windows) --log-config peut être utilisé. Cette
le fichier de configuration permet également de diriger uniquement certains messages vers une sortie particulière
flux et pour filtrer certains messages en fonction du module ou de l'application où ils
Sont générés. Un exemple de fichier de configuration est fourni dans /logger.cfg.

COMMAND LINE

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

Les options de ligne de commande se distinguent des paramètres par un signe '+' ou '-' en tête,
respectivement. Habituellement, l'ordre et la position des options de ligne de commande sont arbitraires (c'est-à-dire qu'ils
peut apparaître n'importe où). Cependant, si les options s'excluent mutuellement, l'apparence la plus à droite
est utilisé. 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 pour
le nom du fichier (par exemple @commande.txt). Un tel argument de commande est remplacé par le contenu de
le fichier texte correspondant (les espaces blancs multiples sont traités comme un seul séparateur sauf si
ils apparaissent entre deux guillemets) avant toute évaluation ultérieure. Veuillez noter que
un fichier de commandes ne peut pas contenir un autre fichier de commandes. Cette approche simple mais efficace
permet de résumer les combinaisons courantes d'options/paramètres et évite les
lignes de commande confuses (un exemple est fourni dans le fichier /dumppat.txt).

ENVIRONNEMENT

La xml2dcm L'utilitaire tentera de charger les dictionnaires de données DICOM spécifiés dans le
Dcmdictpath variable d'environnement. Par défaut, c'est-à-dire si le Dcmdictpath variable d'environnement
n'est pas défini, le fichier /dicom.dic sera chargé à moins que le dictionnaire ne soit construit
dans l'application (par défaut pour Windows).

Le comportement par défaut doit être préféré et le Dcmdictpath variable d'environnement uniquement
utilisé lorsque des dictionnaires de données alternatifs sont nécessaires. Les Dcmdictpath variable d'environnement
a le même format que le shell Unix PATH variable en ce qu'un deux-points (':') sépare
entrées. Sur les systèmes Windows, un point-virgule (';') est utilisé comme séparateur. Le dictionnaire de données
le code tentera de charger chaque fichier spécifié dans le Dcmdictpath variable d'environnement. Ce
est une erreur si aucun dictionnaire de données ne peut être chargé.

Utilisez xml2dcm en ligne à l'aide des services onworks.net