xml2dcm – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

xml2dcm – Konvertieren Sie ein XML-Dokument in eine DICOM-Datei oder einen Datensatz

ZUSAMMENFASSUNG

xml2dcm [Optionen] xmlfile-in dcmfile-out

BESCHREIBUNG

Das xml2dcm Das Dienstprogramm konvertiert den Inhalt eines XML-Dokuments (Extensible Markup Language).
in eine DICOM-Datei oder einen Datensatz. Es wird erwartet, dass das XML-Dokument anhand der DTD validiert wird
(Dokumenttypdefinition), die in der Datei beschrieben wird dcm2xml.dtd. Eine entsprechende XML-Datei
kann mit erstellt werden dcm2xml Werkzeug (Option +Wb Es wird empfohlen, Binärdaten einzubeziehen).

PARAMETER

xmlfile-in XML-Eingabedateiname, der konvertiert werden soll (stdin: „-“)

dcmfile-out DICOM-Ausgabedateiname

OPTIONAL

General Optionen
-h - Hilfe
Diesen Hilfetext drucken und beenden

--Version
Versionsinformationen drucken und beenden

--Argumente
drucke erweiterte Befehlszeilenargumente

-q --leise
Ruhemodus, keine Warnungen und Fehler drucken

-v --verbose
ausführlicher Modus, Verarbeitungsdetails drucken

-d --debug
Debug-Modus, Debug-Informationen drucken

-ll --log-level [l]evel: Stringkonstante
(fatal, Fehler, Warnung, Info, Debug, Trace)
Verwenden Sie Level l für den Logger

-lc --log-config [Dateiname: Zeichenfolge
Verwenden Sie die Konfigurationsdatei f für den Logger

Eingabe Optionen
Eingabedateiformat:

+f --read-meta-info
Metainformationen lesen, falls vorhanden (Standard)

-f --ignore-meta-info
Datei-Metainformationen ignorieren

Verarbeitung Optionen
Validierung:

+Vd --validate-document
XML-Dokument anhand der DTD validieren

+Vn --Check-Namespace
Überprüfen Sie den XML-Namespace im Dokumentstamm

eindeutige Kennungen:

+Ug --generate-new-uids
neue Studien-/Serien-/SOP-Instanz-UID generieren

-Uo --uids-nicht-überschreiben
vorhandene UIDs nicht überschreiben (Standard)

+Uo --uids überschreiben
vorhandene UIDs überschreiben

Ausgabe Optionen
Ausgabedateiformat:

+F --write-Datei
Dateiformat schreiben (Standard)

-F --Datensatz schreiben
Datensatz ohne Datei-Metainformationen schreiben

+Fu --update-meta-info
bestimmte Datei-Metainformationen aktualisieren

Syntax der Ausgabeübertragung:

+t= --write-xfer-same
Schreiben mit demselben TS wie Eingabe (Standard)

+te --write-xfer-little
schreibe mit explizitem VR Little Endian TS

+tb --write-xfer-big
schreibe mit explizitem VR Big Endian TS

+ti --write-xfer-implizit
Schreiben Sie mit implizitem VR Little Endian TS

+td --write-xfer-deflationiert
schreibe mit deflationiertem explizitem VR Little Endian TS

Wertdarstellungen nach 1993:

+u --enable-new-vr
Unterstützung für neue VRs aktivieren (UN/UT) (Standard)

-u --disable-new-vr
Unterstützung für neue VRs deaktivieren, in OB konvertieren

Gruppenlängencodierung:

+g= --group-length-recalc
Gruppenlängen neu berechnen, falls vorhanden (Standard)

+g --group-length-create
immer mit Gruppenlängenelementen schreiben

-g --group-length-remove
immer ohne Gruppenlängenelemente schreiben

Längenkodierung in Sequenzen und Items:

+e --länge-explizit
mit expliziten Längen schreiben (Standard)

-e --länge-undefiniert
mit undefinierten Längen schreiben

Datensatz-Trailing-Padding (nicht mit --write-dataset):

-p= --padding-retain
Padding nicht ändern (Standard, wenn nicht --write-dataset)

-p --padding-off
kein Auffüllen (implizit wenn --write-dataset)

+p --padding-create [file-pad] [i]tem-pad: ganze Zahl
Datei auf mehrere f Bytes und Elemente auf ausrichten
Vielfaches von i Bytes

Komprimierungsstufe deflate (nur mit --write-xfer-deflated):

+cl --compression-level [l]evel: Ganzzahl (Standard: 6)
0=unkomprimiert, 1=schnellste, 9=beste Komprimierung

ANMERKUNG

Die Grundstruktur der erwarteten XML-Eingabe sieht wie folgt aus:



<Dateiformat 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_IR 100

...


<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" geladen="nein" binär="versteckt">




Bei DICOM-Datensätzen können die Tags „file-format“ und „meta-header“ fehlen.

Charakter Codierung
Die DICOM-Zeichenkodierung wird automatisch aus dem Element mit Tag ermittelt
„0008,0005“ (Spezifischer Zeichensatz) – falls vorhanden. Die folgenden Zeichensätze sind
derzeit unterstützt (erfordert libxml zu schließen iconv Unterstützung, siehe --Version Ausgang):

ASCII (ISO_IR 6) (UTF-8)
UTF-8 „ISO_IR 192“ (UTF-8)
ISO Latein 1 „ISO_IR 100“ (ISO-8859-1)
ISO Latein 2 „ISO_IR 101“ (ISO-8859-2)
ISO Latein 3 „ISO_IR 109“ (ISO-8859-3)
ISO Latein 4 „ISO_IR 110“ (ISO-8859-4)
ISO Latein 5 „ISO_IR 148“ (ISO-8859-9)
Kyrillisch „ISO_IR 144“ (ISO-8859-5)
Arabisch „ISO_IR 127“ (ISO-8859-6)
Griechisch „ISO_IR 126“ (ISO-8859-7)
Hebräisch „ISO_IR 138“ (ISO-8859-8)

Mehrere Zeichensätze werden nicht unterstützt (nur der erste Wert des „Spezifischen Zeichens“)
Set' wird für die Zeichenkodierung bei Wertemultiplizität verwendet.

See dcm2xml Weitere Informationen zur XML-Struktur finden Sie in der Dokumentation.

Binär Datum
Binärdaten können entweder als Folge von durch einen Backslash getrennten Hexadezimalzahlen kodiert werden
'\' oder im Base64-Format (binary='base64'). Darüber hinaus können auch Binärdaten ausgelesen werden
Datei (binary='file'). In diesem Fall muss der Dateiname als Elementwert angegeben werden,
z.B

Unterverzeichnis/pixeldata.raw

Bitte beachten Sie, dass der Inhalt der Datei unverändert gelesen wird. OW-Daten werden erwartet
Little Endian bestellt und wird bei Bedarf getauscht. Es werden keine Kontrollen zur Sicherstellung durchgeführt
dass die Datenmenge im Hinblick auf andere Attribute wie Zeilen oder angemessen ist
Säulen.

Kompression
Wenn libxml mit Zlib-Unterstützung kompiliert wird, ist die Eingabedatei (xmlfile-in) kann auch sein
mit ZIP komprimiert, was in der Regel zu deutlich kleineren Dateien führt. Siehe Ausgabe der Option
--Version um zu prüfen, ob zlib-Unterstützung verfügbar ist.

Einschränkungen
Verschiedene Versionen von libxml können unterschiedliche Beschränkungen für die maximale Länge eines XML haben
Elementwert. Daher sollte die Verwendung sehr langer Elementwerte (z. B. for) vermieden werden
Pixeldaten).

Bitte beachten Sie, dass xml2dcm unterstützt derzeit DICOMDIR-Dateien nicht vollständig. Speziell,
der Wert der verschiedenen Offset-Datenelemente wird von diesem Werkzeug nicht automatisch aktualisiert.

LOGGING

Der Grad der Protokollausgabe der verschiedenen Befehlszeilentools und zugrunde liegenden Bibliotheken kann
vom Benutzer angegeben werden. Standardmäßig werden nur Fehler und Warnungen in den Standard geschrieben
Fehlerstrom. Option verwenden - ausführlich auch Informationsnachrichten wie Verarbeitungsdetails
sind gemeldet. Möglichkeit --debuggen kann verwendet werden, um mehr Details über die interne Aktivität zu erfahren,
zB für Debugging-Zwecke. Andere Protokollierungsebenen können mit Option ausgewählt werden --Protokoll-
Grad des . in --ruhig Modus werden nur schwerwiegende Fehler gemeldet. Bei solchen sehr schwerwiegenden Fehlerereignissen
die Anwendung wird normalerweise beendet. Weitere Informationen zu den verschiedenen Protokollierungsebenen finden Sie unter
siehe Dokumentation des Moduls 'oflog'.

Falls die Logging-Ausgabe in eine Datei geschrieben werden soll (optional mit Logfile-Rotation),
in Syslog (Unix) oder die Option Ereignisprotokoll (Windows) --log-config kann verwendet werden. Dies
Konfigurationsdatei ermöglicht es auch, nur bestimmte Nachrichten an einen bestimmten Ausgang zu leiten
Stream und zum Filtern bestimmter Nachrichten basierend auf dem Modul oder der Anwendung, in der sie
sind generiert. Eine Beispielkonfigurationsdatei finden Sie in /logger.cfg.

COMMAND LINE

Alle Befehlszeilentools verwenden die folgende Notation für Parameter: eckige Klammern umschließen
optionale Werte (0-1), drei nachgestellte Punkte zeigen an, dass mehrere Werte zulässig sind
(1-n), eine Kombination aus beiden bedeutet 0 bis n Werte.

Befehlszeilenoptionen werden von Parametern durch ein führendes '+' oder '-' Zeichen unterschieden.
bzw. Normalerweise sind Reihenfolge und Position von Befehlszeilenoptionen willkürlich (dh sie
kann überall erscheinen). Wenn sich die Optionen jedoch gegenseitig ausschließen, ist das Erscheinungsbild ganz rechts
wird genutzt. Dieses Verhalten entspricht den Standard-Auswertungsregeln gängiger Unix-Shells.

Darüber hinaus können eine oder mehrere Befehlsdateien mit einem '@'-Zeichen als Präfix für . angegeben werden
der Dateiname (zB @command.txt). Ein solches Befehlsargument wird durch den Inhalt von . ersetzt
die entsprechende Textdatei (mehrere Leerzeichen werden als einzelnes Trennzeichen behandelt, es sei denn
sie stehen zwischen zwei Anführungszeichen) vor jeder weiteren Auswertung. Bitte beachte, dass
Eine Befehlsdatei kann keine andere Befehlsdatei enthalten. Dieser einfache, aber effektive Ansatz
erlaubt es, gängige Kombinationen von Optionen/Parametern zusammenzufassen und vermeidet langwierige und
verwirrende Befehlszeilen (ein Beispiel finden Sie in der Datei /dumppat.txt).

Das xml2dcm Dienstprogramm versucht, DICOM-Datenwörterbücher zu laden, die im
DCMDICTPATH Umgebungsvariable. Standardmäßig, dh wenn die DCMDICTPATH variable Umgebung
ist nicht gesetzt, die Datei /dicom.dic wird geladen, es sei denn, das Wörterbuch ist erstellt
in die Anwendung (Standard für Windows).

Das Standardverhalten sollte bevorzugt werden und die DCMDICTPATH Nur Umgebungsvariable
verwendet, wenn alternative Datenwörterbücher benötigt werden. Die DCMDICTPATH variable Umgebung
hat das gleiche Format wie die Unix-Shell PATH variabel, indem ein Doppelpunkt (':') trennt
Einträge. Auf Windows-Systemen wird ein Semikolon (';') als Trennzeichen verwendet. Das Datenwörterbuch
Der Code versucht, jede in der Datei angegebene Datei zu laden DCMDICTPATH Umgebungsvariable. Es
ist ein Fehler, wenn kein Data Dictionary geladen werden kann.

Nutzen Sie xml2dcm online über die Dienste von onworks.net