img2dcm – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

img2dcm – Konvertieren Sie Standardbildformate in das DICOM-Format

ZUSAMMENFASSUNG

img2dcm [Optionen] imgfile-in dcmfile-out

BESCHREIBUNG

Das img2dcm Das Tool dient als Konvertierungstool aus einem Standardbildformat wie JPEG oder BMP
zu DICOM. Es können verschiedene Ausgabe-SOP-Klassen ausgewählt werden. Die zusätzlichen Informationen
(in Bezug auf Patienten, Serien usw.), die in der DICOM-Ausgabedatei gespeichert sind, können daraus extrahiert werden
andere DICOM-Dateien, die als „Vorlage“ für das resultierende DICOM-Objekt dienen. img2dcm kann
Außerdem kann es so konfiguriert werden, dass fehlende DICOM-Attribute vom Typ 1 und 2 erkannt werden, damit es funktioniert
ohne Vorlagedatensatz.

PARAMETER

imgfile-in Bilddatei, die importiert werden soll

dcmfile-out DICOM-Ausgabedatei

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
Allgemeines:

-i --input-format [i]nput-Dateiformat: string
Unterstützte Formate: JPEG (Standard), BMP

-df --dataset-from [Dateiname: Zeichenfolge
Verwenden Sie den Datensatz aus der DICOM-Datei f

-stf --study-from [Dateiname: Zeichenfolge
Patienten/Studie aus DICOM-Datei lesen f

-sef --series-from [Dateiname: Zeichenfolge
Patienten/Studie/Serie aus DICOM-Datei lesen f

-ii --instance-inc
Erhöhen Sie die aus der DICOM-Datei gelesene Instanznummer

JPEG-Format:

-dp --disable-progr
Deaktivieren Sie die Unterstützung für progressives JPEG

-de --disable-ext
Deaktivieren Sie die Unterstützung für erweitertes sequentielles JPEG

-jf --insist-on-jfif
Bestehen Sie auf der Existenz eines JFIF-Headers

-ka --keep-appn
APPn-Abschnitte behalten (außer JFIF)

Verarbeitung Optionen
Attributprüfung:

--do-checks
Attributgültigkeitsprüfung aktivieren (Standard)

--no-checks
Deaktivieren Sie die Gültigkeitsprüfung von Attributen

+i2 --insert-type2
Fehlende Typ-2-Attribute einfügen (Standard)
(nur mit --do-checks)

-i2 --no-type2-insert
Fügen Sie keine fehlenden Attribute vom Typ 2 ein
(nur mit --do-checks)

+i1 --invent-type1
Erfinden Sie fehlende Typ-1-Attribute
(nur mit --do-checks)

-i1 --no-type1-invent
Erfinden Sie keine fehlenden Attribute vom Typ 1
(nur mit --do-checks)

Zeichensatz:

+l1 --latin1
Latin-1 als Standardzeichensatz festlegen (Standard)

-l1 --no-latin1
Behalten Sie 7-Bit-ASCII als Standardzeichensatz bei

weitere Verarbeitungsmöglichkeiten:

-k --key [k]ey: gggg,eeee="str", Pfad oder Wörterbuchname="str"
Weiteres Attribut hinzufügen

Ausgabe Optionen
Ziel-SOP-Klasse:

-sc --sec-capture
Schreiben Sie die Secondary Capture SOP-Klasse

-nsc --new-sc
Schreiben Sie neue Secondary Capture SOP-Klassen

-vlp --vl-foto
Schreiben Sie die SOP-Klasse „Visible Light Photographic“ (Standard)

Ausgabedateiformat:

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

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

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-off
kein Auffüllen (implizit wenn --write-dataset)

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

ANMERKUNG

Attribut Quellen
Zum Konvertieren eines allgemeinen Bildformats in das DICOM-Format ist das img2dcm Anwendung kann sein
mit einigen zusätzlichen Eingaben zum Ausfüllen obligatorischer (und optionaler) Attribute im neuen gespeist
DICOM-Datei wie Patienten-, Studien- und Serieninformationen. Diese Informationen können gesammelt werden
Dabei werden verschiedene Ansätze verwendet, die kombiniert und auf die Ergebnisdatei angewendet werden können
folgende Reihenfolge:

· Verwendung der --dataset-from zu erhalten img2dcm ist gezwungen, Attribute aus einem vorhandenen zu importieren
DICOM-Datei. Die angegebene DICOM-Datei wird vollständig importiert und dient als Grundlage für alles
weitere Exportgeschäfte. Ausnahmsweise wird dabei die SOP-Instanz-UID nicht kopiert
Möglichkeit. Auch bildbezogene Daten wie Zeilen, Spalten usw. werden bei der Konvertierung ausgetauscht.
Beachten Sie, dass img2dcm prüft keine anderen Attributwerte auf Gültigkeit, z. B. nicht
Sehen Sie sich keine Sequenzen an, um Attribute an das neue Objekt (referenzierte Bilder) anzupassen
usw.). Daher wird empfohlen, die Vorlagen im Datenverzeichnis für (alte) zu verwenden
SC- und VLP-Objekte. Siehe auch Abschnitt „Eingabevorlagen“.
· Das --studieren-von und --series-von Optionen (die sich gegenseitig ausschließen) können zum Importieren verwendet werden
Patienten-, Studien- und Serieninformationen aus einer vorhandenen DICOM-Datei. Wenn --series-von is
angegeben, dann wird die angegebene DICOM-Datei geöffnet img2dcm und alle Pflichtinformationen
bis auf Serienebene importiert. Beachten Sie, dass dies Patient, Studie und Serie umfasst
Information. Im Falle von --studieren-von, die Serieninformationen sind ausgeschlossen. Die folgende
Attribute werden übernommen:
Patientenebene:
Patientenname
Patienten ID
Geschlecht des Patienten
Geburtsdatum des Patienten
Spezifischer Zeichensatz

Studienstufe:
UID der Studieninstanz
Studiendatum
Lernzeit
Name des überweisenden Arztes
Studien-ID
Zugangsnummer

Serienebene (nur bei Option --series-from):
UID der Serieninstanz
Seriennummer
Hersteller
· Mit dem --insert-type2 und --invent-type1 Optionen (beide standardmäßig aktiviert), fehlen
Attribute (Typ-2-Attribute) und/oder fehlende Attributwerte (für Typ-1-Attribute)
werden automatisch hinzugefügt und erfunden von img2dcm. Bitte beachten Sie, dass diese Optionen nur verfügbar sind
ausgewertet, wenn Option --do-checks ist aktiviert (Standard). Wenn die --no-checks Optionen ist
aktiviert ist, findet keine automatische Attributeinfügung statt.
· Das --Schlüssel Mit der Option können weitere Attribute zur DICOM-Ausgabedatei hinzugefügt werden. Das
Die Option wird ganz am Ende angewendet, direkt vor dem Speichern der DICOM-Datei. Es ist auch
Mit dem ist es möglich, Sequenzen, Elemente und verschachtelte Attribute anzugeben --Schlüssel Möglichkeit. In
In diesen Fällen muss eine spezielle „Pfad“-Notation verwendet werden. Details zu dieser Pfadnotation finden Sie hier
finden Sie in der Dokumentation von dcmodify.
UIDs
Es werden neue Studien- und Serieninstanz-UIDs generiert if notwendig, nach dem Auftragen der --lernen-
für und --Serie Optionen. Wenn die UID der Studieninstanz oder die UID der Serieninstanz nicht vorhanden sind
Nach diesen Schritten werden sie unabhängig voneinander neu generiert. Ein Gegenteil
Für die SOP-Instanz-UID wird ein Verhalten gewählt, mit dessen Übernahme man rechnen kann, wenn
Verwendung der --dataset-from Möglichkeit. Das ist nicht In diesem Fall lautet die SOP-Instanz-UID nicht kopiert
zum neuen Objekt. Dies sollte für die meisten Anwendungsfälle das gewünschte Verhalten sein. Wenn jedoch a
In das neue Objekt soll eine bestimmte SOP-Instanz-UID eingefügt werden --Schlüssel Option sollte
verwendet werden.
zufuhr Template
Zur Unterstützung der Konvertierung in DICOM, img2dcm enthält einige vordefinierte Vorlagen
die für die verwendet werden können --dataset-from Option (siehe Beispieldateien). SC.dump und VLP.dump).
Diese Vorlagen sollten mit den gewünschten Werten gefüllt werden und müssen dann entsorgt werden
(konvertiert) in eine DICOM-Datei, bevor es tatsächlich verwendet wird img2dcm. Benutzen dump2dcm zu
Konvertieren Sie den Dump in DICOM. Beispiel:
dump2dcm SC.dump SC.dcm

Es ist möglich, jede beliebige DICOM-Datei als Vorlage zu verwenden. Bitte beachten Sie, dass die vollständige DICOM
Datensatz wird importiert; Daher sollte sichergestellt werden, dass nur Attribute vorhanden sind, die
sollte Teil des erstellten DICOM-Objekts sein. Die SOP-Klassen-UID und die Pixeldaten
Attribute (einschließlich Attribute wie Zeilen, Spalten usw.) werden nicht kopiert, sondern durch ersetzt
img2dcm während der Konvertierung.
zufuhr Plugins
Das img2dcm Die Anwendung unterstützt derzeit das JPEG- und das BMP-Bildformat als Eingabe.
JPEG zufuhr Plugin
Bei JPEG wird das ursprüngliche JPEG aus der Quelldatei nicht dekodiert, sondern leicht extrahiert
transformiert (z. B. JFIF-Header wird abgeschnitten), um eine schnelle Konvertierung auch großer JPEG-Dateien zu ermöglichen
ohne die Notwendigkeit einer Dekodierung und Neukodierung. Das JPEG-Plugin wählt die erforderliche Ausgabe
Übertragen Sie die Syntax automatisch abhängig von der tatsächlichen Kodierung der Daten im JPEG
Datei. Daher sind die folgenden Übertragungssyntaxen (und ihre entsprechenden JPEG-Kodierungen)
werden vom JPEG-Plugin verwendet:
· JPEG-Codierungsprozess 1 Baseline, verlustbehaftet, nicht hierarchisch, sequentiell, DCT, Huffman, 8 Bit
SOP-Klasse = 1.2.840.10008.1.2.4.50
· JPEG-Codierungsprozess 2 (8-Bit) und 4 (12-Bit) erweitert, verlustbehaftet, nicht hierarchisch,
Sequentiell, DCT, Huffman, 8/12 Bit SOP-Klasse = 1.2.840.10008.1.2.4.51
· JPEG-Codierungsprozess 10 (8-Bit) und 12 (12-Bit), vollständige Progression, verlustbehaftet, nicht hierarchisch.,
Progressiv, DCT, Huffman, 8/12 Bit SOP-Klasse = 1.2.840.10008.1.2.4.55
Es werden Farb- und Graustufenbilder unterstützt.
Die Unterstützung für die erweiterte JPEG-Übertragungssyntax kann deaktiviert werden (--disable-ext Option)
sowie die Unterstützung für die (eingestellte) Progressive JPEG Transfer Syntax (--disable-progr
Möglichkeit).
Sowohl die verlustfreie JPEG-Kodierung als auch alle arithmetischen oder hierarchischen JPEG-Kodierungsmodi sind möglich
wird vom Plugin nicht unterstützt.
JFIF-Informationen (JPEG File Interchange Format) ermöglichen optionale APPn-Markierungen in einem
JPEG-Datei. Viele Digitalkameras integrieren solche JFIF-Informationen nicht in das JPEG
Ausgabe, die sie erzeugen. JFIF enthält beispielsweise Informationen über das Pixel-Seitenverhältnis von
das komprimierte Bild. Wenn Sie das wollen img2dcm Antrag, auf einem JFIF-Header zu bestehen
Im JPEG-Stream können Sie die Option nutzen --insist-on-jfif was abgebrochen wird, wenn kein JFIF vorhanden ist
Informationen finden Sie. Standardmäßig werden fehlende JFIF-Informationen ignoriert.
Für DICOM ist es eine Art „Grauzone“, unabhängig davon, ob die Integration von JFIF (oder einer anderen APPn)
Daten in den internen JPEG-Stream des DICOM-Objekts sind zulässig oder nicht. Allerdings am meisten
Ein zuverlässiger Ansatz besteht darin, diese Markierungen und ihre Informationen aus dem JPEG-Stream herauszuschneiden. Das
Ansatz wird auch von der verfolgt img2dcm Anwendung. Standardmäßig werden alle APPn-Marker ausgeschnitten
vom ursprünglichen JPEG-Stream getrennt. Wenn Sie jedoch andere APPn-Marker behalten möchten als
JFIF (z. B. EXIF-Informationen) innerhalb des DICOM-Streams, die Option --keep-appn macht die
Trick. Es sollte auch etwas schneller sein als das Abschneiden von APPn-Informationen, weil es so ist
Es ist nicht erforderlich, den gesamten JPEG-Stream nach solchen Daten zu durchsuchen. JFIF-Informationen sind immer
entfernt von img2dcm.
BMP zufuhr Plugin
img2dcm unterstützt BMP als Eingabeformat. Bisher sind es jedoch nur die gängigsten BMP-Bilder
unterstützt. Dies gilt insbesondere für BMP-Bilder, die Bitfelder oder Lauflängenkodierung verwenden
abgelehnt. Solche Bilder sind ungewöhnlich. Alle Eingabebilder werden in ein DICOM-Bild umgewandelt
mit RGB-Farbmodell und einer Bittiefe von 24. Es gibt keine spezifischen Optionen zur Feinabstimmung
Konvertierung des BMP-Formats.
Output Plugins
Die gewünschte Ausgabe-SOP-Klasse kann in der Befehlszeile ausgewählt werden. Derzeit ein Export
Plugin für die Secondary Capture Image SOP-Klasse (Standard, Option -SC), die neue Sekundarstufe
Capture Image SOP-Klassen (Option -nsc) und SOP-Klasse für fotografische Bilder mit sichtbarem Licht
(Möglichkeit -vl) stehen zur Verfügung. Bitte beachten Sie, dass die erste Version veraltet ist
Der DICOM-Standard wird jedoch als Standard ausgewählt, da er weithin unterstützt wird. Zukunft
Versionen img2dcm stellt möglicherweise weitere Ausgabe-Plugins für andere SOP-Klassen bereit.
Für die neuen Secondary Capture SOP-Klassen ist es nicht möglich, die spezifischen Klassen anzugeben
Für die Ausgabe sollte die SOP-Klasse verwendet werden. Das liegt daran, dass diese neuen SOP-Klassen vorhanden sind
unterscheiden sich voneinander durch die Farbtiefe (1/8/16) und die Tatsache, ob das Bild vorhanden ist
schwarz/weiß oder farbig. Darum img2dcm entscheidet bei der Konvertierung, welche SOP ausgegeben wird
Die Klasse ist für ein bestimmtes Quellbild geeignet.

Beispiele:

Hier sind einige Beispiele, die zeigen, wie das funktioniert img2dcm Anwendung genutzt werden kann.
1. img2dcm image.jpg out.dcm
Lesen Sie die JPEG-Datei „image.jpg“, konvertieren Sie sie in die alte Secondary Capture SOP-Klasse und speichern Sie sie
das Ergebnis in die DICOM-Datei „out.dcm“. Dies ist die einfachste Art der Verwendung img2dcm. Jeder Typ
Die zum Schreiben gültiger Objekte dieser SOP-Klasse erforderlichen Attribute vom Typ 1 und Typ 2 sind
automatisch eingefügt.
2. img2dcm -i BMP image.bmp out.dcm
Wie oben, aber weist img2dcm an, eine BMP-Datei anstelle einer JPEG-Datei zu lesen.
3. img2dcm image.jpg out.dcm -vlp -k 'PatientName=Bond^James'
Wie erstes Beispiel, schreibt aber das Objekt „Visible Light Photographic Image“ in „out.dcm“.
und setzt PatientName auf „Bond^James“, was andernfalls leer bleiben würde.
4. img2dcm image.jpg out.dcm --series-from template.dcm -k 'PatientName=Bond^James'
Wie 1), importiert jedoch Patienten-/Studien-/Serieninformationen aus der DICOM-Datei
'template.dcm'. Bitte beachten Sie, dass das Attribut PatientName „Bond^James“ enthält
Am Ende wird jeder Wert aus „template.dcm“ überschrieben. Das liegt daran, dass -k
Die Option wird ganz am Ende der Konvertierungspipeline angewendet (siehe oben).
5. img2dcm image.jpg out.dcm --no-checks
Wie 1), führt jedoch keine Attributprüfung und keinen Typ 1 und Typ 2 durch
Attributeinfügung! In diesem Fall würde also ein ungültiges DICOM-Objekt generiert werden. Das
kann interessant sein, wenn die Ausgabedatei nicht zur Vervollständigung gedacht ist, sondern durchlaufen wird
weitere Transformationen, z. B. Hinzufügen von Attributen mit dcmodify. Nur Option verwenden --Nein-
Schecks wenn du weißt, was du tust!
6. img2dcm image.jpg out.dcm --no-type1-invent
Wie 1), fügt jedoch fehlende Attribute vom Typ 1 und/oder deren Werte nicht ein. Typ 2
Attribute werden eingefügt. Beachten Sie, dass in diesem Fall sichergestellt sein muss, dass alle Typ 1
Attribute werden auf andere Weise bereitgestellt, z. B. durch Hinzufügen mit dem --Schlüssel .
Andernfalls img2dcm meldet einen Fehler und bricht die Konvertierung ab.
7. img2dcm image.jpg out.dcm --keep-appn --insist-on-jfif
Wie 1), übernimmt aber APPn-Informationen wie EXIF ​​in die DICOM-Objekte
resultierenden JPEG-Stream. Weiter, --insist-on-jfif Willenskraft img2dcm abbrechen, wenn nein
JFIF-Informationen sind in der Quelldatei vorhanden.

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 img2dcm 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.

Verwenden Sie img2dcm online über die Dienste von onworks.net