dcmdjpeg - Online in de cloud

PROGRAMMA:

NAAM

dcmdjpeg - Decodeer JPEG-gecomprimeerd DICOM-bestand

KORTE INHOUD

dcmdjpeg [opties] dcmfile-in dcmfile-out

PRODUCTBESCHRIJVING

De dcmdjpeg hulpprogramma leest een JPEG-gecomprimeerde DICOM-afbeelding (dcmfile-in), decomprimeert de
JPEG-gegevens (dwz conversie naar een native DICOM-overdrachtssyntaxis) en schrijft de geconverteerde
afbeelding naar een uitvoerbestand (dcmfile-uit).

PARAMETERS

dcmfile-in DICOM-invoerbestandsnaam die moet worden geconverteerd

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-bestand
lees bestandsformaat of dataset (standaard)

+fo --alleen-lezen-bestand
alleen bestandsformaat lezen

-f --lees-dataset
lees dataset zonder bestandsmeta-informatie

# Met deze optie kan men JPEG-gecomprimeerde DICOM-objecten decomprimeren die
# zijn opgeslagen als dataset zonder meta-header. Zoiets moet
# bestaat niet omdat de overdrachtssyntaxis niet betrouwbaar kan worden bepaald,
# zonder meta-header maar helaas wel.

verwerking opties
conversie van kleurruimte:

+cp --conv-fotometrisch
converteren als YCbCr fotometrische interpretatie (standaard)

# Als de gecomprimeerde afbeelding YBR_FULL of YBR_FULL_422 fotometrisch gebruikt
# interpretatie, converteer naar RGB tijdens decompressie.

+cl --conv-verlies
converteer YCbCr naar RGB als JPEG met verlies

# Als de gecomprimeerde afbeelding is gecodeerd in JPEG met verlies, ga dan uit van YCbCr
# kleurmodel en converteren naar RGB.

+cg --conv-raad
converteren naar RGB als YCbCr wordt geraden door de bibliotheek

# Als de onderliggende JPEG-bibliotheek de kleurruimte van het
# gecomprimeerde afbeelding om YCbCr te zijn, converteer naar RGB.

+cgl --conv-gok-lossy
converteer naar RGB als JPEG en YCbCr verliesgevend zijn
geraden door de onderliggende JPEG-bibliotheek

# Als de gecomprimeerde afbeelding is gecodeerd in JPEG met verlies en de onderliggende
# JPEG-bibliotheek "schat" dat de kleurruimte YCbCr is, converteer naar RGB.

+ca --conv-altijd
converteer YCbCr altijd naar RGB

# Als de gecomprimeerde afbeelding een kleurenafbeelding is, ga dan uit van het YCbCr-kleurmodel
# en converteer naar RGB.

+cn --conv-nooit
converteer nooit kleurruimte

# Converteer nooit kleurruimte tijdens decompressie.

vlakke configuratie:

+pa --planair-auto
automatisch vlakke configuratie bepalen
van SOP-klasse en kleurruimte (standaard)

# Als de gecomprimeerde afbeelding een kleurenafbeelding is, opslaan in kleur per vlak
# vlakke configuratie indien vereist door de SOP-klasse en fotometrisch
# interpretatie. Hardcopy Kleurenafbeeldingen worden altijd kleur-op-
# vliegtuig, en de herziene Ultrasound-beeldobjecten worden kleur voor
# plane als het kleurmodel YBR_FULL is. Al het andere wordt opgeslagen
# kleur per pixel.

+px --kleur per pixel
altijd kleur voor pixel opslaan

# Als de gecomprimeerde afbeelding een kleurenafbeelding is, sla deze dan kleur voor pixel op
# vlakke configuratie.

+pl --kleur-per-vlak
altijd kleur per vlak opslaan

# Als de gecomprimeerde afbeelding een kleurenafbeelding is, opslaan in kleur per vlak
# vlakke configuratie.

UID van SOP-instantie:

+ud --uid-standaard
dezelfde SOP Instance UID behouden (standaard)

# Wijst nooit een nieuwe SOP-instantie UID toe.

+ua --uid-altijd
altijd nieuwe UID toewijzen

# Wijst altijd een nieuwe SOP-instantie UID toe.

tijdelijke oplossing voor onjuiste JPEG-coderingen:

+w6 --oplossing-pred6
schakel een tijdelijke oplossing in voor JPEG-afbeeldingen zonder verlies
met overflow in predictor 6

# DICOM-afbeeldingen met 16 bits/pixel zijn "in het wild" waargenomen
# die zijn gecomprimeerd met lossless JPEG en een speciale behandeling nodig hebben
# omdat de encoder een 16-bit integer overflow in predictor heeft geproduceerd
# 6, die tijdens decompressie moet worden gecompenseerd (gereproduceerd).
# Deze vlag maakt een correcte decompressie van dergelijke foutieve afbeeldingen mogelijk, maar
# tegelijkertijd zal een onjuiste decompressie van correct veroorzaken
# gecomprimeerde afbeeldingen. Zorgvuldig gebruiken.

uitvoer opties
uitvoer bestandsformaat:

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

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

syntaxis voor uitvoeroverdracht:

+te --write-xfer-klein
schrijf met expliciete VR little endian (standaard)

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

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

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

OVERDRACHT SYNTAXEN

dcmdjpeg ondersteunt de volgende overdrachtsyntaxis voor invoer (dcmfile-in):

LittleEndianImplicitTransferSyntaxis 1.2.840.10008.1.2
LittleEndianExplicitTransferSyntaxis 1.2.840.10008.1.2.1
GedeflateerdExplicitVRLittleEndianTransferSyntaxis 1.2.840.10008.1.2.1.99 (*)
BigEndianExplicitTransferSyntaxis 1.2.840.10008.1.2.2
JPEGProcess1TransferSyntaxis 1.2.840.10008.1.2.4.50
JPEGProcess2_4OverdrachtSyntaxis 1.2.840.10008.1.2.4.51
JPEGProcess6_8OverdrachtSyntaxis 1.2.840.10008.1.2.4.53
JPEGProcess10_12OverdrachtSyntaxis 1.2.840.10008.1.2.4.55
JPEGProcess14TransferSyntaxis 1.2.840.10008.1.2.4.57
JPEGProces14SV1TransferSyntax 1.2.840.10008.1.2.4.70

(*) indien gecompileerd met zlib-ondersteuning ingeschakeld

dcmdjpeg ondersteunt de volgende overdrachtsyntaxis voor uitvoer (dcmfile-uit):

LittleEndianImplicitTransferSyntaxis 1.2.840.10008.1.2
LittleEndianExplicitTransferSyntaxis 1.2.840.10008.1.2.1
BigEndianExplicitTransferSyntaxis 1.2.840.10008.1.2.2

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 dcmdjpeg 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 dcmdjpeg online met behulp van onworks.net-services