Referentie voor ultralytics/utils/downloads.py
Opmerking
Dit bestand is beschikbaar op https://github.com/ultralytics/ ultralytics/blob/main/ ultralytics/utils/downloads .py. Als je een probleem ziet, help het dan oplossen door een Pull Request 🛠️ bij te dragen. Bedankt 🙏!
ultralytics.utils.downloads.is_url(url, check=False)
Valideert of de gegeven string een URL is en controleert optioneel of de URL online bestaat.
Parameters:
Naam | Type | Beschrijving | Standaard |
---|---|---|---|
url |
str
|
De tekenreeks die moet worden gevalideerd als een URL. |
vereist |
check |
bool
|
Als dit Waar is, wordt er een extra controle uitgevoerd om te zien of de URL online bestaat. Standaard ingesteld op True. |
False
|
Retourneert:
Type | Beschrijving |
---|---|
bool
|
Geeft True terug voor een geldige URL. Als 'check' True is, wordt ook True teruggegeven als de URL online bestaat. Geeft anders Onwaar terug. |
Broncode in ultralytics/utils/downloads.py
ultralytics.utils.downloads.delete_dsstore(path, files_to_delete=('.DS_Store', '__MACOSX'))
Verwijdert alle ".DS_store" bestanden onder een opgegeven map.
Parameters:
Naam | Type | Beschrijving | Standaard |
---|---|---|---|
path |
str
|
Het directorypad waar de ".DS_store" bestanden verwijderd moeten worden. |
vereist |
files_to_delete |
tuple
|
De bestanden die verwijderd moeten worden. |
('.DS_Store', '__MACOSX')
|
Opmerking
".DS_store" bestanden worden aangemaakt door het Apple besturingssysteem en bevatten metadata over mappen en bestanden. Ze zijn verborgen systeembestanden en kunnen problemen veroorzaken bij het overzetten van bestanden tussen verschillende besturingssystemen.
Broncode in ultralytics/utils/downloads.py
ultralytics.utils.downloads.zip_directory(directory, compress=True, exclude=('.DS_Store', '__MACOSX'), progress=True)
Zipt de inhoud van een map, met uitsluiting van bestanden die strings in de uitsluitingslijst bevatten. Het resulterende zip-bestand wordt genoemd naar de map en wordt ernaast geplaatst.
Parameters:
Naam | Type | Beschrijving | Standaard |
---|---|---|---|
directory |
str | Path
|
Het pad naar de map die gezipt moet worden. |
vereist |
compress |
bool
|
Of de bestanden gecomprimeerd moeten worden tijdens het zippen. De standaardinstelling is True. |
True
|
exclude |
tuple
|
Een tupel van bestandsnaamstrings die moeten worden uitgesloten. Standaard ('.DS_Store', '__MACOSX'). |
('.DS_Store', '__MACOSX')
|
progress |
bool
|
Of een voortgangsbalk moet worden weergegeven. Standaard ingesteld op Waar. |
True
|
Retourneert:
Type | Beschrijving |
---|---|
Path
|
Het pad naar het resulterende zipbestand. |
Broncode in ultralytics/utils/downloads.py
ultralytics.utils.downloads.unzip_file(file, path=None, exclude=('.DS_Store', '__MACOSX'), exist_ok=False, progress=True)
Zipt een *.zip-bestand uit naar het opgegeven pad, met uitsluiting van bestanden die strings in de uitsluitingslijst bevatten.
Als het zipbestand geen map op het hoogste niveau bevat, maakt de functie een nieuwe map aan met dezelfde naam als het zipbestand (zonder de extensie) om de inhoud uit te pakken. Als er geen pad is opgegeven, gebruikt de functie de bovenliggende map van het zipbestand als standaardpad.
Parameters:
Naam | Type | Beschrijving | Standaard |
---|---|---|---|
file |
str
|
Het pad naar het zipbestand dat moet worden uitgepakt. |
vereist |
path |
str
|
Het pad waarnaar het zipbestand moet worden uitgepakt. Staat standaard op Geen. |
None
|
exclude |
tuple
|
Een tupel van bestandsnaamstrings die moeten worden uitgesloten. Standaard ('.DS_Store', '__MACOSX'). |
('.DS_Store', '__MACOSX')
|
exist_ok |
bool
|
Of bestaande inhoud moet worden overschreven als die bestaat. Staat standaard op Onwaar. |
False
|
progress |
bool
|
Of een voortgangsbalk moet worden weergegeven. Standaard ingesteld op Waar. |
True
|
Verhogingen:
Type | Beschrijving |
---|---|
BadZipFile
|
Als het opgegeven bestand niet bestaat of geen geldig zipbestand is. |
Retourneert:
Type | Beschrijving |
---|---|
Path
|
Het pad naar de map waar het zipbestand is uitgepakt. |
Broncode 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)
Controleer of er voldoende schijfruimte is om een bestand te downloaden en op te slaan.
Parameters:
Naam | Type | Beschrijving | Standaard |
---|---|---|---|
url |
str
|
De URL naar het bestand. Standaard is dit 'https://ultralytics.com/assets/coco128.zip'. |
'https://ultralytics.com/assets/coco128.zip'
|
path |
str | Path
|
Het pad of de schijf waarop de beschikbare vrije ruimte moet worden gecontroleerd. |
cwd()
|
sf |
float
|
Veiligheidsfactor, de vermenigvuldiger voor de benodigde vrije ruimte. Wordt standaard ingesteld op 2,0. |
1.5
|
hard |
bool
|
Of er al dan niet een foutmelding moet worden gegeven bij onvoldoende schijfruimte. Standaard ingesteld op True. |
True
|
Retourneert:
Type | Beschrijving |
---|---|
bool
|
True als er voldoende schijfruimte is, anders False. |
Broncode in ultralytics/utils/downloads.py
ultralytics.utils.downloads.get_google_drive_file_info(link)
Haalt de directe downloadlink en bestandsnaam op voor een deelbare Google Drive bestandskoppeling.
Parameters:
Naam | Type | Beschrijving | Standaard |
---|---|---|---|
link |
str
|
De deelbare link van het Google Drive bestand. |
vereist |
Retourneert:
Type | Beschrijving |
---|---|
str
|
Directe download URL voor het Google Drive bestand. |
str
|
Oorspronkelijke bestandsnaam van het Google Drive bestand. Als het extraheren van de bestandsnaam mislukt, wordt er niets teruggegeven. |
Voorbeeld
Broncode 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)
Downloadt bestanden van een URL, met opties voor opnieuw proberen, uitpakken en verwijderen van het gedownloade bestand.
Parameters:
Naam | Type | Beschrijving | Standaard |
---|---|---|---|
url |
str
|
De URL van het bestand dat moet worden gedownload. |
vereist |
file |
str
|
De bestandsnaam van het gedownloade bestand. Als deze niet wordt opgegeven, wordt het bestand opgeslagen met dezelfde naam als de URL. |
None
|
dir |
str
|
De map waarin het gedownloade bestand wordt opgeslagen. Als deze niet wordt opgegeven, wordt het bestand opgeslagen in de huidige werkmap. |
None
|
unzip |
bool
|
Of het gedownloade bestand moet worden uitgepakt. Standaard: Waar. |
True
|
delete |
bool
|
Of het gedownloade bestand moet worden verwijderd na het uitpakken. Standaard: Onwaar. |
False
|
curl |
bool
|
Of het curl commandoregeltool moet worden gebruikt voor downloaden. Standaard: False. |
False
|
retry |
int
|
Het aantal keren dat de download opnieuw moet worden geprobeerd in geval van mislukking. Standaard: 3. |
3
|
min_bytes |
float
|
Het minimum aantal bytes dat het gedownloade bestand moet hebben om te worden beschouwd als als een succesvolle download. Standaard: 1E0. |
1.0
|
exist_ok |
bool
|
Of bestaande inhoud moet worden overschreven tijdens het uitpakken. Staat standaard op Onwaar. |
False
|
progress |
bool
|
Of er een voortgangsbalk moet worden weergegeven tijdens het downloaden. Standaard: Waar. |
True
|
Voorbeeld
Broncode 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)
Haal de tag en assets van de opgegeven versie op van een GitHub repository. Als de versie niet is opgegeven, haalt de functie de laatste release activa ophalen.
Parameters:
Naam | Type | Beschrijving | Standaard |
---|---|---|---|
repo |
str
|
De GitHub repository in het formaat 'owner/repo'. Standaard is dit 'ultralytics/assets'. |
'ultralytics/assets'
|
version |
str
|
De releaseversie om activa van op te halen. Staat standaard op 'latest'. |
'latest'
|
retry |
bool
|
Vlag om het verzoek opnieuw te proberen als het mislukt. Staat standaard op Onwaar. |
False
|
Retourneert:
Type | Beschrijving |
---|---|
tuple
|
Een tupel met de releasetag en een lijst met assetnamen. |
Broncode in ultralytics/utils/downloads.py
ultralytics.utils.downloads.attempt_download_asset(file, repo='ultralytics/assets', release='v8.2.0', **kwargs)
Probeert een bestand te downloaden van GitHub release assets als het lokaal niet gevonden wordt. De functie controleert eerst of het bestand eerst lokaal en probeert het dan te downloaden van de gespecificeerde GitHub repository release.
Parameters:
Naam | Type | Beschrijving | Standaard |
---|---|---|---|
file |
str | Path
|
De bestandsnaam of het bestandspad dat moet worden gedownload. |
vereist |
repo |
str
|
De GitHub repository in het formaat 'owner/repo'. Standaard is dit 'ultralytics/assets'. |
'ultralytics/assets'
|
release |
str
|
De specifieke releaseversie die moet worden gedownload. Staat standaard op 'v8.2.0'. |
'v8.2.0'
|
**kwargs |
any
|
Extra trefwoordargumenten voor het downloadproces. |
{}
|
Retourneert:
Type | Beschrijving |
---|---|
str
|
Het pad naar het gedownloade bestand. |
Voorbeeld
Broncode 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)
Downloadt bestanden van opgegeven URL's naar een opgegeven map. Ondersteunt gelijktijdige downloads als meerdere threads zijn zijn opgegeven.
Parameters:
Naam | Type | Beschrijving | Standaard |
---|---|---|---|
url |
str | list
|
De URL of lijst met URL's van de bestanden die moeten worden gedownload. |
vereist |
dir |
Path
|
De map waar de bestanden worden opgeslagen. Standaard de huidige werkmap. |
cwd()
|
unzip |
bool
|
Vlag om de bestanden uit te pakken na het downloaden. Standaard ingesteld op True. |
True
|
delete |
bool
|
Vlag om de zipbestanden te verwijderen na het uitpakken. Staat standaard op False. |
False
|
curl |
bool
|
Vlag om curl te gebruiken voor downloaden. Staat standaard op False. |
False
|
threads |
int
|
Aantal threads om te gebruiken voor gelijktijdige downloads. Staat standaard op 1. |
1
|
retry |
int
|
Aantal nieuwe pogingen in geval van mislukte download. Staat standaard op 3. |
3
|
exist_ok |
bool
|
Of bestaande inhoud moet worden overschreven tijdens het uitpakken. Staat standaard op Onwaar. |
False
|