dcmj2pnm - Online in de cloud

PROGRAMMA:

NAAM

dcmj2pnm - Converteer DICOM-afbeeldingen naar PGM/PPM, PNG, TIFF, JPEG of BMP

KORTE INHOUD

dcmj2pnm [opties] dcmfile-in [bitmap-uit]

PRODUCTBESCHRIJVING

De dcmj2pnm hulpprogramma leest een DICOM-afbeelding, converteert de pixelgegevens volgens de
geselecteerde beeldverwerkingsopties en schrijft een beeld terug in het bekende PGM/PPM
(draagbare grijze kaart / draagbare pix-kaart), PNG, TIFF, JPEG (Joint Photographic Experts Group)
of Windows BMP-indeling. Dit hulpprogramma ondersteunt zowel ongecomprimeerde als JPEG en RLE
gecomprimeerde DICOM-afbeeldingen.

PARAMETERS

dcmfile-in DICOM-invoerbestandsnaam die moet worden geconverteerd

bitmap-out uitvoerbestandsnaam die moet worden geschreven (standaard: stdout)

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

beeld verwerking opties
frame selectie:

+F --frame [n]nummer: geheel getal
selecteer opgegeven frame (standaard: 1)

+Fr --framebereik [n]umber [c]aantal: geheel getal
selecteer c frames beginnend met frame n

+Fa --alle frames
selecteer alle kaders

rotatie:

+Rl --roteer-links
afbeelding naar links draaien (-90 graden)

+Rr --roteren-naar rechts
afbeelding naar rechts draaien (+90 graden)

+Rtd --roteren-van boven naar beneden
afbeelding van boven naar beneden draaien (180 graden)

omdraaien:

+Lh --flip-horizontaal
spiegel de afbeelding horizontaal

+Lv --flip-verticaal
afbeelding verticaal spiegelen

+Lhv --draai-beide-assen
draai het beeld horizontaal en verticaal om

schaal:

+a --herkennen-aspect
pixelverhouding herkennen (standaard)

-a --neger-aspect
negeer de beeldverhouding van pixels bij het schalen

+i --interpoleer [n]nummer van algoritme: geheel getal
gebruik interpolatie bij schalen (1..4, standaard: 1)

-i --geen-interpolatie
geen interpolatie bij schalen

-S --geen schaling
geen schaling, negeer pixelverhouding (standaard)

+Sxf --schaal-x-factor [f]actor: zweven
schaal x-as per factor, bereken y-as automatisch

+Syf --schaal-y-factor [f]actor: zweven
schaal y-as per factor, bereken x-as automatisch

+Sxv --schaal-x-grootte [n]getal: geheel getal
schaal x-as naar n pixels, y-as automatisch berekenen

+Syv --schaal-y-grootte [n]getal: geheel getal
schaal y-as naar n pixels, bereken x-as automatisch

conversie van kleurruimte (alleen gecomprimeerde afbeeldingen):

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

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

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

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

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

+cn --conv-nooit
converteer nooit kleurruimte

modaliteit LUT-transformatie:

-M --geen-modaliteit
negeer opgeslagen modaliteit LUT-transformatie

+M --gebruiksmodaliteit
gebruik modaliteit LUT-transformatie (standaard)

VOI LUT-transformatie:

-W --geen vensters
geen VOI-venster (standaard)

+Wi --use-window [n]getal: geheel getal
gebruik het n-de VOI-venster van het afbeeldingsbestand

+Wl --use-voi-lut [n]umber: geheel getal
gebruik de n-de VOI-opzoektabel uit het afbeeldingsbestand

+Wm --min-max-venster
bereken het VOI-venster met behulp van het min-max-algoritme

+Wn --min-max-venster-n
bereken het VOI-venster met behulp van het min-max-algoritme,
het negeren van extreme waarden

+Wr --roi-min-max-venster [l]eft [t]op [w]idth [h]acht: geheel getal
ROI-venster berekenen met behulp van het min-max-algoritme,
interessegebied wordt gespecificeerd door l,t,w,h

+Wh --histogram-venster [n]getal: geheel getal
VOI-venster berekenen met behulp van het Histogram-algoritme,
negeren van n procent

+Ww --set-window [c]voer [w]idth in: float
bereken het VOI-venster met behulp van centrum c en breedte w

+Wfl --lineaire functie
stel de VOI LUT-functie in op LINEAIR

+Wfs --sigmoid-functie
stel de VOI LUT-functie in op SIGMOID

presentatie LUT-transformatie:

+Pid --identiteitsvorm
stel presentatie LUT-vorm in op IDENTITEIT

+Piv --inverse-vorm
stel presentatie LUT-vorm in op INVERSE

+Pod --lin-od-vorm
stel presentatie LUT-vorm in op LIN OD

overlay:

-O --geen-overlays
geen overlays weergeven

+O --display-overlay [n]getal: geheel getal
display-overlay n (0..16, 0=alles, standaard: +O 0)

+Omr --ovl-vervangen
gebruik de overlaymodus "Vervangen"
(standaard voor grafische overlays)

+Omt --ovl-drempel
gebruik de overlaymodus "Drempel vervangen"

+Omc --ovl-complement
gebruik de overlaymodus "Aanvullen"

+Omv --ovl-omkeren
gebruik de overlaymodus "Bitmap omkeren"

+Omi --ovl-roi
gebruik de overlaymodus "Belangrijk gebied"
(standaard voor ROI-overlays)

+Osf --set-voorgrond [d]ensiteit: zweven
stel overlay voorgronddichtheid in (0..1, standaard: 1)

+Ost --set-threshold [d]ensiteit: float
drempeldichtheid overlay instellen (0..1, standaard: 0.5)

LUT-transformatie weergeven:

+Dm --monitor-file [bestandsnaam: string
uitvoer kalibreren volgens de kenmerken van de monitor
gedefinieerd in f

+Dp --printer-bestand [bestandsnaam: tekenreeks
uitvoer kalibreren volgens de kenmerken van de printer
gedefinieerd in f

+Da --ambient-light [a]omgevingslicht: zweven
omgevingslichtwaarde (cd/m^2, standaard: bestand f)

+Di --verlichting [i]verlichting: zweven
verlichtingswaarde (cd/m^2, standaard: bestand f)

+Dn --min-dichtheid [m]minimale optische dichtheid: zwevend
Dmin-waarde (standaard: uit, alleen bij +Dp)

+Dx --max-density [m]maximale optische dichtheid: zwevend
Dmax-waarde (standaard: uit, alleen bij +Dp)

+Dg --gsd-functie
gebruik GSDF voor kalibratie (standaard voor +Dm/+Dp)

+Dc --cielab-functie
gebruik de CIELAB-functie voor kalibratie

compatibiliteit:

+Ma --accepteer-acr-nema
accepteer ACR-NEMA-afbeeldingen zonder fotometrisch
interpretatie

+Mp --accept-paletten
accepteer onjuiste paletattribuuttags
(0028,111x) en (0028,121x)

+Mc --check-lut-diepte
controleer de 3e waarde van de LUT-descriptor, vergelijk
met verwachte bitdiepte op basis van LUT-gegevens

+Mm --negeer-mlut-diepte
negeer de 3e waarde van de modaliteit LUT-descriptor,
bepaal automatisch bits per tabelinvoer

+Mv --negeer-vlut-diepte
negeer de 3e waarde van de VOI LUT-descriptor,
bepaal automatisch bits per tabelinvoer

TIFF-formaat:

+Tl --compr-lzw
LZW-compressie (standaard)

+Tr --compr-rle
RLE-compressie

+Tn --compr-geen
ongecomprimeerde

+Pd --voorspeller-standaard
geen LZW-voorspeller (standaard)

+Pn --voorspeller-geen
LZW voorspeller 1 (geen voorspelling)

+Ph --voorspeller-horz
LZW-voorspeller 2 (horizontaal verschil)

+Rs --rijen-per-strook [r]ows: geheel getal (standaard: 0)
rijen per strook, standaard 8K per strook

PNG-indeling:

+il --interlace
maak geïnterlinieerd bestand (standaard)

-il --geen interliniëring
maak een niet-geïnterlinieerd bestand

+mf --meta-bestand
meta-informatie voor PNG-bestanden maken (standaard)

-mf --meta-none
geen meta-informatie van PNG-bestanden

JPEG-formaat:

+Jq --compr-quality [q]aliteit: geheel getal (0..100, standaard: 90)
kwaliteitswaarde voor compressie (in procenten)

+Js4 --voorbeeld-444
4:4:4 bemonstering (geen subbemonstering)

+Js2 --voorbeeld-422
4:2:2 subsampling (horizontale subsampling van
chroma-componenten, standaard)

+Js1 --voorbeeld-411
4:1:1 subsampling (horizontaal en verticaal
subsampling van chromacomponenten)

andere transformaties:

+G --grijswaarden
converteren naar grijstinten indien nodig

+P --wissel-polariteit
polariteit wijzigen (pixeluitvoer omkeren)

+C --clip-regio [l]eft [t]op [w]idth [h]eight: geheel getal
fragmentbeeldgebied (l, t, w, h)

uitgang opties
algemeen:

-im --afbeelding-info
druk afbeeldingsdetails af (vereist uitgebreide modus)

-o --geen uitvoer
maak geen output (handig met -im)

bestandsnaam genereren (alleen met --frame-range of --all-frames):

+Fc --gebruik-frame-teller
gebruik 0-gebaseerde teller voor bestandsnamen (standaard)

+Fn --gebruik-framenummer
gebruik een absoluut framenummer voor bestandsnamen

Beeldformaat:

+op --write-raw-pnm
schrijf 8-bits binaire PGM/PPM (standaard voor bestanden)

+opb --write-8-bit-pnm
schrijf 8-bit ASCII PGM/PPM (standaard voor stdout)

+opw --schrijven-16-bit-pnm
schrijf 16-bits ASCII PGM/PPM

+opn --write-n-bit-pnm [n]umber: geheel getal
schrijf n-bit ASCII PGM/PPM (1..32)

+ob --schrijf-bmp
schrijf 8-bits (zwart-wit) of 24-bits (kleur) BMP

+obp --schrijf-8-bits-bmp
schrijf 8-bit palet BMP (alleen zwart-wit)

+obt --write-24-bit-bmp
schrijf 24-bits ware kleuren BMP

+obr --write-32-bit-bmp
schrijf 32-bits ware kleuren BMP

+ot --schrijf-tiff
schrijf 8-bits (monochroom) of 24-bits (kleur) TIFF

+aan --schrijven-png
schrijf 8-bits (monochroom) of 24-bits (kleur) PNG

+on2 --schrijf-16-bit-png
schrijf 16-bits (monochroom) of 48-bits (kleur) PNG

+oj --schrijf-jpeg
schrijf 8-bit lossy JPEG (baseline)

OPMERKINGEN

De volgende geprefereerde interpolatie-algoritmen kunnen worden geselecteerd met behulp van de --interpoleren
optie:

· 1 = gratis schalingsalgoritme met interpolatie van pbmplus toolkit
· 2 = gratis schalingsalgoritme met interpolatie van c't magazine
· 3 = vergrotingsalgoritme met bilineaire interpolatie van Eduard Stanescu
· 4 = vergrotingsalgoritme met bicubische interpolatie van Eduard Stanescu
De --schrijf-tiff optie is alleen beschikbaar wanneer DCMTK is geconfigureerd en gecompileerd
ondersteuning voor de buitenwereld libtiff TIFF-bibliotheek. De beschikbaarheid van de TIFF-compressie
opties zijn afhankelijk van de libtiff configuratie. Met name het gepatenteerde LZW-algoritme
mogelijk niet beschikbaar.
De --schrijf-png optie is alleen beschikbaar wanneer DCMTK is geconfigureerd en gecompileerd
ondersteuning voor de buitenwereld libpng PNG-bibliotheek. Keuze --verweven maakt een progressief beeld mogelijk
bekijken tijdens het laden van het PNG-bestand. Slechts enkele applicaties zorgen voor de meta-info (TEXT)
in een PNG-bestand.

OVERDRACHT SYNTAXEN

dcmj2pnm 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
RLELosslessTransferSyntaxis 1.2.840.10008.1.2.5
(*) indien gecompileerd met zlib-ondersteuning ingeschakeld

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