Ultralytics Operazioni di gestione del progetto HUB-SDK
Benvenuti nella documentazione di Ultralytics HUB-SDK! Qui vi guideremo attraverso gli elementi essenziali della gestione dei 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 vostra esperienza semplice e continua, in modo che possiate concentrarvi sulle cose importanti: costruire e distribuire modelli di apprendimento automatico eccezionali. Immergiamoci 🏊!
Recuperare un progetto per ID
Quando si ha già un progetto ospitato sulla piattaforma Ultralytics , si può desiderare di recuperarlo per vederne i dettagli o apportare modifiche. Per recuperare un progetto in base al suo ID univoco, è sufficiente passare l'ID al metodo client.project funzione. Di seguito è riportato uno snippet che consente 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)
Creare un nuovo progetto
State 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
Aggiornamento del progetto esistente
Aggiornate i metadati del vostro progetto con facilità, specificando l'ID del progetto e i nuovi dettagli che volete includere. Può trattarsi di una modifica del nome, di un aggiornamento della descrizione o di qualsiasi altra proprietà modificabile. Scoprite 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
Eliminare un progetto
Se non si ha più bisogno di un progetto e si desidera cancellarlo dalla piattaforma Ultralytics , lo si può fare con una semplice chiamata alla funzione delete sull'oggetto progetto. Il seguente snippet guida l'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, si può desiderare di sfogliare i propri progetti o anche di 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 avete le conoscenze necessarie per gestire senza problemi i vostri progetti di apprendimento automatico su Ultralytics HUB-SDK. Sperimentate queste operazioni e osservate come i vostri progetti di ML diventino più organizzati ed efficienti. Se avete domande o bisogno di ulteriore assistenza, non esitate a contattare la nostra comunità. Buona codifica! 🚀