Referenz fĂŒr ultralytics/utils/downloads.py
Hinweis
Diese Datei ist verfĂŒgbar unter https://github.com/ultralytics/ ultralytics/blob/main/ ultralytics/utils/downloads .py. Wenn du ein Problem entdeckst, hilf bitte mit, es zu beheben, indem du einen Pull Request đ ïž einreichst. Vielen Dank đ!
ultralytics.utils.downloads.is_url(url, check=False)
ĂberprĂŒft, ob die angegebene Zeichenkette eine URL ist und prĂŒft optional, ob die URL online existiert.
Parameter:
Name | Typ | Beschreibung | Standard |
---|---|---|---|
url |
str
|
Der String, der als URL validiert werden soll. |
erforderlich |
check |
bool
|
Wenn True, wird zusĂ€tzlich geprĂŒft, ob die URL online existiert. Der Standardwert ist True. |
False
|
Retouren:
Typ | Beschreibung |
---|---|
bool
|
Gibt True fĂŒr eine gĂŒltige URL zurĂŒck. Wenn "check" True ist, wird auch True zurĂŒckgegeben, wenn die URL online existiert. Andernfalls wird False zurĂŒckgegeben. |
Quellcode in ultralytics/utils/downloads.py
ultralytics.utils.downloads.delete_dsstore(path, files_to_delete=('.DS_Store', '__MACOSX'))
Löscht alle ".DS_store"-Dateien unter einem angegebenen Verzeichnis.
Parameter:
Name | Typ | Beschreibung | Standard |
---|---|---|---|
path |
str
|
Der Verzeichnispfad, in dem die ".DS_store"-Dateien gelöscht werden sollen. |
erforderlich |
files_to_delete |
tuple
|
Die zu löschenden Dateien. |
('.DS_Store', '__MACOSX')
|
Hinweis
".DS_store"-Dateien werden vom Apple-Betriebssystem erstellt und enthalten Metadaten zu Ordnern und Dateien. Sie sind versteckte Systemdateien und können beim Ăbertragen von Dateien zwischen verschiedenen Betriebssystemen Probleme verursachen.
Quellcode in ultralytics/utils/downloads.py
ultralytics.utils.downloads.zip_directory(directory, compress=True, exclude=('.DS_Store', '__MACOSX'), progress=True)
Zippt den Inhalt eines Verzeichnisses und schlieĂt dabei Dateien aus, die Zeichenfolgen in der Ausschlussliste enthalten. Die resultierende Zip-Datei wird nach dem Verzeichnis benannt und neben das Verzeichnis gelegt.
Parameter:
Name | Typ | Beschreibung | Standard |
---|---|---|---|
directory |
str | Path
|
Der Pfad zu dem Verzeichnis, das gezippt werden soll. |
erforderlich |
compress |
bool
|
Ob die Dateien beim Komprimieren komprimiert werden sollen. Die Voreinstellung ist True. |
True
|
exclude |
tuple
|
Ein Tupel mit auszuschlieĂenden Dateinamenstrings. Der Standardwert ist ('.DS_Store', '__MACOSX'). |
('.DS_Store', '__MACOSX')
|
progress |
bool
|
Ob ein Fortschrittsbalken angezeigt werden soll. Der Standardwert ist True. |
True
|
Retouren:
Typ | Beschreibung |
---|---|
Path
|
Der Pfad zur resultierenden Zip-Datei. |
Quellcode in ultralytics/utils/downloads.py
ultralytics.utils.downloads.unzip_file(file, path=None, exclude=('.DS_Store', '__MACOSX'), exist_ok=False, progress=True)
Entpackt eine *.zip-Datei in den angegebenen Pfad und schlieĂt dabei Dateien aus, die Zeichenfolgen in der Ausschlussliste enthalten.
Wenn die Zip-Datei kein einzelnes Verzeichnis der obersten Ebene enthĂ€lt, erstellt die Funktion ein neues Verzeichnis mit dem gleichen Namen wie die Zip-Datei (ohne die Erweiterung), um den Inhalt zu entpacken. Wenn kein Pfad angegeben wird, verwendet die Funktion das ĂŒbergeordnete Verzeichnis der ZIP-Datei als Standardpfad.
Parameter:
Name | Typ | Beschreibung | Standard |
---|---|---|---|
file |
str
|
Der Pfad zu der zu extrahierenden Zip-Datei. |
erforderlich |
path |
str
|
Der Pfad, in den die Zip-Datei entpackt werden soll. Der Standardwert ist None. |
None
|
exclude |
tuple
|
Ein Tupel mit auszuschlieĂenden Dateinamenstrings. Der Standardwert ist ('.DS_Store', '__MACOSX'). |
('.DS_Store', '__MACOSX')
|
exist_ok |
bool
|
Ob vorhandene Inhalte ĂŒberschrieben werden sollen, wenn sie existieren. Der Standardwert ist False. |
False
|
progress |
bool
|
Ob ein Fortschrittsbalken angezeigt werden soll. Der Standardwert ist True. |
True
|
Erhöht:
Typ | Beschreibung |
---|---|
BadZipFile
|
Wenn die angegebene Datei nicht existiert oder keine gĂŒltige Zip-Datei ist. |
Retouren:
Typ | Beschreibung |
---|---|
Path
|
Der Pfad zu dem Verzeichnis, in dem die Zip-Datei entpackt wurde. |
Quellcode in ultralytics/utils/downloads.py
ultralytics.utils.downloads.check_disk_space(url='https://ultralytics.com/assets/coco128.zip', path=Path.cwd(), sf=1.5, hard=True)
ĂberprĂŒfe, ob genĂŒgend Speicherplatz vorhanden ist, um eine Datei herunterzuladen und zu speichern.
Parameter:
Name | Typ | Beschreibung | Standard |
---|---|---|---|
url |
str
|
Die URL der Datei. Der Standardwert ist 'https://ultralytics.com/assets/coco128.zip'. |
'https://ultralytics.com/assets/coco128.zip'
|
path |
str | Path
|
Der Pfad oder das Laufwerk, auf dem der verfĂŒgbare freie Speicherplatz geprĂŒft werden soll. |
cwd()
|
sf |
float
|
Sicherheitsfaktor, der Multiplikator fĂŒr den benötigten Freiraum. Der Standardwert ist 2,0. |
1.5
|
hard |
bool
|
Ob bei unzureichendem Speicherplatz ein Fehler ausgegeben werden soll oder nicht. Der Standardwert ist True. |
True
|
Retouren:
Typ | Beschreibung |
---|---|
bool
|
True, wenn genĂŒgend Speicherplatz vorhanden ist, sonst False. |
Quellcode in ultralytics/utils/downloads.py
ultralytics.utils.downloads.get_google_drive_file_info(link)
Ruft den direkten Download-Link und den Dateinamen fĂŒr einen freigegebenen Google Drive-Dateilink ab.
Parameter:
Name | Typ | Beschreibung | Standard |
---|---|---|---|
link |
str
|
Der freigebbare Link der Google Drive-Datei. |
erforderlich |
Retouren:
Typ | Beschreibung |
---|---|
str
|
Direkte Download-URL fĂŒr die Google Drive-Datei. |
str
|
UrsprĂŒnglicher Dateiname der Google Drive-Datei. Wenn die Extraktion des Dateinamens fehlschlĂ€gt, wird None zurĂŒckgegeben. |
Beispiel
Quellcode in ultralytics/utils/downloads.py
ultralytics.utils.downloads.safe_download(url, file=None, dir=None, unzip=True, delete=False, curl=False, retry=3, min_bytes=1.0, exist_ok=False, progress=True)
LÀdt Dateien von einer URL herunter, mit Optionen zum erneuten Versuchen, Entpacken und Löschen der heruntergeladenen Datei.
Parameter:
Name | Typ | Beschreibung | Standard |
---|---|---|---|
url |
str
|
Die URL der Datei, die heruntergeladen werden soll. |
erforderlich |
file |
str
|
Der Dateiname der heruntergeladenen Datei. Wenn er nicht angegeben wird, wird die Datei unter demselben Namen wie die URL gespeichert. |
None
|
dir |
str
|
Das Verzeichnis, in dem die heruntergeladene Datei gespeichert wird. Wenn es nicht angegeben wird, wird die Datei im aktuellen Arbeitsverzeichnis gespeichert. |
None
|
unzip |
bool
|
Ob die heruntergeladene Datei entpackt werden soll. Standard: True. |
True
|
delete |
bool
|
Ob die heruntergeladene Datei nach dem Entpacken gelöscht werden soll. Standard: False. |
False
|
curl |
bool
|
Ob das Kommandozeilentool curl zum Herunterladen verwendet werden soll. Standard: False. |
False
|
retry |
int
|
Die Anzahl der Wiederholungen des Downloads im Falle eines Fehlers. Standard: 3. |
3
|
min_bytes |
float
|
Die Mindestanzahl von Bytes, die die heruntergeladene Datei haben muss, damit sie als erfolgreich heruntergeladen wurde. Standardwert: 1E0. |
1.0
|
exist_ok |
bool
|
Ob vorhandene Inhalte beim Entpacken ĂŒberschrieben werden sollen. Der Standardwert ist False. |
False
|
progress |
bool
|
Ob ein Fortschrittsbalken wÀhrend des Downloads angezeigt werden soll. Standard: True. |
True
|
Beispiel
Quellcode in ultralytics/utils/downloads.py
274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 |
|
ultralytics.utils.downloads.get_github_assets(repo='ultralytics/assets', version='latest', retry=False)
Ruft das Tag und die Assets der angegebenen Version aus einem GitHub-Repository ab. Wenn die Version nicht angegeben wird, holt die Funktion die Assets der letzten Version abrufen.
Parameter:
Name | Typ | Beschreibung | Standard |
---|---|---|---|
repo |
str
|
Das GitHub-Repository im Format "owner/repo". Der Standardwert ist "ultralytics/assets". |
'ultralytics/assets'
|
version |
str
|
Die Release-Version, von der die Assets geholt werden. Der Standardwert ist "latest". |
'latest'
|
retry |
bool
|
Flagge, um die Anfrage im Falle eines Fehlers zu wiederholen. Der Standardwert ist False. |
False
|
Retouren:
Typ | Beschreibung |
---|---|
tuple
|
Ein Tupel mit dem Release-Tag und einer Liste von Asset-Namen. |
Quellcode in ultralytics/utils/downloads.py
ultralytics.utils.downloads.attempt_download_asset(file, repo='ultralytics/assets', release='v8.2.0', **kwargs)
Versucht, eine Datei von GitHub release assets herunterzuladen, wenn sie lokal nicht gefunden wird. Die Funktion sucht die Datei und versucht dann, sie aus dem angegebenen GitHub-Repository Release herunterzuladen.
Parameter:
Name | Typ | Beschreibung | Standard |
---|---|---|---|
file |
str | Path
|
Der Dateiname oder Dateipfad, der heruntergeladen werden soll. |
erforderlich |
repo |
str
|
Das GitHub-Repository im Format "owner/repo". Der Standardwert ist "ultralytics/assets". |
'ultralytics/assets'
|
release |
str
|
Die spezifische Versionsnummer, die heruntergeladen werden soll. Der Standardwert ist "v8.2.0". |
'v8.2.0'
|
**kwargs |
any
|
ZusĂ€tzliche SchlĂŒsselwort-Argumente fĂŒr den Download-Prozess. |
{}
|
Retouren:
Typ | Beschreibung |
---|---|
str
|
Der Pfad zur heruntergeladenen Datei. |
Beispiel
Quellcode in ultralytics/utils/downloads.py
ultralytics.utils.downloads.download(url, dir=Path.cwd(), unzip=True, delete=False, curl=False, threads=1, retry=3, exist_ok=False)
LĂ€dt Dateien von angegebenen URLs in ein bestimmtes Verzeichnis herunter. UnterstĂŒtzt gleichzeitige Downloads, wenn mehrere Threads angegeben werden.
Parameter:
Name | Typ | Beschreibung | Standard |
---|---|---|---|
url |
str | list
|
Die URL oder die Liste der URLs der Dateien, die heruntergeladen werden sollen. |
erforderlich |
dir |
Path
|
Das Verzeichnis, in dem die Dateien gespeichert werden sollen. Der Standardwert ist das aktuelle Arbeitsverzeichnis. |
cwd()
|
unzip |
bool
|
Flagge zum Entpacken der Dateien nach dem Herunterladen. Der Standardwert ist True. |
True
|
delete |
bool
|
Flagge zum Löschen der Zip-Dateien nach dem Entpacken. Der Standardwert ist False. |
False
|
curl |
bool
|
Flagge, um curl fĂŒr das Herunterladen zu verwenden. Der Standardwert ist False. |
False
|
threads |
int
|
Anzahl der Threads, die fĂŒr gleichzeitige Downloads verwendet werden. Der Standardwert ist 1. |
1
|
retry |
int
|
Anzahl der Wiederholungsversuche im Falle eines Download-Fehlers. Die Standardeinstellung ist 3. |
3
|
exist_ok |
bool
|
Ob vorhandene Inhalte beim Entpacken ĂŒberschrieben werden sollen. Der Standardwert ist False. |
False
|
Quellcode in ultralytics/utils/downloads.py
Erstellt am 2023-11-12, Aktualisiert am 2024-05-08
Autoren: Burhan-Q (1), glenn-jocher (3), Laughing-q (1)