TorchIO
مكتبة Python لتحميل الصور الطبية ثلاثية الأبعاد وتحويلها وزيادتها ومعاينتها في رقع (Patches) لتدريب نماذج PyTorch.
المعلومات الأساسية
| الاسم | TorchIO |
|---|---|
| الاسم الكامل | TorchIO |
| التصنيف | الرؤية الحاسوبية ومعالجة الصور |
| الجهة المطورة | Fernando Pérez-García ومساهمون |
| سنة الإطلاق | غير محدد |
| الموقع الرسمي | torchio.org |
| مستودع GitHub | TorchIO-project/torchio |
| الوثائق الرسمية | docs.torchio.org |
| الحزمة على PyPI | torchio |
| الترخيص | Apache-2.0 (PyPI license_expression) |
| حالة المشروع | نشطة صدر لها إصدار خلال آخر 12 شهراً |
| آخر إصدار | 2 يونيو 2026 (الإصدار 1.2.1) |
| لغة البرمجة | Python |
| أنظمة التشغيل | OS Independent (كما تعلنها الحزمة على PyPI) |
| إصدار Python المطلوب | >=3.10 |
| مستوى الصعوبة | متوسط |
آخر تحقق من هذه البيانات: 21 نوفمبر 2026 — المصدر: PyPI JSON API (2026-11-21)
نظرة عامة
تمثل TorchIO كل حالة كـ Subject يجمع الصور والأقنعة مع معلوماتها المكانية، وتقدم تحويلات طبية واقعية (حركة، تشوه مجال مغناطيسي، تشويش، إعادة معاينة) ومعاينة الرقع للحجوم الكبيرة وتجميعها بعد الاستدلال.
تكمل MONAI أو تُستخدم بدلاً من بعض وحداته في خطوط PyTorch.
متى تختارها؟ اخترها لزيادة البيانات الطبية الواقعية والتدريب بالرقع على الحجوم ثلاثية الأبعاد.
الاستخدامات
الاستخدامات الرئيسية
- تحميل حجوم MRI وCT
- زيادة بيانات طبية واقعية
- التدريب والاستدلال بالرقع
المجالات العلمية
- الأشعة
- علوم الأعصاب
أنواع المشاريع المناسبة
- تجزئة أورام الدماغ بالرقع
تطبيقات بحثية
- دراسة أثر تحويلات الزيادة الطبية
الخصائص التقنية
تُعرض الخاصية «مدعومة» فقط إذا كانت موثقة في الوثائق الرسمية للمكتبة؛ وما لم نتحقق منه يظهر «غير محدد».
| دعم المعالج المركزي (CPU) | مدعوم |
|---|---|
| دعم المعالج الرسومي (GPU) | لا ينطبق |
| التوافق مع CUDA | لا ينطبق |
| التدريب أو الحوسبة الموزعة | لا ينطبق |
| الاشتقاق التلقائي (Autodiff) | غير مدعوم |
| نشر النماذج (Deployment) | لا ينطبق |
| نماذج مدربة مسبقاً | لا ينطبق |
| أنواع البيانات المدعومة | حجوم ثلاثية الأبعاد (NIfTI، DICOM وغيرها) |
| التكامل مع مكتبات أخرى | PyTorch، MONAI، SimpleITK |
| المرونة (تقدير تحريري) | عالية |
| الأداء (تقدير تحريري) | جيدة |
| المجتمع (تقدير تحريري) | متخصص |
| جودة التوثيق (تقدير تحريري) | توثيق جيد |
التثبيت والتشغيل
pip install torchioالتوافق: Python >=3.10 — حسب بيانات الحزمة على PyPI، تحقق في 21 نوفمبر 2026
يُفضّل التثبيت داخل بيئة افتراضية (venv أو conda). وإذا احتجت توافقاً مع إصدار معين من CUDA أو نظام التشغيل فارجع إلى الوثائق الرسمية، لأن هذه المعلومات تتغير مع كل إصدار.
أمثلة برمجية
الأمثلة الموسومة «نُفّذ واختُبر» شُغّلت فعلياً وسُجّل مخرجها وتاريخ الاختبار وإصدارات المكتبات؛ وغيرها يحتاج GPU أو تنزيل نماذج فلم يُشغّل في بيئة الاختبار.
متوسطزيادة بيانات MRI وأخذ الرقع بـ TorchIOنُفّذ واختُبر
الهدف: تطبيق تشوهات واقعية واستخراج رقع للتدريب.
import torch, torchio as tio
torch.manual_seed(0)
subject = tio.Subject(mri=tio.ScalarImage(tensor=torch.rand(1, 64, 64, 48)),
seg=tio.LabelMap(tensor=(torch.rand(1, 64, 64, 48) > 0.9).int()))
tf = tio.Compose([tio.RescaleIntensity(out_min_max=(0, 1)), tio.RandomAffine(degrees=10),
tio.RandomBiasField(), tio.RandomNoise(std=0.02)])
aug = tf(subject)
print("التحويلات المطبقة:", [t.name for t in aug.history])
sampler = tio.data.UniformSampler(patch_size=32)
patches = list(sampler(aug, num_patches=3))
print("عدد الرقع:", len(patches), "| شكل الرقعة:", tuple(patches[0]["mri"].data.shape))
شرح الكود
Subject يجمع الصورة والقناع، وتطبق التحويلات المكانية عليهما معاً. RandomBiasField يحاكي عدم تجانس الحقل المغناطيسي في MRI. ثم يأخذ UniformSampler رقعاً ثابتة الحجم للتدريب على ذاكرة محدودة.
المخرجات المسجلة عند الاختبار
التحويلات المطبقة: ['RescaleIntensity', 'Affine', 'BiasField', 'Noise'] عدد الرقع: 3 | شكل الرقعة: (1, 32, 32, 32)
نُفّذ هذا المثال فعلياً واختُبر بتاريخ 21 نوفمبر 2026 على CPU — torchio 1.2.1, torch 2.15.0, python 3.13.18
المزايا
- تحويلات طبية واقعية
- معاينة الرقع للحجوم الكبيرة
القيود
- تعمل على CPU في المعالجة
- تكرر جزءاً من وظائف MONAI
المراجع والتحقق
- صفحة الحزمة على PyPI (مصدر الإصدار والترخيص وتاريخ الإصدار) تحقق مباشر
https://pypi.org/project/torchio/
تاريخ التحقق: 21 نوفمبر 2026 — الإصدار المتحقق منه: 1.2.1 — المراجعة: فريق DLArabic
- الموقع الرسمي رابط تعلنه الحزمة رسمياً على PyPI
https://torchio.org
تاريخ التحقق: 21 نوفمبر 2026 — المراجعة: فريق DLArabic
- الوثائق الرسمية رابط تعلنه الحزمة رسمياً على PyPI
https://docs.torchio.org
تاريخ التحقق: 21 نوفمبر 2026 — المراجعة: فريق DLArabic
- المستودع الرسمي رابط تعلنه الحزمة رسمياً على PyPI
https://github.com/TorchIO-project/torchio
تاريخ التحقق: 21 نوفمبر 2026 — المراجعة: فريق DLArabic
سجل الإصدارات المتحقق منها
| الإصدار | تاريخ الإصدار | تاريخ التحقق |
|---|---|---|
| 1.2.1 | 2 يونيو 2026 | 21 نوفمبر 2026 |
آخر مراجعة لمعلومات الصفحة: 21 نوفمبر 2026. الوصف العربي مكتوب أصلياً للموسوعة وليس منقولاً من المواقع الرسمية.
