TorchVision
torchvision
مكتبة الرؤية الرسمية لـ PyTorch: مجموعات بيانات ونماذج مدربة مسبقاً وتحويلات للصور والأقنعة والصناديق.
المعلومات الأساسية
| الاسم | TorchVision |
|---|---|
| الاسم الكامل | torchvision |
| التصنيف | الرؤية الحاسوبية ومعالجة الصور |
| الجهة المطورة | فريق PyTorch |
| سنة الإطلاق | غير محدد |
| الموقع الرسمي | github.com/pytorch/vision |
| مستودع GitHub | pytorch/vision |
| الوثائق الرسمية | غير محدد |
| الحزمة على PyPI | torchvision |
| الترخيص | BSD (PyPI license) |
| حالة المشروع | نشطة صدر لها إصدار خلال آخر 12 شهراً |
| آخر إصدار | 28 أكتوبر 2026 (الإصدار 0.29.2) |
| لغة البرمجة | Python، C++ |
| أنظمة التشغيل | غير محدد |
| إصدار Python المطلوب | !=3.14.1,>=3.10 |
| مستوى الصعوبة | مبتدئ |
آخر تحقق من هذه البيانات: 21 نوفمبر 2026 — المصدر: PyPI JSON API (2026-11-21)
نظرة عامة
توفر TorchVision مجموعات بيانات مثل CIFAR وImageNet (واجهات تحميل)، ونماذج تصنيف وكشف وتجزئة بأوزان مدربة مسبقاً (ResNet وViT وFaster R-CNN وMask R-CNN وغيرها)، وتحويلات v2 تدعم الصناديق والأقنعة.
يجب أن يتوافق إصدارها مع إصدار PyTorch المثبت؛ راجع جدول التوافق في المستودع الرسمي.
متى تختارها؟ اخترها مع PyTorch لنقل التعلم والنماذج والتحويلات القياسية.
الاستخدامات
الاستخدامات الرئيسية
- تحميل مجموعات بيانات قياسية
- نماذج مدربة مسبقاً لنقل التعلم
- تحويلات وزيادة الصور
المجالات العلمية
- الرؤية الحاسوبية
- الصور الطبية
أنواع المشاريع المناسبة
- نقل التعلم لتصنيف الصور
تطبيقات بحثية
- خطوط أساس قياسية بأوزان ImageNet
الخصائص التقنية
تُعرض الخاصية «مدعومة» فقط إذا كانت موثقة في الوثائق الرسمية للمكتبة؛ وما لم نتحقق منه يظهر «غير محدد».
| دعم المعالج المركزي (CPU) | مدعوم |
|---|---|
| دعم المعالج الرسومي (GPU) | مدعوم |
| التوافق مع CUDA | مدعوم |
| التدريب أو الحوسبة الموزعة | لا ينطبق |
| الاشتقاق التلقائي (Autodiff) | مدعومعبر PyTorch. |
| نشر النماذج (Deployment) | مدعوم |
| نماذج مدربة مسبقاً | مدعوم |
| أنواع البيانات المدعومة | موترات PyTorch وصور PIL |
| التكامل مع مكتبات أخرى | PyTorch، Pillow، timm |
| المرونة (تقدير تحريري) | متوسطة |
| الأداء (تقدير تحريري) | عالية |
| المجتمع (تقدير تحريري) | ضخم |
| جودة التوثيق (تقدير تحريري) | توثيق رسمي |
التثبيت والتشغيل
pip install torchvisionالتوافق: Python !=3.14.1,>=3.10 — حسب بيانات الحزمة على PyPI، تحقق في 21 نوفمبر 2026
يُفضّل التثبيت داخل بيئة افتراضية (venv أو conda). وإذا احتجت توافقاً مع إصدار معين من CUDA أو نظام التشغيل فارجع إلى الوثائق الرسمية، لأن هذه المعلومات تتغير مع كل إصدار.
أمثلة برمجية
الأمثلة الموسومة «نُفّذ واختُبر» شُغّلت فعلياً وسُجّل مخرجها وتاريخ الاختبار وإصدارات المكتبات؛ وغيرها يحتاج GPU أو تنزيل نماذج فلم يُشغّل في بيئة الاختبار.
مبتدئتحويلات الصور ونموذج ResNet من torchvisionنُفّذ واختُبر
الهدف: تجهيز صورة بالتحويلات القياسية وتمريرها إلى ResNet-18.
import numpy as np, torch
from PIL import Image
from torchvision import models
from torchvision.transforms import v2
img = Image.fromarray((np.random.default_rng(0).random((300, 400, 3)) * 255).astype("uint8"))
tf = v2.Compose([v2.ToImage(), v2.Resize(256), v2.CenterCrop(224),
v2.ToDtype(torch.float32, scale=True),
v2.Normalize(mean=[0.485, 0.456, 0.406], std=[0.229, 0.224, 0.225])])
x = tf(img).unsqueeze(0)
model = models.resnet18(weights=None, num_classes=4).eval()
with torch.no_grad():
out = model(x)
print("شكل المدخل:", tuple(x.shape))
print("شكل المخرج:", tuple(out.shape))
print("عدد المعاملات (مليون):", round(sum(p.numel() for p in model.parameters()) / 1e6, 2))
شرح الكود
ننشئ صورة PIL اصطناعية ونطبق تحويلات v2 (تغيير الحجم، القص، التحويل إلى موتر، التطبيع). نستخدم weights=None لأن تنزيل الأوزان المدربة يحتاج اتصالاً؛ في مشروعك استخدم ResNet18_Weights.DEFAULT للنقل التعلمي.
المخرجات المسجلة عند الاختبار
شكل المدخل: (1, 3, 224, 224) شكل المخرج: (1, 4) عدد المعاملات (مليون): 11.18
نُفّذ هذا المثال فعلياً واختُبر بتاريخ 21 نوفمبر 2026 على CPU — torch 2.15.0, torchvision 0.29.2, pillow 13.0.0, python 3.13.18
المزايا
- رسمية ومتكاملة مع PyTorch
- نماذج مدربة جاهزة
القيود
- تشكيلة النماذج أصغر من timm
- يجب مطابقة الإصدار مع PyTorch
المراجع والتحقق
- صفحة الحزمة على PyPI (مصدر الإصدار والترخيص وتاريخ الإصدار) تحقق مباشر
https://pypi.org/project/torchvision/
تاريخ التحقق: 21 نوفمبر 2026 — الإصدار المتحقق منه: 0.29.2 — المراجعة: فريق DLArabic
- الموقع الرسمي رابط تعلنه الحزمة رسمياً على PyPI
https://github.com/pytorch/vision
تاريخ التحقق: 21 نوفمبر 2026 — المراجعة: فريق DLArabic
- المستودع الرسمي رابط تعلنه الحزمة رسمياً على PyPI
https://github.com/pytorch/vision
تاريخ التحقق: 21 نوفمبر 2026 — المراجعة: فريق DLArabic
سجل الإصدارات المتحقق منها
| الإصدار | تاريخ الإصدار | تاريخ التحقق |
|---|---|---|
| 0.29.2 | 28 أكتوبر 2026 | 21 نوفمبر 2026 |
آخر مراجعة لمعلومات الصفحة: 21 نوفمبر 2026. الوصف العربي مكتوب أصلياً للموسوعة وليس منقولاً من المواقع الرسمية.
