Referans için ultralytics/utils/checks.py
Not
Bu dosya https://github.com/ultralytics/ultralytics/blob/main/ ultralytics/utils/checks .py adresinde mevcuttur. Bir sorun tespit ederseniz lütfen bir Çekme İsteği 🛠️ ile katkıda bulunarak düzeltilmesine yardımcı olun. Teşekkürler 🙏!
ultralytics.utils.checks.parse_requirements(file_path=ROOT.parent / 'requirements.txt', package='')
Bir requirements.txt dosyasını, '#' ile başlayan satırları ve '#'den sonraki tüm metinleri yok sayarak ayrıştırın.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
file_path |
Path
|
requirements.txt dosyasının yolu. |
parent / 'requirements.txt'
|
package |
str
|
Python requirements.txt dosyası yerine kullanılacak paket, yani package='ultralytics'. |
''
|
İade:
Tip | Açıklama |
---|---|
List[Dict[str, str]]
|
ile sözlük olarak ayrıştırılmış gereksinimlerin listesi |
Örnek
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.parse_version(version='0.0.0')
Bir sürüm dizesini, sürüme eklenmiş sayısal olmayan herhangi bir ekstra dizeyi yok sayarak bir tamsayı çiftine dönüştürür. Bu işlevi kullanımdan kaldırılan 'pkg_resources.parse_version(v)' işlevinin yerini alır.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
version |
str
|
Sürüm dizesi, örneğin '2.0.1+cpu' |
'0.0.0'
|
İade:
Tip | Açıklama |
---|---|
tuple
|
Sürümün sayısal kısmını ve ekstra dizeyi temsil eden tamsayılar kümesi, yani (2, 0, 1) |
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.is_ascii(s)
Bir dizenin yalnızca ASCII karakterlerinden oluşup oluşmadığını kontrol edin.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
s |
str
|
Kontrol edilecek dize. |
gerekli |
İade:
Tip | Açıklama |
---|---|
bool
|
Dize yalnızca ASCII karakterlerinden oluşuyorsa True, aksi takdirde False. |
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_imgsz(imgsz, stride=32, min_dim=1, max_dim=2, floor=0)
Görüntü boyutunun her boyutta verilen adımın katı olduğunu doğrulayın. Eğer görüntü boyutu stride, verilen taban değerinden büyük veya ona eşit olan stride'ın en yakın katına güncelleyin.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
imgsz |
int | cList[int]
|
Resim boyutu. |
gerekli |
stride |
int
|
Adım değeri. |
32
|
min_dim |
int
|
Minimum boyut sayısı. |
1
|
max_dim |
int
|
Maksimum boyut sayısı. |
2
|
floor |
int
|
Görüntü boyutu için izin verilen minimum değer. |
0
|
İade:
Tip | Açıklama |
---|---|
List[int]
|
Görüntü boyutu güncellendi. |
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_version(current='0.0.0', required='0.0.0', name='version', hard=False, verbose=False, msg='')
Mevcut sürümü gerekli sürüm veya aralıkla karşılaştırın.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
current |
str
|
Sürümü almak için geçerli sürüm veya paket adı. |
'0.0.0'
|
required |
str
|
Gerekli sürüm veya aralık (pip tarzı formatta). |
'0.0.0'
|
name |
str
|
Uyarı mesajında kullanılacak ad. |
'version'
|
hard |
bool
|
True ise, gereksinim karşılanmazsa bir AssertionError yükseltir. |
False
|
verbose |
bool
|
True ise, gereksinim karşılanmazsa uyarı mesajı yazdırır. |
False
|
msg |
str
|
Ayrıntılı ise görüntülenecek ekstra mesaj. |
''
|
İade:
Tip | Açıklama |
---|---|
bool
|
Gereksinim karşılanırsa True, aksi takdirde False. |
Örnek
# 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')
Kaynak kodu ultralytics/utils/checks.py
175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 |
|
ultralytics.utils.checks.check_latest_pypi_version(package_name='ultralytics')
Bir PyPI paketinin en son sürümünü indirmeden veya yüklemeden döndürür.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
package_name |
str
|
En son sürümü bulunacak paketin adı. |
'ultralytics'
|
İade:
Tip | Açıklama |
---|---|
str
|
Paketin en son sürümü. |
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_pip_update_available()
PyPI'da ultralytics paketinin yeni bir sürümünün mevcut olup olmadığını kontrol eder.
İade:
Tip | Açıklama |
---|---|
bool
|
Bir güncelleme mevcutsa True, aksi takdirde False. |
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_font(font='Arial.ttf')
Yazı tipini yerel olarak bulun veya zaten mevcut değilse kullanıcının yapılandırma dizinine indirin.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
font |
str
|
Yazı tipinin yolu veya adı. |
'Arial.ttf'
|
İade:
İsim | Tip | Açıklama |
---|---|---|
file |
Path
|
Yazı tipi dosya yolu çözüldü. |
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_python(minimum='3.8.0')
Geçerli python sürümünü gerekli minimum sürümle karşılaştırın.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
minimum |
str
|
Gerekli minimum sürüm python. |
'3.8.0'
|
İade:
Tip | Açıklama |
---|---|
bool
|
Yüklü Python sürümünün minimum kısıtlamaları karşılayıp karşılamadığı. |
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_requirements(requirements=ROOT.parent / 'requirements.txt', exclude=(), install=True, cmds='')
Yüklü bağımlılıkların YOLOv8 gereksinimlerini karşılayıp karşılamadığını kontrol edin ve gerekirse otomatik güncellemeyi deneyin.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
requirements |
Union[Path, str, List[str]]
|
requirements.txt dosyasına giden yol, tek bir paket gereksinimi olarak dizesi veya dizeler olarak paket gereksinimlerinin bir listesi. |
parent / 'requirements.txt'
|
exclude |
Tuple[str]
|
Kontrolden hariç tutulacak paket adları demeti. |
()
|
install |
bool
|
True ise, gereksinimleri karşılamayan paketleri otomatik olarak güncellemeyi deneyin. |
True
|
cmds |
str
|
Otomatik güncelleme sırasında pip install komutuna iletilecek ek komutlar. |
''
|
Örnek
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_torchvision()
Uyumlu olduklarından emin olmak için PyTorch ve Torchvision'ın yüklü sürümlerini kontrol eder.
Bu işlev PyTorch ve Torchvision'ın yüklü sürümlerini kontrol eder ve uyumsuz olmaları durumunda uyarı verir. temel alınarak sağlanan uyumluluk tablosuna: https://github.com/pytorch/vision#installation.
Uyumluluk tablosu, anahtarların PyTorch sürümleri ve değerlerin uyumlu sürümlerin listeleri olduğu bir sözlüktür. Torchvision versiyonları.
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_suffix(file='yolov8n.pt', suffix='.pt', msg='')
Kabul edilebilir son ek için dosya(lar)ı kontrol edin.
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_yolov5u_filename(file, verbose=True)
Eski YOLOv5 dosya adlarını güncellenmiş YOLOv5u dosya adlarıyla değiştirin.
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_model_file_from_stem(model='yolov8n')
Geçerli bir model gövdesinden bir model dosya adı döndürür.
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_file(file, suffix='', download=True, hard=True)
Dosyayı arayın/indirin (gerekirse) ve yolu döndürün.
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_yaml(file, suffix=('.yaml', '.yml'), hard=True)
YAML dosyasını arayın/indirin (gerekirse) ve son eki kontrol ederek yolu döndürün.
ultralytics.utils.checks.check_is_path_safe(basedir, path)
Yol geçişini önlemek için çözümlenen yolun amaçlanan dizinin altında olup olmadığını kontrol edin.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
basedir |
Path | str
|
Hedeflenen dizin. |
gerekli |
path |
Path | str
|
Kontrol edilecek yol. |
gerekli |
İade:
Tip | Açıklama |
---|---|
bool
|
Yol güvenli ise True, aksi takdirde False. |
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_imshow(warn=False)
Ortamın görüntü ekranlarını destekleyip desteklemediğini kontrol edin.
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_yolo(verbose=True, device='')
İnsan tarafından okunabilir bir YOLO yazılım ve donanım özeti döndürür.
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.collect_system_info()
İşletim sistemi, Python, RAM, CPU ve CUDA dahil olmak üzere ilgili sistem bilgilerini toplayın ve yazdırın.
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.check_amp(model)
Bu fonksiyon bir YOLOv8 modelinin PyTorch Otomatik Karışık Hassasiyet (AMP) işlevselliğini kontrol eder. Eğer kontroller başarısız olursa, sistemde AMP ile NaN kayıplarına veya sıfır-mAP sonuçlarına neden olabilecek anormallikler olduğu anlamına gelir, bu nedenle AMP eğitim sırasında devre dışı bırakılabilir.
Parametreler:
İsim | Tip | Açıklama | Varsayılan |
---|---|---|---|
model |
Module
|
Bir YOLOv8 model örneği. |
gerekli |
Örnek
İade:
Tip | Açıklama |
---|---|
bool
|
AMP işlevi YOLOv8 modeliyle doğru çalışıyorsa True, aksi takdirde False döndürür. |
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.git_describe(path=ROOT)
İnsan tarafından okunabilir git açıklaması döndür, örneğin v5.0-5-g3e25f1e https://git-scm.com/docs/git-describe.
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.print_args(args=None, show_file=True, show_func=False)
Fonksiyon argümanlarını yazdırın (isteğe bağlı args dict).
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.cuda_device_count()
Ortamda bulunan NVIDIA GPU'larının sayısını alın.
İade:
Tip | Açıklama |
---|---|
int
|
Kullanılabilir NVIDIA GPU'larının sayısı. |
Kaynak kodu ultralytics/utils/checks.py
ultralytics.utils.checks.cuda_is_available()
Ortamda CUDA'nın kullanılabilir olup olmadığını kontrol edin.
İade:
Tip | Açıklama |
---|---|
bool
|
Bir veya daha fazla NVIDIA GPU mevcutsa True, aksi takdirde False. |
Oluşturuldu 2023-11-12, Güncellendi 2024-05-08
Yazarlar: Burhan-Q (1), glenn-jocher (3), Laughing-q (1)