img2dcm - عبر الإنترنت في السحابة

برنامج:

اسم

؛ img2dcm - تحويل تنسيقات الصور القياسية إلى تنسيق DICOM

موجز

img2dcm [خيارات] imgfile-in dcmfile-out

الوصف

• img2dcm تعمل الأداة كأداة تحويل من تنسيق صورة قياسي مثل JPEG أو BMP
إلى DICOM. يمكن تحديد فئات SOP الإخراج المختلفة. المعلومات الإضافية
(فيما يتعلق بالمرضى ، السلسلة ، إلخ) المخزنة في ملف إخراج DICOM يمكن استخراجها من
ملفات DICOM الأخرى التي تعمل بمثابة "قالب" لكائن DICOM الناتج. img2dcm يمكن
يتم تكوينه أيضًا لاختراع سمات DICOM من النوع 1 والنوع 2 المفقودة للعمل بشكل متساوٍ
بدون أي مجموعة بيانات نموذجية.

المعلمات

سيتم استيراد ملف الصورة imgfile-in

ملف الإخراج DICOM dcmfile-out

OPTIONS

جنرال لواء الخيارات
ح- مساعدة
اطبع نص المساعدة واخرج

--الإصدار
طباعة معلومات الإصدار والخروج

--الحجج
طباعة وسيطات سطر الأوامر الموسعة

-Q - هادئ
الوضع الصامت ، لا تطبع أي تحذيرات وأخطاء

-v - الإسراف
الوضع المطول ، تفاصيل معالجة الطباعة

-د - ديبوغ
وضع التصحيح ، طباعة معلومات التصحيح

-ll --log-level [l] evel: سلسلة ثابتة
(فادح ، خطأ ، تحذير ، معلومات ، تصحيح ، تتبع)
استخدام المستوى l للمسجل

-lc --log-config [f] ilename: string
استخدام ملف التكوين f للمسجل

إدخال الخيارات
جنرال لواء:

-i - تنسيق الإدخال [i] تنسيق ملف الإدخال: سلسلة
التنسيقات المدعومة: JPEG (افتراضي) ، BMP

-df - مجموعة البيانات - من [f] اسم ilename: سلسلة
استخدم مجموعة البيانات من ملف DICOM و

-stf - الدراسة - من [f] اسم ilename: سلسلة
قراءة المريض / الدراسة من ملف DICOM f

-sef --series-from [f] ilename: string
قراءة المريض / الدراسة / السلسلة من ملف DICOM f

-ii -Instance-inc
زيادة قراءة رقم المثيل من ملف DICOM

تنسيق JPEG:

-dp - تعطيل-progr
تعطيل دعم ملفات JPEG التقدمية

-دي - تعطيل-تحويلة
تعطيل دعم ملفات JPEG المتسلسلة الموسعة

-jf - الإصرار على الجفيف
الإصرار على وجود رأس JFIF

-ka - keep-appn
احتفظ بأقسام APPn (باستثناء JFIF)

معالجة الخيارات
فحص السمة:

- القيام بالشيكات
تمكين التحقق من صحة السمة (افتراضي)

- لا تحقق
تعطيل التحقق من صحة السمة

+ i2 - أدخل من النوع 2
أدخل سمات النوع 2 المفقودة (افتراضي)
(فقط مع - do-check)

-i2 - لا نوع 2 - إدراج
لا تقم بإدراج سمات النوع 2 المفقودة
(فقط مع - do-check)

+ i1 - نوع اختراع 1
اختراع سمات النوع 1 المفقودة
(فقط مع - do-check)

-i1 - لا يوجد نوع 1 مخترع
لا تخترع سمات النوع 1 المفقودة
(فقط مع - do-check)

مجموعة الأحرف:

+ l1 --لاتين 1
تعيين latin-1 كمجموعة أحرف قياسية (افتراضي)

-l1 - لا لاتينية 1
احتفظ بـ 7 بت ASCII كمجموعة أحرف قياسية

خيارات المعالجة الأخرى:

-k --key [k] ey: gggg، eeee = "str"، path أو اسم القاموس = "str"
إضافة المزيد من السمة

الناتج الخيارات
فئة SOP المستهدفة:

-sc - التقاط الثانية
اكتب فئة SOP الالتقاط الثانوي

-NSC - new-sc
كتابة فئات SOP الثانوية الالتقاط

-vlp --vl- الصورة
كتابة فئة SOP للتصوير الضوئي المرئي (افتراضي)

تنسيق ملف الإخراج:

+ F - كتابة ملف
تنسيق ملف الكتابة (افتراضي)

-F - كتابة- مجموعة البيانات
كتابة مجموعة البيانات بدون معلومات ملف التعريف

ترميز طول المجموعة:

+ g = - إعادة حساب طول المجموعة
إعادة حساب أطوال المجموعة إذا كانت موجودة (افتراضي)

+ ز - مجموعة الطول - إنشاء
اكتب دائمًا باستخدام عناصر طول المجموعة

-g - مجموعة-طول-إزالة
اكتب دائمًا بدون عناصر طول المجموعة

ترميز الطول بالتسلسل والعناصر:

+ ه - الطول الصريح
الكتابة بأطوال صريحة (افتراضي)

-E - الطول - غير محدد
اكتب بأطوال غير محددة

المساحة المتروكة لمجموعة البيانات (ليس باستخدام مجموعة بيانات الكتابة):

-p - الوسادة
بلا حشوة (ضمنيًا إذا - اكتب مجموعة البيانات)

+ p - padding-create [f] ile-pad [i] tem-pad: عدد صحيح
محاذاة الملف على مضاعفات f بايت
وعناصر في مضاعفات i بايت

الملاحظات

السمة مصادر
لتحويل تنسيق صورة عام إلى تنسيق DICOM ، فإن ملف img2dcm قد يكون التطبيق
مع بعض المدخلات الإضافية لملء السمات الإلزامية (والاختيارية) في الملف الجديد
ملف DICOM مثل معلومات المريض والدراسة والمتسلسلة. يمكن جمع هذه المعلومات
باستخدام طرق مختلفة ، والتي يمكن دمجها وتطبيقها على ملف النتيجة في
الترتيب التالي:

· باستخدام - مجموعة بيانات من خيار img2dcm يضطر إلى استيراد سمات من ملف
ملف DICOM. يتم استيراد ملف DICOM المحدد بالكامل ويعمل كأساس للجميع
مزيد من عمليات التصدير. كاستثناء ، لا يتم نسخ UID مثيل SOP بواسطة هذا
خيار. يتم أيضًا تبادل البيانات ذات الصلة بالصور مثل الصفوف والأعمدة وما إلى ذلك أثناء التحويل.
نلاحظ أن img2dcm لا يتحقق من أي قيم سمات أخرى للتأكد من صحتها ، على سبيل المثال ، يفعل
لا تنظر في التسلسلات لتكييف أي سمات مع الكائن الجديد (الصور المرجعية
إلخ.). لذلك يوصى باستخدام القوالب الموجودة في دليل البيانات لـ (قديم)
كائنات SC و VLP. راجع أيضًا قسم "قوالب الإدخال".
· ال --دراسة من و - مسلسل من خيارات (يستبعد بعضها البعض) يمكن استخدامها للاستيراد
معلومات المريض والدراسة والمتسلسلة من ملف DICOM موجود. لو - مسلسل من is
المحدد ، ثم يتم فتح ملف DICOM المحدد بواسطة img2dcm وجميع المعلومات الإلزامية
وصولا إلى مستوى السلسلة يتم استيرادها. لاحظ أن هذا يشمل المريض والدراسة والتسلسل
معلومة. في حالة --دراسة من، يتم استبعاد معلومات السلسلة. الأتى
يتم الاستيلاء على السمات:
مستوى المريض:
اسم المريض
رقم المريض
جنس المريض
تاريخ ميلاد المريض
مجموعة الأحرف المحددة

مستوى الدراسة:
UID مثيل الدراسة
تاريخ الدراسة
وقت الدراسة
إحالة اسم الطبيب
معرف الدراسة
عدد الانضمام

مستوى السلسلة (فقط في حالة الخيار - سلسلة من):
UID مثيل السلسلة
رقم المسلسل
الشركة المصنعة
· مع ال - أدخل من النوع 2 و - نوع الاختراع 1 الخياران (كلاهما ممكّن لكل افتراضي) ، مفقود
السمات (سمات النوع 2) و / أو قيم السمات المفقودة (لسمات النوع 1)
يتم إضافتها واختراعها تلقائيًا بواسطة img2dcm. يرجى ملاحظة أن هذه الخيارات هي فقط
تقييمها إذا كان الخيار - القيام بالشيكات ممكّن (افتراضي). إذا كان - لا تحقق الخيارات
مُمكّن ، لن يتم إدخال سمة تلقائيًا.
· ال --مفتاح يمكن استخدام الخيار لإضافة المزيد من السمات إلى ملف إخراج DICOM. هذا
يتم تطبيق الخيار في النهاية ، قبل حفظ ملف DICOM مباشرةً. بل هو أيضا
من الممكن تحديد التسلسلات والعناصر والسمات المتداخلة باستخدام --مفتاح خيار. في
في هذه الحالات ، يجب استخدام تدوين خاص "للمسار". يمكن التفاصيل حول تدوين المسار هذا
يمكن العثور عليها في وثائق تعديل.
معرفات فريدة
يتم إنشاء معرّفات UID جديدة للدراسة والمتسلسلة if ضروري بعد تطبيق --يذاكر-
تبدأ من و --سلسلة خيارات. إذا لم يكن UID مثيل الدراسة أو UID لمثيل السلسلة موجودًا
بعد هذه الخطوات ، يتم إنشاؤها حديثًا بشكل مستقل عن بعضها البعض. على العكس
يتم اختيار السلوك لـ SOP Instance UID الذي يمكن للمرء أن يتوقع توليه عند
يستخدم ال - مجموعة بيانات من اختيار. هذا هو ليس في الحالة ، يكون معرف مثيل SOP هو ليس نسخ
للكائن الجديد. يجب أن يكون هذا هو السلوك المرغوب في معظم حالات الاستخدام. ومع ذلك ، إذا كان أ
يجب إدخال معرّف فريد لمثيل SOP في الكائن الجديد ، ملف --مفتاح يجب أن الخيار
يستخدم.
إدخال النماذج
لدعم التحويل إلى DICOM ، img2dcm يأتي مع بعض القوالب المحددة مسبقًا
والتي يمكن استخدامها في - مجموعة بيانات من الخيار (انظر ملفات العينة SC.تفريغ و VLP.dump).
يجب تعبئة هذه القوالب بالقيم المرغوبة ومن ثم يجب التخلص منها
(تم تحويله) إلى ملف DICOM قبل استخدامه بالفعل مع img2dcm. استعمال تفريغ 2dcm إلى
تحويل التفريغ إلى DICOM. مثال:
تفريغ 2dcm SC.dump SC.dcm

من الممكن استخدام أي ملف DICOM كقالب. يرجى ملاحظة أن ملف DICOM الكامل
يتم استيراد مجموعة البيانات ؛ ومن ثم ، ينبغي التأكد من أن السمات الموجودة فقط هي
يجب أن يكون جزءًا من كائن DICOM المُنشأ. معرّف UID الخاص بفئة SOP وبيانات البكسل
السمات (بما في ذلك السمات مثل الصفوف والأعمدة وما إلى ذلك) لا يتم نسخها بل يتم استبدالها بـ
img2dcm أثناء التحويل.
إدخال الإضافات
• img2dcm يدعم التطبيق حاليًا تنسيق JPEG وصورة BMP كمدخلات.
JPEG إدخال المساعد
بالنسبة إلى JPEG ، لا يتم فك تشفير JPEG الأصلي من الملف المصدر ولكن يتم استخراجه بشكل طفيف
تم تحويله (مثل قطع رأس JFIF) للسماح بتحويل سريع حتى لملفات JPEG الكبيرة
دون الحاجة إلى فك التشفير وإعادة الترميز. يختار المكون الإضافي JPEG الإخراج الضروري
بناء الجملة تلقائيًا اعتمادًا على التشفير الفعلي للبيانات داخل JPEG
ملف. لذلك ، فإن جمل النقل التالية (وتشفيرات JPEG المقابلة لها)
يتم استخدامها بواسطة البرنامج المساعد JPEG:
· عملية تشفير JPEG 1 خط أساسي ، خاسر ، غير هرمي ، متسلسل ، DCT ، Huffman ، 8 بت
فئة SOP = 1.2.840.10008.1.2.4.50
· عملية ترميز JPEG 2 (8 بت) و 4 (12 بت) موسعة وفقدان وغير هرمي ،
متسلسل ، DCT ، Huffman ، فئة SOP 8/12 بت = 1.2.840.10008.1.2.4.51
· عملية تشفير JPEG 10 (8 بت) و 12 (12 بت) تقدم كامل ، ضياع ، بدون تسلسل هرمي.
التقدمي ، DCT ، Huffman ، فئة SOP 8/12 بت = 1.2.840.10008.1.2.4.55
الصور الملونة وذات التدرج الرمادي مدعومة.
يمكن تعطيل دعم Extended JPEG Transfer Syntax (--تعطيل تحويلة خيار)
بالإضافة إلى دعم صيغة نقل JPEG التدريجي (المتقاعد) (--تعطيل البرنامج
اختيار).
تشفير JPEG بدون فقدان بالإضافة إلى أي أوضاع تشفير JPEG حسابية أو هرمية هي كذلك
لا يدعمها البرنامج المساعد.
تسهل معلومات JFIF (تنسيق تبادل ملف JPEG) علامات APPn الاختيارية في ملف
ملف JPEG. لا تدمج العديد من الكاميرات الرقمية معلومات JFIF في تنسيق JPEG
الناتج الذي قاموا بإنشائه. على سبيل المثال ، يحتوي JFIF على معلومات حول نسبة العرض إلى الارتفاع بالبكسل لـ
الصورة المضغوطة. إذا كنت تريد img2dcm تطبيق للإصرار على رأس JFIF في
تدفق JPEG ، يمكنك استخدام الخيار - الإصرار على الجفيف التي ستجهض إذا لم يكن هناك JFIF
يمكن العثور على المعلومات. بشكل افتراضي ، يتم تجاهل معلومات JFIF المفقودة.
بالنسبة لـ DICOM ، فهي نوع من "المنطقة الرمادية" ، سواء كان دمج JFIF (أو أي APPn آخر)
البيانات في دفق JPEG الداخلي لكائن DICOM مسموح بها أم لا. ومع ذلك ، فإن أكثر
النهج الموثوق به هو قطع تلك العلامات ومعلوماتها عن دفق JPEG. هذا
النهج أيضا من قبل img2dcm طلب. بشكل افتراضي ، يتم قص جميع علامات APPn
من دفق JPEG الأصلي. ومع ذلك ، إذا كنت تريد الاحتفاظ بعلامات APPn الأخرى بخلاف
JFIF (على سبيل المثال معلومات EXIF) داخل دفق DICOM ، الخيار - keep-appn هل
حيلة. يجب أن يكون أسرع قليلاً من قطع معلومات APPn ، لأنه كذلك
ليس من الضروري فحص دفق JPEG بأكمله لمثل هذه البيانات. معلومات JFIF هي دائما
إزالتها من قبل img2dcm.
BMP إدخال المساعد
img2dcm يدعم BMP كتنسيق إدخال. ومع ذلك ، فإن أكثر صور BMP شيوعًا هي حتى الآن
أيد. على وجه الخصوص ، ستكون صور BMP التي تستخدم حقول البت أو ترميز طول التشغيل
مرفوض. مثل هذه الصور غير شائعة. سيتم تحويل جميع الصور المدخلة إلى صورة DICOM
مع نموذج ألوان RGB وعمق قليل يبلغ 24. لا توجد خيارات محددة للضبط الدقيق
تحويل تنسيق BMP.
الناتج الإضافات
يمكن تحديد فئة SOP الإخراج المطلوبة في سطر الأوامر. حاليا ، تصدير
المكون الإضافي لفئة SOP الثانوية لالتقاط الصور (افتراضي ، الخيار -SC) ، الثانوية الجديدة
فئات Capture Image SOP (خيار -نسك) وفئة SOP للصور الفوتوغرافية بالضوء المرئي
(اختيار -vl) تتوفر. يرجى ملاحظة أنه تم إهمال العنصر الأول وفقًا لـ
معيار DICOM ولكن تم تحديده كافتراضي لأنه مدعوم على نطاق واسع. مستقبل
إصدارات img2dcm قد توفر إضافات إخراج إضافية لفئات SOP الأخرى.
بالنسبة للفئات الجديدة الخاصة بإجراءات التشغيل القياسية (Secondary Capture SOP) ، لا يمكن تحديد أي منها محدد
يجب استخدام فئة SOP للإخراج. وذلك لأن هذه الفئات SOP الجديدة هي
متمايزة عن بعضها البعض بعمق اللون (1/8/16) وحقيقة ما إذا كانت الصورة
أسود / أبيض أو ملون. ذلك هو السبب img2dcm يقرر أثناء التحويل ، والذي ينتج SOP
فئة مناسبة لصورة مصدر معينة.

أمثلة

فيما يلي بعض الأمثلة التي توضح كيفية عمل ملف img2dcm يمكن استخدام التطبيق.
1.img2dcm image.jpg out.dcm
اقرأ ملف JPEG 'image.jpg' ، وقم بتحويله إلى فئة Secondary Capture SOP القديمة وحفظه
النتيجة إلى ملف DICOM 'out.dcm'. هذه هي أسهل طريقة لاستخدام img2dcm. أي نوع
السمات 1 والنوع 2 المطلوبة لكتابة كائنات صالحة لفئة SOP هذه هي
يتم إدراجه تلقائيًا.
2. img2dcm -i BMP image.bmp out.dcm
كما هو مذكور أعلاه ولكنه يخبر img2dcm بقراءة ملف BMP بدلاً من JPEG.
3. img2dcm image.jpg out.dcm -vlp -k "اسم المريض = بوند ^ جيمس"
مثل المثال الأول ، ولكن يكتب كائن Visible Light Photographic Image إلى "out.dcm"
ويعيّن PatientName على "Bond ^ James" والذي كان سيترك فارغًا بخلاف ذلك.
4. img2dcm image.jpg out.dcm - سلسلة من template.dcm -k 'PatientName = Bond ^ James'
مثل 1) ، لكن يستورد معلومات المريض / الدراسة / المتسلسلة من ملف DICOM
"template.dcm". يرجى ملاحظة أن السمة PatientName ستحتوي على "Bond ^ James" في
في النهاية ، ستتم الكتابة فوق أي قيمة من "template.dcm". هذا هو ، لأن ال -k
يتم تطبيق الخيار في نهاية خط أنابيب التحويل (انظر أعلاه).
5. img2dcm image.jpg out.dcm - بدون فحوصات
مثل 1) ، ولكن لا يتم إجراء أي فحص للسمات ولا النوع 1 والنوع 2
إدراج السمة! لذلك في هذه الحالة ، سيتم إنشاء كائن DICOM غير صالح. هذا
يمكن أن يكون مثيرًا للاهتمام إذا لم يكن من المفترض أن يكتمل ملف الإخراج ولكنه سيخضع
مزيد من التحولات ، على سبيل المثال إضافة السمات باستخدام تعديل. استخدم الخيار فقط --لا-
الشيكات إذا كنت تعرف ما تفعله!
6. img2dcm image.jpg out.dcm - no-type1-Invent
مثل 1) ، لكنه لا يُدرج سمات النوع 1 المفقودة و / أو قيمها. النوع 2
سيتم إدراج السمات. لاحظ أنه في هذه الحالة يجب التأكد من أن كل نوع 1
يتم توفير السمات بوسائل أخرى ، أي بإضافتها بامتداد --مفتاح الخيار.
على خلاف ذلك، img2dcm سيبلغ عن خطأ وسيتوقف عن التحويل.
7. img2dcm image.jpg out.dcm --keep-appn --insist-on-jfif
مثل 1) ، لكنه يأخذ معلومات APPn مثل EXIF ​​في كائن DICOM
الناتج دفق JPEG. إضافي، - الإصرار على الجفيف سيجبر img2dcm للإجهاض إذا لم يكن كذلك
معلومات JFIF موجودة في الملف المصدر.

LOGGING

يمكن لمستوى تسجيل الإخراج لأدوات سطر الأوامر المختلفة والمكتبات الأساسية
يحدده المستخدم. بشكل افتراضي ، تتم كتابة الأخطاء والتحذيرات فقط وفقًا للمعيار
تيار الخطأ. باستخدام الخيار - الإسراف أيضًا الرسائل الإعلامية مثل تفاصيل المعالجة
تم عمل تقرير لها. خيار --Debug يمكن استخدامها للحصول على مزيد من التفاصيل حول النشاط الداخلي ،
على سبيل المثال لأغراض التصحيح. يمكن تحديد مستويات التسجيل الأخرى باستخدام الخيار --سجل-
مستوى. في --هادئ الوضع يتم الإبلاغ عن الأخطاء الفادحة فقط. في مثل هذه الأحداث الخطيرة جدًا ،
عادةً ما يتم إنهاء التطبيق. لمزيد من التفاصيل حول مستويات التسجيل المختلفة ،
انظر توثيق وحدة 'oflog'.
في حالة وجوب كتابة مخرجات التسجيل في ملف (اختياريًا مع تدوير ملف السجل) ،
إلى سجل النظام (Unix) أو خيار سجل الأحداث (Windows) --لوج التكوين يمكن استخدامها. هذه
يسمح ملف التكوين أيضًا بتوجيه رسائل معينة فقط إلى ناتج معين
تيار ولتصفية رسائل معينة بناءً على الوحدة النمطية أو التطبيق الذي توجد فيه
يتم إنشاؤها. يتم توفير مثال لملف التكوين بتنسيق /logger.cfg.

COMMAND خط

تستخدم جميع أدوات سطر الأوامر الترميز التالي للمعلمات: أرفق الأقواس المربعة
القيم الاختيارية (0-1) ، ثلاث نقاط لاحقة تشير إلى السماح بقيم متعددة
(1-n) ، مزيج من كلاهما يعني 0 إلى n قيم.
يتم تمييز خيارات سطر الأوامر عن المعلمات بعلامة "+" أو "-" بادئة ،
على التوالى. عادةً ما يكون ترتيب خيارات سطر الأوامر وموضعها تعسفيًا (أي أنها
يمكن أن تظهر في أي مكان). ومع ذلك ، إذا كانت الخيارات متنافية ، يظهر أقصى اليمين
يستخدم. يتوافق هذا السلوك مع قواعد التقييم القياسية لقذائف Unix الشائعة.
بالإضافة إلى ذلك ، يمكن تحديد ملف أو أكثر من ملفات الأوامر باستخدام علامة "@" كبادئة لـ
اسم الملف (على سبيل المثال @ command.txt). يتم استبدال حجة الأمر بمحتوى
الملف النصي المقابل (يتم التعامل مع المسافات البيضاء المتعددة كفاصل واحد ما لم يكن
تظهر بين علامتي اقتباس) قبل أي تقييم آخر. يرجى ملاحظة ذلك
لا يمكن أن يحتوي ملف الأوامر على ملف أوامر آخر. هذا نهج بسيط ولكن فعال
يسمح للمرء بتلخيص المجموعات المشتركة من الخيارات / المعلمات وتجنب longish و
أسطر الأوامر المربكة (يتم توفير مثال في ملف /dumppat.txt).

البيئة

• img2dcm ستحاول الأداة المساعدة تحميل قواميس بيانات DICOM المحددة في ملف
DCMDICTPATH متغيرات البيئة. بشكل افتراضي ، على سبيل المثال ، إذا كان الملف DCMDICTPATH متغيرات البيئة
لم يتم تعيين الملف /dicom.dic سيتم تحميلها ما لم يتم بناء القاموس
في التطبيق (الافتراضي لنظام التشغيل Windows).
يجب تفضيل السلوك الافتراضي و DCMDICTPATH متغير البيئة فقط
تستخدم عندما تكون قواميس البيانات البديلة مطلوبة. ال DCMDICTPATH متغيرات البيئة
له نفس تنسيق غلاف يونكس PATH متغير في أن علامة النقطتين (':') تفصل
إدخالات. في أنظمة Windows ، يتم استخدام الفاصلة المنقوطة ('؛') كفاصل. قاموس البيانات
سيحاول الكود تحميل كل ملف محدد في DCMDICTPATH متغيرات البيئة. هو - هي
يعد خطأ إذا تعذر تحميل قاموس البيانات.

استخدم img2dcm عبر الإنترنت باستخدام خدمات onworks.net