Dit is de opdracht dcmdump die kan worden uitgevoerd in de gratis hostingprovider van OnWorks met behulp van een van onze meerdere gratis online werkstations zoals Ubuntu Online, Fedora Online, Windows online-emulator of MAC OS online-emulator
PROGRAMMA:
NAAM
dcmdump - DICOM-bestand en dataset dumpen
KORTE INHOUD
dcmdump [opties] dcmfile-in...
PRODUCTBESCHRIJVING
De dcmdump hulpprogramma dumpt de inhoud van een DICOM-bestand (bestandsindeling of onbewerkte gegevensset) naar
stdout in tekstvorm. Attributen met zeer grote waardevelden (bijv. pixelgegevens) kunnen dat zijn
beschreven als '(niet geladen)'. Tekenreekswaardevelden worden afgebakend met vierkante haken
([]). Bekende UID's worden weergegeven met hun naam voorafgegaan door een gelijkteken (bijv
'=MRImageStorage') tenzij deze toewijzing expliciet zou worden uitgeschakeld. Lege waarde
velden worden beschreven als '(geen waarde beschikbaar)'.
If dcmdump leest een onbewerkte dataset (DICOM-gegevens zonder een meta-header in bestandsindeling)
probeer de overdrachtsyntaxis te raden door de eerste paar bytes van het bestand te onderzoeken. Het is
niet altijd mogelijk om de overdrachtsyntaxis correct te raden en het is beter om a . te converteren
gegevens waar mogelijk in een bestandsindeling worden gezet (met behulp van de dcmconv nut). Het is ook
mogelijk om de te gebruiken -f en -t[ieb] opties om te forceren dcmdump een dataset lezen met a
bepaalde overdrachtsyntaxis.
PARAMETERS
dcmfile-in DICOM-invoerbestand of map die moet worden gedumpt
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-bestand
lees bestandsformaat of dataset (standaard)
+fo --alleen-lezen-bestand
alleen bestandsformaat lezen
-f --lees-dataset
lees dataset zonder bestandsmeta-informatie
invoer overdracht syntaxis:
-t= --lees-xfer-auto
gebruik TS-herkenning (standaard)
-td --read-xfer-detect
negeer TS gespecificeerd in de metaheader van het bestand
-te --lees-xfer-little
lezen met expliciete VR little endian TS
-tb --read-xfer-big
lezen met expliciete VR big endian TS
-ti --lees-xfer-impliciet
lezen met impliciete VR little endian TS
invoer bestanden:
+sd --scan-mappen
mappen scannen op invoerbestanden (dcmfile-in)
+sp --scan-patroon [p]attern: string (alleen met --scan-directories)
patroon voor het matchen van bestandsnamen (jokertekens)
# mogelijk niet beschikbaar op alle systemen
-r --geen-recursie
niet herhalen binnen mappen (standaard)
+r --recursie
recursief binnen gespecificeerde mappen
lange tag-waarden:
+M --alles laden
laad zeer lange tagwaarden (standaard)
-M --last-kort
laad geen erg lange waarden (bijv. pixelgegevens)
+R --max-leeslengte [k]bytes: geheel getal (4..4194302, standaard: 4)
stel de drempel voor lange waarden in op k kbytes
parseren van bestandsmeta-informatie:
+ml --gebruik-meta-lengte
gebruik bestandsmeta-informatie groepslengte (standaard)
-ml --ignore-meta-lengte
negeer de lengte van de bestandsmeta-informatiegroep
parseren van attributen met een oneven lengte:
+ao --accepteer-oneven-lengte
accepteer attributen met een oneven lengte (standaard)
+ae --neem-even-lengte aan
neem aan dat de werkelijke lengte een byte groter is
behandeling van expliciete VR:
+ev --gebruik-expliciete-vr
gebruik expliciete VR uit dataset (standaard)
-ev --negeer-expliciete-vr
negeer expliciete VR (liever datadictionary)
afhandeling van niet-standaard VR:
+vr --behandelen-als-onbekend
behandel niet-standaard VR als onbekend (standaard)
-vr --veronderstel-impliciet
probeer te lezen met impliciete VR little endian TS
behandeling van UN-elementen met een ongedefinieerde lengte:
+ui --enable-cp246
undefined len UN lezen als impliciete VR (standaard)
-ui --disable-cp246
lees undefined len UN als expliciete VR
behandeling van UN-elementen met een gedefinieerde lengte:
-uc --retain-un
elementen behouden als UN (standaard)
+uc --convert-un
converteren naar echte VR indien bekend
afhandeling van persoonlijke elementen met maximale lengte (impliciete VR):
-sq --maxlength-dict
lezen zoals gedefinieerd in woordenboek (standaard)
+sq --maxlengte-seq
gelezen als reeks met ongedefinieerde lengte
afhandeling van verkeerde afbakening items:
-rd --gebruik-delim-items
afbakeningsitems uit dataset gebruiken (standaard)
+rd --vervang-verkeerde-delim
vervang items met verkeerde volgorde/itemafbakening
algemene afhandeling van parserfouten:
+Ep --negeer-parse-fouten
probeer te herstellen van parseerfouten
-Ep --handle-parse-fouten
parseerfouten afhandelen en parseren stoppen (standaard)
andere parseeropties:
+st --stop-after-elem [t]ag: "gggg,eeee" of woordenboeknaam
stop met parseren na element gespecificeerd door t
automatische gegevenscorrectie:
+dc --enable-correctie
automatische gegevenscorrectie inschakelen (standaard)
-dc --disable-correctie
schakel automatische gegevenscorrectie uit
bitstream-indeling van leeggelopen invoer:
+bd --bitstream-leeggelopen
verwacht lege bitstream (standaard)
+bz --bitstream-zlib
verwacht leeggelopen zlib bitstream
verwerking opties
specifieke tekenset:
+U8 --converteren-naar-utf8
converteer alle elementwaarden die worden beïnvloed
door specifieke tekenset (0008,0005) naar UTF-8
# vereist ondersteuning van de libiconv toolkit
uitvoer opties
printing:
+L --print-alles
lange tagwaarden volledig afdrukken
-L --print-kort
afdrukken van lange tagwaarden verkort (standaard)
+T --print-boom
hiërarchische structuur afdrukken als een eenvoudige boom
-T --print-ingesprongen
print hiërarchische structuur ingesprongen (standaard)
+F --print-bestandsnaam
koptekst met bestandsnaam voor elk invoerbestand afdrukken
+Fs --print-bestand-zoeken
koptekst alleen met bestandsnaam afdrukken voor die invoerbestanden
die een van de gezochte tags bevatten
in kaart brengen:
+Un --map-uid-namen
wijs bekende UID-nummers toe aan namen (standaard)
-Un --no-uid-namen
wijs bekende UID-nummers niet toe aan namen
citeren:
+Qn --quote-nonascii
citeer niet-ASCII en controleer tekens als XML-opmaak
+Qo --citaat-als-octaal
citeer niet-ASCII en controleer tekens als octale getallen
-Qn --print-nonascii
niet-ASCII- en controletekens afdrukken (standaard)
kleur:
+C --afdrukkleur
gebruik ANSI-escape-codes voor gekleurde uitvoer
# niet beschikbaar op Windows-systemen
-C --geen kleur
gebruik geen ANSI-escapecodes (standaard)
# niet beschikbaar op Windows-systemen
foutafhandeling:
-E --stop-bij-fout
niet afdrukken als bestand beschadigd is (standaard)
+E --negeer-fouten
proberen af te drukken, zelfs als het bestand beschadigd is
zoeken:
+P --zoek [t]ag: "gggg,eeee" of woordenboeknaam
druk de tekstuele dump van tag t af
deze optie kan meerdere keren worden opgegeven
(standaard: het volledige bestand wordt afgedrukt)
+s --zoek-alles
druk alle exemplaren van gezochte tags af (standaard)
-s --zoek-eerst
druk alleen de eerste instantie van gezochte tags af
+p --voorafgaand
sequentiehiërarchie voorafgaan aan afgedrukte tag,
aangeduid met: (gggg,eeee).(gggg,eeee).*
(alleen bij gebruik met --search)
-p --no-prepend
hiërarchie niet voor tag plaatsen (standaard)
schrijven:
+W --write-pixel [d]irectory: tekenreeks
schrijf pixelgegevens naar een .raw-bestand dat is opgeslagen in d
(kleine endian, bestandsnaam automatisch aangemaakt)
OPMERKINGEN
Het toevoegen van mappen als een parameter aan de opdrachtregel heeft alleen zin als optie --scannen-
directories wordt ook gegeven. Als de bestanden in de opgegeven mappen moeten worden geselecteerd
volgens een specifiek naampatroon (bijv. met behulp van jokertekens), optie --scan-patroon
moet worden gebruikt. Houd er rekening mee dat dit bestandspatroon alleen van toepassing is op de bestanden in het
gescande mappen, en als er andere patronen zijn opgegeven op de opdrachtregel buiten
the --scan-patroon optie (bijv. om andere bestanden te selecteren), deze zijn niet van toepassing op
de opgegeven mappen.
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 dcmdump 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 dcmdump online met behulp van onworks.net-services
