dump2dcm - En ligne dans le Cloud

PROGRAMME:

Nom

dump2dcm - Convertir le vidage ASCII en fichier DICOM

SYNOPSIS

dump2dcm [options] dumpfile-in dcmfile-out

DESCRIPTION

Le décharge2dcm L'utilitaire convertit un fichier de vidage ASCII en un fichier DICOM. Le fichier de vidage a le
même format que la sortie de dcmdump. Ainsi, il est possible de capturer la sortie de dcmdump
dans un fichier, modifiez certains attributs et créez un nouveau fichier DICOM.

PARAMETRES

dumpfile-in dump nom du fichier d'entrée

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

ordre des octets du contenu du fichier :

+rl --lire-fichier-petit
lire les données OW avec little endian (par défaut)

+rb --read-file-big
lire les données OW du fichier avec big endian

autres options de saisie :

+l --line [m]ax-length : entier
longueur de ligne maximale m (par défaut : 4096)

traitement Options
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 petit endian VR 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é

la gestion des erreurs:

-E --stop-sur-erreur
ne pas écrire si le dump est endommagé (par défaut)

+E --ignore-erreurs
tenter d'écrire même si le dump est endommagé

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 f
et éléments sur plusieurs 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

Déverser Fichier Description
Le fichier d'entrée peut être une sortie de dcmdump (format en retrait par défaut uniquement). Un élément
(tag, VR, valeur) doit être écrit sur une ligne séparée par des espaces arbitraires ou une tabulation
personnages. Un '#' commence un commentaire qui se termine à la fin de la ligne. Les lignes vides sont autorisées.

Les parties individuelles d'une ligne ont la syntaxe suivante :

Étiquette : (gggg,eeee)
avec gggg et eeee sont des valeurs hexadécimales à 4 caractères
représentant le groupe et la balise d'élément. Les espaces et les tabulations peuvent être
n'importe où dans une spécification de balise.
VR : La représentation de la valeur doit être écrite sur 2 caractères comme dans
Partie 6 de la norme DICOM. Aucun espace ni tabulation n'est autorisé
entre les deux personnages. Si la VR peut être déterminée à partir de
la balise, cette partie d'une ligne est facultative.
Valeur : Il existe plusieurs règles pour écrire des valeurs :
1. US, SS, SL, UL, FD, FL sont écrits sous forme de chaînes décimales qui
peut être lu par scanf().
2. AT est écrit comme '(gggg,eeee)' avec des espaces supplémentaires
supprimé automatiquement et gggg et eeee étant décimaux
des chaînes qui peuvent être lues par scanf().
3. Les valeurs OB et OW sont écrites sous forme d'octet ou de mot hexadécimal
valeurs séparées par le caractère '\'. Alternativement, OB ou OW
les valeurs peuvent être lues à partir d'un fichier séparé en écrivant le
nom de fichier préfixé par un caractère '=' (par exemple '=largepix.dat').
Le contenu du fichier sera lu tel quel. Par défaut, OW
les données devraient être classées petit endian et seront
é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
comme les lignes ou les colonnes.
En cas de données de pixels compressées, la ligne doit commencer par
'(7fe0,0010) OB (PixelSequence' afin de distinguer de
données de pixels non compressées.
4. L'interface utilisateur est écrite comme '=Nom' dans le dictionnaire de données ou comme unique
chaîne d'identification (voir 6.), par exemple '[1.2.840.....]'.
5. Les chaînes sans () <> [] espaces, tabulations et # peuvent être écrites
directement.
6. Les autres chaînes doivent être entourées de '[' et ']'. Pas de support
la structure est passée. La valeur se termine au dernier ']' dans le
ligne. Tout ce qui se trouve après le ']' est interprété comme un commentaire.
7. '(' et '<' sont interprétés de manière spéciale et ne peuvent pas être utilisés lorsque
écrire un fichier d'entrée à la main comme premiers caractères d'un
chaîne de caractères. Les valeurs multiples sont séparées par '\'. Les lignes
n'a pas besoin d'être trié dans l'ordre croissant des balises. Références dans
Les répertoires DICOM ne sont pas pris en charge. Les erreurs sémantiques sont
non-détecté.

Exemple
(0008,0020) DA [19921012] # 8, 1 date d'étude
(0008,0016 26) UI = MRImageStorage # 1, XNUMX SOPClassUID
(0002,0012) Interface utilisateur [1.2.276.0.7230010.100.1.1]
(0020,0032) DS [0.0\0.0] # 8, 2 ImagePositionPatient
(0028,0009 3004,000) AT (4 1c) # XNUMX, XNUMX FrameIncrementPointer
(0028,0010) US 256 # 4, 1 lignes
(0002,0001) BO 01\00

Limites
Gardez à l'esprit que décharge2dcm 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

Le décharge2dcm 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 dump2dcm en ligne à l'aide des services onworks.net