xml2dcm - Bulutta Çevrimiçi

Program:

ADI

xml2dcm - XML ​​belgesini DICOM dosyasına veya veri kümesine dönüştürün

SİNOPSİS

xml2dcm [seçenekler] xmlfile-in dcmfile-out

TANIM

The xml2dcm yardımcı program, bir XML (Genişletilebilir İşaretleme Dili) belgesinin içeriğini dönüştürür
DICOM dosyasına veya veri kümesine. XML belgesinin DTD'ye göre doğrulanması bekleniyor
(Belge Türü Tanımı) dosyasında açıklanan dcm2xml.dtd. Uygun bir XML dosyası
kullanılarak oluşturulabilir. dcm2xml araç (seçenek +BB ikili verileri içermesi önerilir).

PARAMETRELERİ

xmlfile-in XML girişi dönüştürülecek dosya adı (stdin: "-")

dcmfile-out DICOM çıktı dosya adı

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
giriş dosya formatı:

+f --oku-meta-bilgi
varsa meta bilgileri oku (varsayılan)

-f --ignore-meta-bilgi
dosya meta bilgilerini yoksay

işleme seçenekleri
doğrulama:

+Vd --doğrulama-belge
XML belgesini DTD'ye karşı doğrulamak

+Vn --check-ad alanı
belge kökündeki XML ad alanını kontrol edin

benzersiz tanımlayıcılar:

+Ug --yeni-uid'ler oluştur
yeni Çalışma/Seri/SOP Örnek UID'si oluştur

-Uo -- kullanıcı kimliklerinin üzerine yazmayın
mevcut UID'lerin üzerine yazmayın (varsayılan)

+Uo --üzerine yazma-kullanıcıları
mevcut UID'lerin üzerine yaz

çıktı seçenekleri
çıktı dosyası formatı:

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

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

+Fu --güncelleme-meta-bilgi
belirli dosya meta bilgilerini güncelle

çıktı aktarımı sözdizimi:

+t= --write-xfer-aynı
girişle aynı TS ile yaz (varsayılan)

+te --write-xfer-küçük
açık VR küçük endian TS ile yaz

+tb --write-xfer-büyük
açık VR big endian TS ile yaz

+ti --write-xfer-örtük
örtük VR küçük endian TS ile yaz

+td --write-xfer-sönük
sönük açık VR küçük endian TS ile yaz

1993 sonrası değer temsilleri:

+u --yeni-vr'yi etkinleştir
yeni VR'ler için desteği etkinleştir (UN/UT) (varsayılan)

-u --yeni-vr-devre dışı bırak
yeni VR'ler için desteği devre dışı bırakın, OB'ye dönüştürün

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= --doldurma-saklama
dolguyu değiştirmeyin (--write-dataset değilse varsayılan)

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

+p --padding-create [f]ile-pad [i]tem-pad: tamsayı
dosyayı birden fazla f bayt ve öğe üzerinde hizala
birden fazla i bayt

sıkıştırma seviyesini söndür (yalnızca --write-xfer-deflated ile):

+cl --compression-level [l]düzey: tamsayı (varsayılan: 6)
0=sıkıştırılmamış, 1=en hızlı, 9=en iyi sıkıştırma

NOTLAR

Beklenen XML girdisinin temel yapısı aşağıdaki gibi görünür:



<dosya formatı xmlns = "http://dicom.offis.de/dcmtk">

<element tag = "0002,0000" vr = "UL" vm = "1" len = "4"
name="MetaElementGroupLength">
166

...
<element tag = "0002,0013" vr = "SH" vm = "1" len = "16"
name="ImplementationVersionName">
OFFIS_DCMTK_353



<element tag = "0008,0005" vr = "CS" vm = "1" len = "10"
name="SpecificCharacterSet">
ISO_IR 100

...


<element tag = "0028,3002" vr = "xs" vm = "3" len = "6"
name="LUTDescriptor">
256 \ 0 \ 8

...

...

...
<element tag = "7fe0,0010" vr = "OW" vm = "1" len = "262144"
name="PixelData" yüklendi="hayır" ikili="gizli">




DICOM veri kümeleri için 'dosya formatı' ve 'meta-başlık' etiketleri bulunmayabilir.

Karakter kodlama
DICOM karakter kodlaması, etiketli öğeden otomatik olarak belirlenir.
'0008,0005' (Belirli Karakter Kümesi) - varsa. Aşağıdaki karakter kümeleri
şu anda destekleniyor (gerektirir libxml eklemek için iconv destek, bkz. --versiyon çıktı):

ASCII (ISO_IR 6) (UTF-8)
UTF-8 "ISO_IR 192" (UTF-8)
ISO Latin 1 "ISO_IR 100" (ISO-8859-1)
ISO Latin 2 "ISO_IR 101" (ISO-8859-2)
ISO Latin 3 "ISO_IR 109" (ISO-8859-3)
ISO Latin 4 "ISO_IR 110" (ISO-8859-4)
ISO Latin 5 "ISO_IR 148" (ISO-8859-9)
Kiril "ISO_IR 144" (ISO-8859-5)
Arapça "ISO_IR 127" (ISO-8859-6)
Yunanca "ISO_IR 126" (ISO-8859-7)
İbranice "ISO_IR 138" (ISO-8859-8)

Birden çok karakter kümesi desteklenmez (yalnızca 'Belirli Karakter'in ilk değeri
Değer çokluğu durumunda karakter kodlaması için Set' kullanılır).

Yerimizi dcm2xml XML yapısı hakkında daha fazla ayrıntı için belgeler.

İkili Veri
İkili veriler, ters eğik çizgi ile ayrılmış bir onaltılık sayılar dizisi olarak kodlanabilir.
'\' veya Base64 biçiminde (ikili='base64'). Ek olarak, ikili veriler de okunabilir
dosya (ikili='dosya'). Bu durumda, dosya adı öğe değeri olarak belirtilmelidir,
Örneğin

alt dizin/pixeldata.raw

Lütfen dosyanın içeriğinin olduğu gibi okunacağını unutmayın. OW verilerinin olması bekleniyor
küçük endian sipariş edildi ve gerekirse değiştirilecek. sağlamak için herhangi bir kontrol yapılmayacaktır.
Veri miktarının, Satırlar veya
Sütunlar.

Sıkıştırma
libxml, zlib desteğiyle derlenirse, girdi dosyası (xml dosyası girişi) Ayrıca olabilir
genellikle çok daha küçük dosyalarla sonuçlanan ZIP ile sıkıştırılır. seçeneğin çıktısına bakın
--versiyon zlib desteğinin mevcut olup olmadığını kontrol etmek için.

Sınırlamalar
Farklı libxml sürümleri, bir XML'in maksimum uzunluğu için farklı sınırlara sahip olabilir.
eleman değeri. Bu nedenle çok uzun eleman değerleri kullanmaktan kaçınılmalıdır (örn.
piksel verileri).

Unutmayın ki xml2dcm şu anda DICOMDIR dosyalarını tam olarak desteklemiyor. özellikle,
çeşitli ofset veri öğelerinin değeri bu araç tarafından otomatik olarak güncellenmez.

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 xml2dcm 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 xml2dcm'yi çevrimiçi kullanın