dump2dcm - Online in de cloud

PROGRAMMA:

NAAM

dump2dcm - Converteer ASCII-dump naar DICOM-bestand

KORTE INHOUD

dump2dcm [opties] dumpfile-in dcmfile-uit

PRODUCTBESCHRIJVING

De dump2dcm hulpprogramma converteert een ASCII-dumpbestand naar een DICOM-bestand. Het dumpbestand heeft de extensie
hetzelfde formaat als de uitvoer van dcmdump. Het is dus mogelijk om de output van te vangen dcmdump
in een bestand, wijzig enkele kenmerken en maak een nieuw DICOM-bestand.

PARAMETERS

dumpfile-in dumpinvoerbestandsnaam

dcmfile-out DICOM-uitvoer bestandsnaam

OPTIES

algemeen opties
-h-help
print deze helptekst en sluit af

--versie
versie-informatie afdrukken en afsluiten

--argumenten
druk uitgebreide opdrachtregelargumenten af

-q --stil
stille modus, print geen waarschuwingen en fouten

-v --uitgebreid
uitgebreide modus, afdrukverwerkingsdetails

-d --debuggen
foutopsporingsmodus, foutopsporingsinformatie afdrukken

-ll --log-niveau [l]evel: tekenreeksconstante
(fataal, fout, waarschuwen, info, debuggen, traceren)
gebruik niveau l voor de logger

-lc --log-config [f]bestandsnaam: string
gebruik configuratiebestand f voor de logger

invoer opties
invoer bestandsformaat:

+f --lees-meta-info
meta-informatie lezen indien aanwezig (standaard)

-f --negeer-meta-info
negeer de meta-informatie van bestanden

bestandsinhoud bytevolgorde:

+rl --lees-bestand-klein
lees OW-gegevens met weinig endian (standaard)

+rb --lees-bestand-groot
lees OW-gegevens uit een bestand met big endian

andere invoermogelijkheden:

+l --line [m]ax-lengte: geheel getal
maximale lijnlengte m (standaard: 4096)

verwerking opties
unieke identificatiegegevens:

+Ug --genereer-nieuwe-uids
genereer een nieuwe Study/Series/SOP Instance UID

-Uo --overschrijf-uids niet
overschrijf bestaande UID's niet (standaard)

+Uo --overschrijf-uids
bestaande UID's overschrijven

uitvoer opties
uitvoer bestandsformaat:

+F --schrijf-bestand
schrijf bestandsformaat (standaard)

-F --schrijf-dataset
schrijf dataset zonder bestandsmeta-informatie

+Fu --update-meta-info
update bepaalde bestandsmeta-informatie

syntaxis voor uitvoeroverdracht:

+t= --schrijf-xfer-zelfde
schrijf met dezelfde TS als invoer (standaard)

+te --write-xfer-klein
schrijf met expliciete VR Little Endian

+tb --write-xfer-big
schrijf met expliciete VR big endian TS

+ti --schrijf-xfer-impliciet
schrijf met impliciete VR little endian TS

+td --write-xfer-leeggelopen
schrijf met leeggelopen expliciete VR little endian TS

foutafhandeling:

-E --stop-bij-fout
schrijf niet als de dump beschadigd is (standaard)

+E --negeer-fouten
proberen te schrijven, zelfs als de dump beschadigd is

waarderepresentaties na 1993:

+u --enable-nieuwe-vr
ondersteuning voor nieuwe VR's inschakelen (UN/UT) (standaard)

-u --disable-nieuwe-vr
ondersteuning voor nieuwe VR's uitschakelen, converteren naar OB

groepslengte codering:

+g= --groepslengte-herberekenen
herbereken groepslengtes indien aanwezig (standaard)

+g --groep-lengte-maken
schrijf altijd met groepslengte-elementen

-g --groep-lengte-verwijderen
schrijf altijd zonder groepslengte-elementen

lengtecodering in reeksen en items:

+e --lengte-expliciet
schrijf met expliciete lengtes (standaard)

-e --lengte-undefined
schrijf met ongedefinieerde lengtes

dataset trailing padding (niet met --write-dataset):

-p= --padding-vasthouden
verander de opvulling niet (standaard indien niet --write-dataset)

-p --padding-off
geen opvulling (impliciet als --write-dataset)

+p --padding-create [f]ile-pad [i]temp-pad: geheel getal
align bestand op veelvoud van f bytes
en items op een veelvoud van i bytes

compressieniveau leeglopen (alleen met --write-xfer-deflated):

+cl --compressie-niveau [l]evel: geheel getal (standaard: 6)
0=ongecomprimeerd, 1=snelste, 9=beste compressie

OPMERKINGEN

Storten Dien in Beschrijving
Het invoerbestand kan een uitvoer zijn van dcmdump (alleen standaard ingesprongen formaat). Eén element
(tag, VR, waarde) moet op één regel worden geschreven, gescheiden door willekeurige spaties of tabs
karakters. Een '#' begint een commentaar dat eindigt aan het einde van de regel. Lege regels zijn toegestaan.

De afzonderlijke delen van een regel hebben de volgende syntaxis:

Label: (gggg,eeee)
met gggg en eeee zijn hexadecimale waarden van 4 tekens
die de groeps- en elementtag vertegenwoordigt. Spaties en tabs kunnen dat zijn
ergens in een tagspecificatie.
VR: Waardeweergave moet worden geschreven als 2 tekens zoals in
Deel 6 van de DICOM-standaard. Er zijn geen spaties of tabs toegestaan
tussen de twee karakters. Als de VR kan worden bepaald uit
de tag, dit deel van een regel is optioneel.
Waarde: Er zijn verschillende regels voor het schrijven van waarden:
1. US, SS, SL, UL, FD, FL worden geschreven als decimale tekenreeksen
kan worden gelezen door scanf().
2. AT wordt geschreven als '(gggg,eeee)' met extra spaties
automatisch verwijderd en gggg en eeee zijn decimaal
tekenreeksen die kunnen worden gelezen door scanf().
3. OB- en OW-waarden worden geschreven als byte of als hexadecimaal woord
waarden gescheiden door het teken '\'. Als alternatief OB of OW
waarden kunnen uit een afzonderlijk bestand worden gelezen door het bestand
bestandsnaam voorafgegaan door een '='-teken (bijvoorbeeld '=largepix.dat').
De inhoud van het bestand wordt gelezen zoals het is. Standaard is OW
de gegevens zullen naar verwachting weinig endian geordend zijn en dat zal ook zo zijn
indien nodig verwisseld. Er zullen geen controles worden uitgevoerd om dit te garanderen
de hoeveelheid gegevens is redelijk in termen van andere kenmerken
zoals rijen of kolommen.
In het geval van gecomprimeerde pixelgegevens moet de regel beginnen met
'(7fe0,0010) OB (PixelSequence' om onderscheid te maken van
ongecomprimeerde pixelgegevens.
4. De gebruikersinterface wordt in de data dictionary geschreven als '=Naam' of als uniek
identificatiereeks (zie 6.), bijvoorbeeld '[1.2.840.....]'.
5. Tekenreeksen zonder () <> [] spaties, tabs en # kunnen worden geschreven
direct.
6. Andere strings moeten worden omgeven door '[' en ']'. Geen beugel
structuur wordt doorgegeven. De waarde eindigt bij de laatste ']' in de
lijn. Alles na de ']' wordt geïnterpreteerd als commentaar.
7. '(' en '<' worden speciaal geïnterpreteerd en mogen niet worden gebruikt wanneer
met de hand een invoerbestand schrijven als begintekens van a
snaar. Meerdere waarden worden gescheiden door '\'. De lijnen
hoeven niet in oplopende tagvolgorde te worden gesorteerd. Referenties binnen
DICOM-mappen worden niet ondersteund. Semantische fouten zijn dat wel
niet gedetecteerd.

Voorbeeld
(0008,0020) DA [19921012] # 8, 1 Studiedatum
(0008,0016) UI =MRImageStorage # 26, 1 SOPClassUID
(0002,0012) Gebruikersinterface [1.2.276.0.7230010.100.1.1]
(0020,0032) DS [0.0\0.0] # 8, 2 ImagePositionPatiënt
(0028,0009) AT (3004,000c) # 4, 1 FrameIncrementPointer
(0028,0010) US 256 nr. 4, 1 rijen
(0002,0001) OB 01\00

Beperkingen
Let op: dump2dcm ondersteunt momenteel DICOMDIR-bestanden niet volledig. Concreet,
de waarde van de verschillende offsetgegevenselementen wordt door deze tool niet automatisch bijgewerkt.

LOGGEN

Het niveau van de logboekuitvoer van de verschillende opdrachtregelprogramma's en onderliggende bibliotheken kan
door de gebruiker worden opgegeven. Standaard worden alleen fouten en waarschuwingen naar de standaard geschreven
foutstroom. Optie gebruiken: --uitgebreid ook informatieve berichten zoals verwerkingsdetails
zijn gerapporteerd. Optie --debuggen kan worden gebruikt om meer details te krijgen over de interne activiteit,
bijvoorbeeld voor foutopsporingsdoeleinden. Andere logniveaus kunnen worden geselecteerd met optie --loggen-
niveau. in --stil modus worden alleen fatale fouten gerapporteerd. In zulke zeer ernstige foutgebeurtenissen,
de toepassing wordt meestal beëindigd. Voor meer details over de verschillende logniveaus,
zie documentatie van module 'oflog'.

In het geval dat de logoutput naar een bestand moet worden geschreven (optioneel met logfile-rotatie),
naar syslog (Unix) of de gebeurtenislogboek (Windows) optie --log-config kan worden gebruikt. Dit
configuratiebestand maakt het ook mogelijk om alleen bepaalde berichten naar een bepaalde uitvoer te leiden
stream en voor het filteren van bepaalde berichten op basis van de module of applicatie waar ze
worden gegenereerd. Een voorbeeldconfiguratiebestand vindt u in /logger.cfg.

COMMAND LINE

Alle opdrachtregelprogramma's gebruiken de volgende notatie voor parameters: vierkante haken omsluiten
optionele waarden (0-1), drie volgpunten geven aan dat meerdere waarden zijn toegestaan
(1-n), een combinatie van beide betekent 0 tot n waarden.

Opdrachtregelopties worden onderscheiden van parameters door een voorlopend '+'- of '-'-teken,
respectievelijk. Gewoonlijk zijn de volgorde en positie van de opdrachtregelopties willekeurig
kan overal verschijnen). Als opties elkaar echter uitsluiten, is de meest rechtse verschijning
is gebruikt. Dit gedrag komt overeen met de standaard evaluatieregels van gewone Unix-shells.

Bovendien kunnen een of meer opdrachtbestanden worden opgegeven met een '@'-teken als voorvoegsel voor
de bestandsnaam (bijv @commando.txt). Zo'n commandoargument wordt vervangen door de inhoud van
het corresponderende tekstbestand (meerdere spaties worden behandeld als een enkel scheidingsteken tenzij
ze verschijnen tussen twee aanhalingstekens) voorafgaand aan elke verdere evaluatie. Houd er rekening mee dat:
een commandobestand kan geen ander commandobestand bevatten. Deze eenvoudige maar effectieve aanpak
maakt het mogelijk om veelvoorkomende combinaties van opties/parameters samen te vatten en vermijdt langdradig en
verwarrende opdrachtregels (een voorbeeld wordt gegeven in bestand /dumppat.txt).

MILIEU

De dump2dcm hulpprogramma zal proberen om DICOM-gegevenswoordenboeken te laden die zijn gespecificeerd in de
DCMDICTPAD omgevingsvariabele. Standaard, dwz als de DCMDICTPAD variabele omgeving
is niet ingesteld, het bestand /dicom.dic wordt geladen tenzij het woordenboek is gebouwd
in de toepassing (standaard voor Windows).

Het standaardgedrag moet de voorkeur hebben en de DCMDICTPAD alleen omgevingsvariabele
gebruikt wanneer alternatieve gegevenswoordenboeken vereist zijn. De DCMDICTPAD variabele omgeving
heeft hetzelfde formaat als de Unix-shell PATH variabele in dat een dubbele punt (':') scheidt
inzendingen. Op Windows-systemen wordt een puntkomma (';') als scheidingsteken gebruikt. Het datadictionary
code zal proberen om elk bestand te laden dat is gespecificeerd in de DCMDICTPAD omgevingsvariabele. Het
is een fout als er geen datadictionary kan worden geladen.

Gebruik dump2dcm online met behulp van onworks.net-services