img2dcm - Bulutta Çevrimiçi

Program:

ADI

img2dcm - Standart görüntü biçimlerini DICOM biçimine dönüştürün

SİNOPSİS

img2dcm [seçenekler] imgfile-in dcmfile-out

TANIM

The img2dcm araç, JPEG veya BMP gibi standart bir görüntü biçiminden bir dönüştürme aracı görevi görür
DICOM'a. Farklı çıkış SOP Sınıfları seçilebilir. Ek bilgiler
DICOM çıktı dosyasında saklanan (hastalar, seriler vb. ile ilgili)
ortaya çıkan DICOM nesnesi için bir 'şablon' görevi gören diğer DICOM dosyaları. img2dcm yapabilmek
ayrıca çalışmak için eksik DICOM tip 1 ve tip 2 özniteliklerini icat edecek şekilde yapılandırılabilir
herhangi bir şablon veri seti olmadan.

PARAMETRELERİ

imgfile-in görüntü dosyası içe aktarılacak

dcmfile-out DICOM çıktı dosyası

SEÇENEKLER

genel seçenekleri
-h -- yardım
bu yardım metnini yazdırın ve çıkın

--versiyon
sürüm bilgilerini yazdır ve çık

--argümanlar
genişletilmiş komut satırı argümanlarını yazdır

-q --sessiz
sessiz mod, hiçbir uyarı ve hata yazdırmayın

-v --ayrıntılı
ayrıntılı mod, baskı işleme ayrıntıları

-d --hata ayıklama
hata ayıklama modu, hata ayıklama bilgilerini yazdır

-ll --log-level [l]evel: string sabiti
(ölümcül, hata, uyar, bilgi, hata ayıklama, izleme)
kaydedici için seviye l'yi kullanın

-lc --log-config [f]ileadı: string
kaydedici için f yapılandırma dosyasını kullanın

giriş seçenekleri
genel:

-i --input-format [i]nput dosya formatı: string
desteklenen formatlar: JPEG (varsayılan), BMP

-df --dataset-dan [f]dosyaadı: dizi
DICOM dosyasından f veri kümesini kullanın

-stf --study-dan [f]dosyaadı: dizi
hastayı/çalışmayı DICOM dosyasından oku f

-sef --series-from [f]dosyaadı: dizi
DICOM dosyasından hasta/çalışma/seriyi oku f

-ii --örnek-inc
DICOM dosyasından okunan örnek numarasını artır

JPEG formatı:

-dp --devre dışı-program
aşamalı JPEG desteğini devre dışı bırak

-de --dış-devre dışı bırak
genişletilmiş sıralı JPEG desteğini devre dışı bırak

-jf --jfif'te ısrar
JFIF başlığının varlığında ısrar etmek

-ka --keep-appn
APPn bölümlerini tut (JFIF hariç)

işleme seçenekleri
nitelik denetimi:

--yap-kontroller
öznitelik geçerlilik denetimini etkinleştir (varsayılan)

-- kontrol yok
öznitelik geçerlilik kontrolünü devre dışı bırak

+i2 --ekleme tipi2
eksik tip 2 öznitelikleri ekle (varsayılan)
(yalnızca --do-checks ile)

-i2 --tip2-ekleme yok
eksik tip 2 öznitelikleri eklemeyin
(yalnızca --do-checks ile)

+i1 --icat türü1
eksik tip 1 öznitelikleri icat et
(yalnızca --do-checks ile)

-i1 --no-type1-icat
eksik tip 1 nitelikleri icat etmeyin
(yalnızca --do-checks ile)

karakter seti:

+l1 --latin1
latin-1'i standart karakter seti olarak ayarla (varsayılan)

-l1 --latinsiz1
7-bit ASCII'yi standart karakter seti olarak tut

diğer işleme seçenekleri:

-k --key [k]ey: gggg,eeee="str", yol veya sözlük adı="str"
daha fazla özellik ekle

çıktı seçenekleri
hedef SOP sınıfı:

-sc --sn-yakalama
İkincil Yakalama SOP sınıfını yaz

-nsc --yeni-sc
yeni İkincil Yakalama SOP sınıfları yaz

-vlp --vl-fotoğraf
Görünür Işık Fotoğrafik SOP sınıfını yaz (varsayılan)

çıktı dosyası formatı:

+F --yazma dosyası
dosya biçimini yaz (varsayılan)

-F --yazma-veri kümesi
dosya meta bilgisi olmadan veri seti yaz

grup uzunluğu kodlaması:

+g= --grup-uzunluk-yeniden hesapla
varsa grup uzunluklarını yeniden hesapla (varsayılan)

+g --grup-uzunluk-oluştur
her zaman grup uzunluğu öğeleriyle yazın

-g --grup-uzunluk-kaldır
her zaman grup uzunluğu öğeleri olmadan yaz

dizilerde ve öğelerde uzunluk kodlaması:

+e --uzunluk-açık
açık uzunluklarla yaz (varsayılan)

-e --uzunluk-tanımsız
tanımsız uzunluklarla yaz

veri kümesi sonundaki dolgu (--write-dataset ile değil):

-p --dolgu-off
dolgu yok (eğer --write-dataset ise örtük)

+p --padding-create [f]ile-pad [i]tem-pad: tamsayı
dosyayı f baytların çoğuna hizala
ve birden fazla i bayttaki öğeler

NOTLAR

özellik kaynaklar
Genel bir görüntü biçimini DICOM biçimine dönüştürmek için, img2dcm uygulama olabilir
zorunlu (ve isteğe bağlı) öznitelikleri doldurmak için bazı ek girdilerle beslenir.
Hasta, çalışma ve seri bilgileri gibi DICOM dosyası. Bu bilgiler toplanabilir
birleştirilebilen ve sonuç dosyasına uygulanabilen farklı yaklaşımlar kullanarak
aşağıdaki sırayla:

· Kullanmak --dataset-dan seçenek img2dcm öznitelikleri mevcut bir dosyadan içe aktarmaya zorlanır
DICOM dosyası. Verilen DICOM dosyası tamamen içe aktarılır ve tüm
daha fazla ihracat operasyonu. İstisna olarak, SOP Örnek UID'si bu şekilde kopyalanmaz.
seçenek. Ayrıca, dönüştürme sırasında Satırlar, Sütunlar vb. gibi görüntü ile ilgili veriler değiştirilir.
Bunu not et img2dcm geçerlilik için başka herhangi bir öznitelik değerini kontrol etmez, ör.
herhangi bir niteliği yeni nesneye uyarlamak için dizilere bakmayın (referanslı resimler
vesaire.). Bu nedenle, (eski) için veri dizinindeki şablonların kullanılması önerilir.
SC ve VLP nesneleri. Ayrıca 'Giriş Şablonları' bölümüne bakın.
· --çalışma-dan ve --serisi-dan seçenekler (birbirini dışlayan) içe aktarmak için kullanılabilir
mevcut bir DICOM dosyasından hasta, çalışma ve seri bilgileri. Eğer --serisi-dan is
belirtilen, ardından verilen DICOM dosyası tarafından açılır. img2dcm ve tüm zorunlu bilgiler
seri seviyesine kadar ithal edilmektedir. Bunun hasta, çalışma ve serileri içerdiğini unutmayın.
bilgi. durumunda --çalışma-dan, seri bilgileri hariç tutulur. Devamındaki
nitelikler alınır:
Hasta Seviyesi:
Hastanın ismi
Hasta Kimliği
Hastanın Cinsiyeti
Hastanın Doğum Tarihi
Belirli Karakter Seti

Eğitim Seviyesi:
Örnek UID'sini inceleyin
Çalışma Tarihi
Çalışma zamanı
Başvuran Hekimin Adı
Çalışma Kimliği
Erişim numarası

Seri Düzeyi (yalnızca --series-from seçeneği olması durumunda):
Seri Örnek UID'si
Seri numarası
Üretici firma
· İle --insert-tip2 ve --icat-tipi1 seçenekler (her ikisi de varsayılan olarak etkindir), eksik
nitelikler (tip 2 nitelikler) ve/veya eksik nitelik değerleri (tip 1 nitelikler için)
tarafından otomatik olarak eklenir ve icat edilir img2dcm. Lütfen bu seçeneklerin yalnızca
seçenek varsa değerlendirilir --yap-kontroller etkindir (varsayılan). Eğer -- kontrol yok seçenekler
etkinleştirilirse, otomatik öznitelik ekleme gerçekleşmez.
· --anahtar seçeneği, DICOM çıktı dosyasına başka nitelikler eklemek için kullanılabilir. Bu
seçeneği, en sonunda, DICOM dosyasını kaydetmeden hemen önce uygulanır. Aynı zamanda
kullanarak sıraları, öğeleri ve iç içe öznitelikleri belirtmek mümkündür. --anahtar seçenek. İçinde
bu durumlarda özel bir 'yol' gösterimi kullanılmalıdır. Bu yol gösterimiyle ilgili ayrıntılar
belgelerinde bulunabilir dcm değiştirmek.
UID'ler
Yeni Çalışma ve Seri Eşgörünüm UID'leri oluşturulur if gerekli uyguladıktan sonra --ders çalışma-
itibaren ve --dizi seçenekler. Çalışma Kurulumu UID'si veya Seri Kurulumu UID'si mevcut değilse
bu adımlardan sonra birbirlerinden bağımsız olarak yeni üretilirler. bir aksi
SOP Eşgörünüm UID'si için, devralınması beklenebilecek davranış seçilir.
ile --dataset-dan seçenek. Bu değil durumda, SOP Örnek UID'si değil Kopyalanan
yeni nesneye. Bu, çoğu kullanım durumu için istenen davranış olmalıdır. Ancak, eğer bir
belirli SOP Eşgörünüm UID'si yeni nesneye eklenmelidir, --anahtar seçenek
Kullan
Giriş Şablonlar
DICOM'a dönüştürmeyi desteklemek için, img2dcm bazı önceden tanımlanmış şablonlarla birlikte gelir
için kullanılabilir olan --dataset-dan seçeneği (örnek dosyalara bakın SC.dökümü ve VLP.dump).
Bu şablonlar istenilen değerlerle doldurulmalı ve ardından dökümü yapılmalıdır.
(dönüştürülmüş) ile fiilen kullanılmadan önce bir DICOM dosyasına img2dcm. Kullanmak dump2dcm için
dökümü DICOM'a dönüştürün. Örnek:
dump2dcm SC.dump SC.dcm

Herhangi bir DICOM dosyasını şablon olarak kullanmak mümkündür. Lütfen eksiksiz DICOM'un
veri kümesi içe aktarılır; bu nedenle, yalnızca niteliklerin mevcut olduğundan emin olunmalıdır.
oluşturulmuş DICOM nesnesinin bir parçası olmalıdır. SOP Sınıfı UID ve Piksel Verileri
öznitelikler (Satırlar, Sütunlar vb. gibi öznitelikler dahil) kopyalanmaz, yerine
img2dcm dönüşüm sırasında.
Giriş eklentiler
The img2dcm uygulama şu anda giriş olarak JPEG ve BMP görüntü biçimini desteklemektedir.
JPEG Giriş Fişe takmak
JPEG için, kaynak dosyadaki orijinal JPEG'in kodu çözülmez, çıkartılır ve biraz
büyük JPEG dosyalarının bile hızlı dönüştürülmesine izin vermek için dönüştürülür (örneğin JFIF başlığı kesilir)
kod çözme ve yeniden kodlamaya gerek kalmadan. JPEG eklentisi gerekli çıktıyı seçer
JPEG içindeki verilerin gerçek kodlamasına bağlı olarak sözdizimini otomatik olarak aktarın
dosya. Bu nedenle, aşağıdaki Aktarım Sözdizimleri (ve bunlara karşılık gelen JPEG kodlamaları)
JPEG eklentisi tarafından kullanılır:
· JPEG Kodlama İşlemi 1 Temel, Kayıplı, Hiyerarşik Olmayan, Sıralı, DCT, Huffman, 8 Bit
SOP Sınıfı = 1.2.840.10008.1.2.4.50
· JPEG Kodlama İşlemi 2 (8-bit) ve 4 (12-bit) Genişletilmiş, Kayıplı, Hiyerarşik Olmayan,
Sıralı, DCT, Huffman, 8/12 Bit SOP Sınıfı = 1.2.840.10008.1.2.4.51
· JPEG Kodlama İşlemi 10 (8-bit) ve 12 (12-bit) Tam İlerleme, kayıplı, Hiyerarşisiz,
Aşamalı, DCT, Huffman, 8/12 Bit SOP Sınıfı = 1.2.840.10008.1.2.4.55
Renkli ve gri tonlamalı görüntüler desteklenir.
Genişletilmiş JPEG Aktarım Sözdizimi desteği devre dışı bırakılabilir (--devre dışı bırakma-ext opsiyon)
(emekli) Aşamalı JPEG Aktarım Sözdizimi desteğinin yanı sıra (--devre dışı-program
seçenek).
JPEG kayıpsız kodlamanın yanı sıra herhangi bir aritmetik veya hiyerarşik JPEG kodlama modu
eklenti tarafından desteklenmiyor.
JFIF (JPEG Dosya Değişim Formatı) bilgisi, isteğe bağlı APPn işaretçilerini bir
JPEG dosyası. Birçok dijital kamera, bu tür JFIF bilgilerini JPEG formatına entegre etmez.
oluşturdukları çıktı. Örneğin, JFIF, piksel en boy oranı hakkında bilgi içerir.
sıkıştırılmış görüntü eğer istersen img2dcm bir JFIF başlığında ısrar etmek için başvuru
JPEG akışı, seçeneği kullanabilirsiniz --jfif'te ısrar etmek JFIF yoksa hangisi iptal olur
bilgi bulunabilir. Varsayılan olarak, eksik JFIF bilgileri yok sayılır.
DICOM için, JFIF (veya başka bir APPn) entegrasyonu olsun, bir tür 'gri bölge'dir.
DICOM nesnesinin dahili JPEG akışındaki verilere izin verilir veya verilmez. Ancak, en
güvenilir bir yaklaşım, bu işaretleri ve bilgilerini JPEG akışından kesmektir. Bu
tarafından da benimsenen bir yaklaşımdır. img2dcm başvuru. Varsayılan olarak, tüm APPn işaretleri kesilir
orijinal JPEG akışından çıkar. Ancak, diğer APPn işaretçilerini saklamak istiyorsanız,
DICOM akışı içindeki JFIF (örn. EXIF ​​bilgileri), seçenek --keep-appn yapar mı
hile. Ayrıca APPn bilgilerini kesmekten biraz daha hızlı olmalıdır, çünkü
bu tür veriler için tüm JPEG akışını taramak gerekli değildir. JFIF bilgileri her zaman
tarafından kaldırıldı img2dcm.
BMP Giriş Fişe takmak
img2dcm giriş formatı olarak BMP'yi destekler. Ancak, şimdiye kadar yalnızca en yaygın BMP görüntüleri
desteklenir. Özellikle, bit alanları veya çalışma uzunluğu kodlaması kullanan BMP görüntüleri,
reddedilmiş. Bu tür görüntüler nadirdir. Tüm giriş görüntüleri bir DICOM görüntüsüne dönüştürülecek
RGB renk modeli ve 24 bit derinliği ile. İnce ayar için belirli bir seçenek yoktur.
BMP biçimi dönüştürme.
Çıktı eklentiler
İstenilen çıkış SOP Sınıfı komut satırında seçilebilir. Halihazırda bir ihracat
İkincil Görüntü Yakalama SOP sınıfı için eklenti (varsayılan, seçenek -sc), yeni İkincil
Görüntü Yakalama SOP sınıfları (seçenek -nsc) ve Görünür Işık Fotoğrafik Görüntü SOP sınıfı
(seçenek -vl) mevcut. Lütfen ilkinin aşağıdakilere göre kullanımdan kaldırıldığını unutmayın.
DICOM standardıdır ancak geniş çapta desteklendiğinden varsayılan olarak seçilmiştir. Gelecek
sürümleri img2dcm diğer SOP Sınıfları için ek çıktı eklentileri sağlayabilir.
Yeni İkincil Yakalama SOP sınıfları için hangi belirli
Çıktı için SOP sınıfı kullanılmalıdır. Bunun nedeni, bu yeni SOP sınıflarının
birbirinden renk derinliği (1/8/16) ve görüntünün
siyah/beyaz veya renkli. Bu yüzden img2dcm dönüştürme sırasında hangi SOP çıktısına karar verir
sınıfı, belirli bir kaynak görüntü için uygundur.

ÖRNEKLER

nasıl yapıldığını gösteren bazı örnekler img2dcm uygulama kullanılabilir.
1. img2dcm resim.jpg çıkış.dcm
'image.jpg' JPEG dosyasını okuyun, eski İkincil Yakalama SOP sınıfına dönüştürün ve kaydedin
sonucu DICOM dosyası 'out.dcm'. Bu, kullanmanın en kolay yolu img2dcm. Her hangi bir tür
Bu SOP sınıfının geçerli nesnelerini yazmak için gereken 1 ve tip 2 öznitelikleri şunlardır:
otomatik olarak eklenir.
2. img2dcm -i BMP görüntüsü.bmp çıkışı.dcm
Yukarıdakiyle aynıdır ancak img2dcm'ye JPEG yerine bir BMP dosyasını okumasını söyler.
3. img2dcm image.jpg out.dcm -vlp -k 'HastaAdı=Bond^James'
İlk örnekle aynı, ancak Görünür Işık Fotoğrafik Görüntüsü nesnesini 'out.dcm' dosyasına yazıyor
ve HastaAdı'nı, aksi takdirde boş bırakılacak olan 'Bond^James' olarak ayarlar.
4. img2dcm image.jpg out.dcm --series-from template.dcm -k 'HastaAdı=Bond^James'
1) ile aynı, ancak hasta/çalışma/seri bilgilerini DICOM dosyasından içe aktarır
'şablon.dcm'. HastaAdı özniteliğinin şurada 'Bond^James' içereceğini lütfen unutmayın.
sonunda, 'template.dcm'deki herhangi bir değerin üzerine yazılacaktır. Yani, çünkü -k
seçeneği, dönüştürme işlem hattının en sonunda uygulanır (yukarıya bakın).
5. img2dcm image.jpg out.dcm -- kontrol yok
1) ile aynı, ancak herhangi bir nitelik kontrolü yapmıyor ve tip 1 ve tip 2 yok
nitelik ekleme! Bu durumda, geçersiz bir DICOM nesnesi oluşturulur. Bu
çıktı dosyasının tamamlanması amaçlanmadıysa, ancak geçilecekse ilginç olabilir.
başka dönüşümler, örneğin kullanarak nitelik ekleme dcm değiştirmek. Yalnızca seçeneği kullan --numara-
çekler ne yaptığınızı biliyorsanız!
6. img2dcm image.jpg out.dcm --no-type1-icat
1) ile aynıdır, ancak eksik tip 1 niteliklerini ve/veya değerlerini eklemez. Tip 2
nitelikler eklenecektir. Bu durumda, tüm tip 1'in garanti edilmesi gerektiğini unutmayın.
nitelikler başka yollarla sağlanır, yani bunları --anahtar seçeneği.
Aksi takdirde, img2dcm bir hata bildirir ve dönüştürmeyi durdurur.
7. img2dcm image.jpg out.dcm --keep-appn --jfif'te ısrar
1) ile aynıdır, ancak EXIF ​​gibi APPn bilgilerini DICOM nesnesinin içine alır.
elde edilen JPEG akışı. Daha öte, --jfif'te ısrar etmek zorlar img2dcm hayır ise iptal etmek
Kaynak dosyada JFIF bilgisi mevcuttur.

KERESTECİLİK

Çeşitli komut satırı araçlarının ve temel kitaplıkların günlük çıktısı düzeyi,
kullanıcı tarafından belirtilmelidir. Varsayılan olarak, standarda yalnızca hatalar ve uyarılar yazılır
hata akışı. seçeneği kullanma --ayrıntılı ayrıca işleme ayrıntıları gibi bilgilendirici mesajlar
rapor edilir. Seçenek - hata ayıklama dahili aktivite hakkında daha fazla ayrıntı almak için kullanılabilir,
örneğin hata ayıklama amacıyla. Seçenek kullanılarak diğer kayıt seviyeleri seçilebilir --kayıt-
seviye. içinde --sessizlik modda yalnızca önemli hatalar rapor edilir. Böyle çok ciddi hata olaylarında,
uygulama genellikle sonlandırılır. Farklı günlük kaydı düzeyleri hakkında daha fazla ayrıntı için,
'oflog' modülünün belgelerine bakın.
Log çıktısının dosyaya yazılması gerekiyorsa (opsiyonel olarak logfile döndürme ile),
sistem günlüğüne (Unix) veya olay günlüğüne (Windows) seçeneği --log-config kullanılabilir. Bu
yapılandırma dosyası ayrıca yalnızca belirli mesajların belirli bir çıktıya yönlendirilmesine izin verir.
modüle veya uygulamaya dayalı olarak belirli mesajların akışını sağlamak ve filtrelemek için
Üretilir. Örnek bir yapılandırma dosyası şurada verilmiştir: /logger.cfg.

KOMUT LINE

Tüm komut satırı araçları, parametreler için aşağıdaki gösterimi kullanır: köşeli parantezler içine alır
isteğe bağlı değerler (0-1), sondaki üç nokta, birden çok değere izin verildiğini gösterir
(1-n), her ikisinin bir kombinasyonu, 0 ila n değerleri anlamına gelir.
Komut satırı seçenekleri, baştaki '+' veya '-' işaretiyle parametrelerden ayırt edilir,
sırasıyla. Genellikle komut satırı seçeneklerinin sırası ve konumu isteğe bağlıdır (örn.
herhangi bir yerde görünebilir). Ancak, seçenekler birbirini dışlıyorsa, en sağdaki görünüm
kullanıldı. Bu davranış, yaygın Unix kabuklarının standart değerlendirme kurallarına uygundur.
Ek olarak, bir veya daha fazla komut dosyası, önek olarak bir '@' işareti kullanılarak belirtilebilir.
dosya adı (örn. @komut.txt). Böyle bir komut argümanı içeriği ile değiştirilir.
karşılık gelen metin dosyası (birden çok boşluk, tek bir ayırıcı olarak kabul edilir.
daha fazla değerlendirmeden önce iki tırnak işareti arasında görünürler. Lütfen bunu not al
bir komut dosyası başka bir komut dosyası içeremez. Bu basit ama etkili yaklaşım
kişinin ortak seçenekler/parametre kombinasyonlarını özetlemesine izin verir ve uzun ve uzun konuşmalardan kaçınır.
kafa karıştırıcı komut satırları (dosyada bir örnek verilmiştir) /dumppat.txt).

ÇEVRE

The img2dcm yardımcı program, belirtilen DICOM veri sözlüklerini yüklemeye çalışır.
DCCMDICTPATH Çevre değişkeni. Varsayılan olarak, yani DCCMDICTPATH Çevre değişkeni
ayarlanmadı, dosya /dicom.dic sözlük oluşturulmadıkça yüklenecek
uygulamaya girin (Windows için varsayılan).
Varsayılan davranış tercih edilmeli ve DCCMDICTPATH yalnızca ortam değişkeni
alternatif veri sözlükleri gerektiğinde kullanılır. NS DCCMDICTPATH Çevre değişkeni
Unix kabuğuyla aynı biçime sahiptir PATH iki nokta üst üste (':') ayırdığı değişken
girdileri. Windows sistemlerinde, ayırıcı olarak noktalı virgül (';') kullanılır. veri sözlüğü
kodu, belirtilen her dosyayı yüklemeye çalışır. DCCMDICTPATH Çevre değişkeni. Bilişim Teknoloji
hiçbir veri sözlüğü yüklenemiyorsa bir hatadır.

onworks.net hizmetlerini kullanarak img2dcm'yi çevrimiçi kullanın