Ultralytics Operazioni di gestione del progetto HUB-SDK
Benvenuto nella documentazione di Ultralytics HUB-SDK! Qui ti guideremo attraverso gli elementi essenziali della gestione dei tuoi progetti di apprendimento automatico utilizzando HUB-SDK. Dalla creazione di un nuovo progetto, all'aggiornamento di quello esistente, fino alla navigazione tra gli elenchi di progetti, abbiamo pensato a tutto con frammenti di codice Python facili da seguire. Il nostro obiettivo è quello di rendere la tua esperienza semplice e continua, in modo che tu possa concentrarti sulle cose importanti: costruire e distribuire modelli di apprendimento automatico eccezionali. Immergiamoci 🏊!
Recupera un progetto per ID
Quando hai già un progetto ospitato sulla piattaforma Ultralytics , potresti voler recuperarlo per vederne i dettagli o per apportare delle modifiche. Per recuperare un progetto in base al suo ID univoco, devi solo passare l'ID al metodo client.project funzione. Di seguito trovi uno snippet che ti permette di fare proprio questo, dando una rapida occhiata ai dati del progetto:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # api key
client = HUBClient(credentials)
project = client.project("<Project ID>") # Replace '<Project ID>' with your actual project ID
print(project.data)
Crea un nuovo progetto
Stai iniziando un nuovo progetto di ML? Fantastico! Il seguente codice Python illustra i passaggi per creare un nuovo progetto su Ultralytics. Importeremo le librerie necessarie, definiremo i dettagli del progetto (in questo caso il suo nome) e infine creeremo il progetto utilizzando l'opzione create_project della nostra libreria client HUB-SDK. Ecco come fare:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # api key
client = HUBClient(credentials)
data = {"meta": {"name": "my project"}} # Name your project
project = client.project() # Initialize a project instance
project.create_project(data) # Create your new project with the specified data
Aggiorna il progetto esistente
Aggiorna i metadati del tuo progetto con facilità, specificando l'ID del progetto e i nuovi dettagli che vuoi includere. Potrebbe trattarsi di una modifica del nome, di un aggiornamento della descrizione o di qualsiasi altra proprietà modificabile. Scopri come eseguire queste modifiche con questo semplice frammento di codice:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # api key
client = HUBClient(credentials)
project = client.project("<Project ID>") # Provide your actual project ID here
project.update({"meta": {"name": "Project name update"}}) # Update the project's name or other metadata
Elimina un progetto
Se non hai più bisogno di un progetto e desideri eliminarlo dalla piattaforma Ultralytics , puoi farlo con una semplice chiamata al metodo delete sull'oggetto progetto. Il seguente snippet ti guiderà nell'eliminazione di un progetto utilizzando il suo ID:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # api key
client = HUBClient(credentials)
project = client.project("<Project ID>") # Input the project ID for the project to delete
project.delete() # This will permanently delete your project
Elenco e navigazione dei progetti
In alcuni casi, potresti voler sfogliare i tuoi progetti o anche controllare i progetti pubblici su Ultralytics. Questo può essere fatto recuperando un elenco di progetti con la dimensione della pagina desiderata. Il nostro snippet di codice mostra come visualizzare i risultati della pagina corrente, passare alla pagina successiva e poi tornare a quella precedente. È un ottimo modo per esplorare l'ampia gamma di progetti disponibili:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # api key
client = HUBClient(credentials)
projects = client.project_list(page_size=10) # Fetch a list of projects with specified page size
print("Current result:", projects.results) # Display the projects in the current page
projects.next() # Navigate to the next page
print("Next page result:", projects.results) # Display the projects after pagination
projects.previous() # Go back to the previous page
print("Previous page result:", projects.results) # Confirm the projects in the previous page
Congratulazioni! Ora hai le conoscenze necessarie per gestire senza problemi i tuoi progetti di apprendimento automatico su Ultralytics HUB-SDK. Sperimenta queste operazioni e vedrai che i tuoi progetti di ML diventeranno più organizzati ed efficienti. Se hai domande o hai bisogno di ulteriore assistenza, non esitare a contattare la nostra comunità. Buon coding! 🚀