مرجع ل ultralytics/utils/checks.py
ملاحظه
هذا الملف متاح في https://github.com/ultralytics/ultralytics/ نقطة / الرئيسية /ultralytics/ المرافق / checks.py. إذا اكتشفت مشكلة ، فيرجى المساعدة في إصلاحها من خلال المساهمة في طلب 🛠️ سحب. شكرا لك 🙏!
ultralytics.utils.checks.parse_requirements(file_path=ROOT.parent / 'requirements.txt', package='')
قم بتحليل ملف requirements.txt ، وتجاهل الأسطر التي تبدأ ب "#" وأي نص بعد "#".
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
file_path |
Path
|
المسار إلى ملف requirements.txt. |
parent / 'requirements.txt'
|
package |
str
|
Python الحزمة المراد استخدامها بدلا من requirements.txt ملف ، أي الحزمة = 'ultralytics'. |
''
|
ارجاع:
نوع | وصف |
---|---|
List[Dict[str, str]]
|
قائمة المتطلبات التي تم تحليلها كقواميس مع |
مثل
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.parse_version(version='0.0.0')
قم بتحويل سلسلة إصدار إلى مجموعة من الأعداد الصحيحة ، متجاهلا أي سلسلة غير رقمية إضافية مرفقة بالإصدار. هذا تحل الدالة محل "pkg_resources.parse_version(v)" المهملة.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
version |
str
|
سلسلة الإصدار ، أي "2.0.1 + وحدة المعالجة المركزية" |
'0.0.0'
|
ارجاع:
نوع | وصف |
---|---|
tuple
|
مجموعة من الأعداد الصحيحة التي تمثل الجزء الرقمي من الإصدار والسلسلة الإضافية ، أي (2 ، 0 ، 1) |
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.is_ascii(s)
تحقق مما إذا كانت السلسلة مكونة من أحرف ASCII فقط.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
s |
str
|
السلسلة المراد التحقق منها. |
مطلوب |
ارجاع:
نوع | وصف |
---|---|
bool
|
صحيح إذا كانت السلسلة تتكون فقط من أحرف ASCII ، خطأ خلاف ذلك. |
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_imgsz(imgsz, stride=32, min_dim=1, max_dim=2, floor=0)
التحقق من أن حجم الصورة هو مضاعف للخطوة المحددة في كل بعد. إذا لم يكن حجم الصورة من مضاعفات خطوة ، قم بتحديثه إلى أقرب مضاعف للخطوة أكبر من أو يساوي قيمة الأرضية المحددة.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
imgsz |
int | cList[int]
|
حجم الصورة. |
مطلوب |
stride |
int
|
قيمة الخطوة. |
32
|
min_dim |
int
|
الحد الأدنى لعدد الأبعاد. |
1
|
max_dim |
int
|
الحد الأقصى لعدد الأبعاد. |
2
|
floor |
int
|
الحد الأدنى للقيمة المسموح بها لحجم الصورة. |
0
|
ارجاع:
نوع | وصف |
---|---|
List[int]
|
حجم الصورة المحدث. |
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_version(current='0.0.0', required='0.0.0', name='version', hard=False, verbose=False, msg='')
تحقق من الإصدار الحالي مقابل الإصدار أو النطاق المطلوب.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
current |
str
|
الإصدار الحالي أو اسم الحزمة للحصول على الإصدار منه. |
'0.0.0'
|
required |
str
|
الإصدار أو النطاق المطلوب (بتنسيق نمط النقطة). |
'0.0.0'
|
name |
str
|
الاسم المراد استخدامه في رسالة التحذير. |
'version'
|
hard |
bool
|
إذا كان صحيحا ، فقم برفع AssertionError إذا لم يتم استيفاء المطلب. |
False
|
verbose |
bool
|
إذا كان صحيحا، فقم بطباعة رسالة تحذير إذا لم يتم استيفاء المتطلبات. |
False
|
msg |
str
|
رسالة إضافية لعرضها إذا كانت مطولة. |
''
|
ارجاع:
نوع | وصف |
---|---|
bool
|
صحيح إذا تم استيفاء الشرط ، خطأ خلاف ذلك. |
مثل
# Check if current version is exactly 22.04
check_version(current='22.04', required='==22.04')
# Check if current version is greater than or equal to 22.04
check_version(current='22.10', required='22.04') # assumes '>=' inequality if none passed
# Check if current version is less than or equal to 22.04
check_version(current='22.04', required='<=22.04')
# Check if current version is between 20.04 (inclusive) and 22.04 (exclusive)
check_version(current='21.10', required='>20.04,<22.04')
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_latest_pypi_version(package_name='ultralytics')
إرجاع أحدث إصدار من حزمة PyPI دون تنزيلها أو تثبيتها.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
package_name |
str
|
اسم الحزمة للعثور على أحدث إصدار لها. |
'ultralytics'
|
ارجاع:
نوع | وصف |
---|---|
str
|
أحدث إصدار من الحزمة. |
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_pip_update_available()
يتحقق مما إذا كان إصدار جديد من ultralytics الحزمة متاحة على PyPI.
ارجاع:
نوع | وصف |
---|---|
bool
|
صحيح إذا كان هناك تحديث متاح ، خطأ خلاف ذلك. |
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_font(font='Arial.ttf')
ابحث عن الخط محليا أو قم بتنزيله إلى دليل تكوين المستخدم إذا لم يكن موجودا بالفعل.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
font |
str
|
مسار أو اسم الخط. |
'Arial.ttf'
|
ارجاع:
اسم | نوع | وصف |
---|---|---|
file |
Path
|
مسار ملف الخط الذي تم حله. |
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_python(minimum='3.8.0')
تحقق الحالية python مقابل الحد الأدنى المطلوب للإصدار.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
minimum |
str
|
الحد الأدنى المطلوب من إصدار python. |
'3.8.0'
|
ارجاع:
نوع | وصف |
---|---|
bool
|
ما إذا كان مثبتا Python الإصدار يلبي الحد الأدنى من القيود. |
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_requirements(requirements=ROOT.parent / 'requirements.txt', exclude=(), install=True, cmds='')
تحقق مما إذا كانت التبعيات المثبتة تلبي YOLOv8 المتطلبات ومحاولة التحديث التلقائي إذا لزم الأمر.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
requirements |
Union[Path, str, List[str]]
|
المسار إلى ملف requirements.txt ، متطلب حزمة واحدة كملف سلسلة ، أو قائمة بمتطلبات الحزمة كسلاسل. |
parent / 'requirements.txt'
|
exclude |
Tuple[str]
|
مجموعة من أسماء الحزم لاستبعادها من التحقق. |
()
|
install |
bool
|
إذا كان هذا صحيحا، فحاول التحديث التلقائي للحزم التي لا تفي بالمتطلبات. |
True
|
cmds |
str
|
أوامر إضافية لتمريرها إلى أمر تثبيت النقطة عند التحديث التلقائي. |
''
|
مثل
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_torchvision()
يتحقق من الإصدارات المثبتة من PyTorch و Torchvision للتأكد من توافقها.
تتحقق هذه الوظيفة من الإصدارات المثبتة من PyTorch و Torchvision ، ويحذر إذا كانت غير متوافقة وفقا إلى جدول التوافق المقدم استنادا إلى: https://github.com/pytorch/ الرؤية # التثبيت.
جدول التوافق هو قاموس حيث توجد المفاتيح PyTorch الإصدارات والقيم هي قوائم متوافقة إصدارات Torchvision.
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_suffix(file='yolov8n.pt', suffix='.pt', msg='')
تحقق من الملف (الملفات) بحثا عن لاحقة مقبولة.
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_yolov5u_filename(file, verbose=True)
استبدال الإرث YOLOv5 أسماء الملفات مع أسماء ملفات YOLOv5u المحدثة.
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_model_file_from_stem(model='yolov8n')
إرجاع اسم ملف نموذج من جذع نموذج صالح.
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_file(file, suffix='', download=True, hard=True)
بحث / تنزيل الملف (إذا لزم الأمر) ومسار الإرجاع.
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_yaml(file, suffix=('.yaml', '.yml'), hard=True)
بحث / تنزيل ملف YAML (إذا لزم الأمر) ومسار الإرجاع ، والتحقق من اللاحقة.
ultralytics.utils.checks.check_is_path_safe(basedir, path)
تحقق مما إذا كان المسار الذي تم حله ضمن الدليل المقصود لمنع اجتياز المسار.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
basedir |
Path | str
|
الدليل المقصود. |
مطلوب |
path |
Path | str
|
الطريق للتحقق. |
مطلوب |
ارجاع:
نوع | وصف |
---|---|
bool
|
صحيح إذا كان المسار آمنا ، خطأ خلاف ذلك. |
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_imshow(warn=False)
تحقق مما إذا كانت البيئة تدعم عرض الصور.
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_yolo(verbose=True, device='')
إرجاع صورة يمكن للإنسان قراءتها YOLO ملخص البرامج والأجهزة.
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.collect_system_info()
جمع وطباعة معلومات النظام ذات الصلة بما في ذلك نظام التشغيل ، Pythonوذاكرة الوصول العشوائي ووحدة المعالجة المركزية و CUDA.
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.check_amp(model)
تتحقق هذه الوظيفة من PyTorch وظيفة الدقة المختلطة التلقائية (AMP) ل YOLOv8 نموذج. إذا كانت الشيكات فشل ، فهذا يعني أن هناك حالات شاذة مع AMP على النظام قد تتسبب في خسائر NaN أو نتائج صفرية mAP ، لذلك سوف AMP أن تكون معاقا أثناء التدريب.
البارامترات:
اسم | نوع | وصف | افتراضي |
---|---|---|---|
model |
Module
|
A YOLOv8 مثيل النموذج. |
مطلوب |
مثل
ارجاع:
نوع | وصف |
---|---|
bool
|
إرجاع True إذا كانت وظيفة AMP تعمل بشكل صحيح مع YOLOv8 نموذج ، وإلا خطأ. |
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.git_describe(path=ROOT)
قم بإرجاع وصف git القابل للقراءة البشرية ، أي v5.0-5-g3e25f1e https://git-scm.com/docs/git-describe.
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.print_args(args=None, show_file=True, show_func=False)
وسيطات دالة الطباعة (اختياري args dict).
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.cuda_device_count()
احصل على عدد وحدات معالجة الرسومات NVIDIA المتوفرة في البيئة.
ارجاع:
نوع | وصف |
---|---|
int
|
عدد وحدات معالجة الرسومات NVIDIA المتاحة. |
شفرة المصدر في ultralytics/utils/checks.py
ultralytics.utils.checks.cuda_is_available()
تحقق مما إذا كان CUDA متاحا في البيئة.
ارجاع:
نوع | وصف |
---|---|
bool
|
صحيح إذا كان واحد أو أكثر من وحدات معالجة الرسومات NVIDIA متوفرة ، خطأ خلاف ذلك. |