Ultralytics Operações de gestão de projectos do HUB-SDK
Bem-vindo à documentação do Ultralytics HUB-SDK! Aqui, vamos guiá-lo pelos fundamentos do gerenciamento de seus projetos de aprendizado de máquina usando o HUB-SDK. Desde a criação de um novo projeto, atualização de um projeto existente, até a navegação em listas de projetos, cobrimos tudo isso para você com trechos de código fáceis de seguir Python . Nosso objetivo é tornar sua experiência perfeita e direta, para que você possa se concentrar no que é importante - criar e implantar modelos excepcionais de aprendizado de máquina. Vamos mergulhar de cabeça 🏊!
Obter um projeto por ID
Quando já tem um projeto alojado na plataforma Ultralytics , pode querer recuperá-lo para ver os seus detalhes ou fazer alterações. Para obter um projeto pelo seu ID único, só precisa de passar o ID para a função client.project função. Abaixo está um snippet que lhe permite fazer isso mesmo, fornecendo uma visão rápida dos dados do projeto:
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)
Criar um novo projeto
Está a iniciar um novo projeto ML? Fantástico! O seguinte código Python descreve os passos para criar um novo projeto em Ultralytics. Vamos importar as bibliotecas necessárias, definir os detalhes do projeto (neste caso, o seu nome) e, finalmente, criar o projeto utilizando o comando create_project da nossa biblioteca cliente HUB-SDK. Veja como:
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
Atualizar projeto existente
Actualize os metadados do seu projeto com facilidade, especificando o ID do projeto e os novos detalhes que pretende incluir. Pode ser uma alteração de nome, uma atualização da descrição ou qualquer outra propriedade modificável. Descubra como executar essas alterações com este trecho de código simples:
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
Eliminar um projeto
Se já não precisar de um projeto e pretender eliminá-lo da plataforma Ultralytics , pode fazê-lo com uma simples chamada ao delete no objeto do projeto. O seguinte snippet irá guiá-lo através da eliminação de um projeto utilizando o seu 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
Listar e navegar nos projectos
Em alguns casos, pode querer navegar pelos seus projectos ou mesmo verificar os projectos públicos em Ultralytics. Isso pode ser feito buscando uma lista de projetos com o tamanho de página desejado. Nosso trecho de código demonstra como visualizar os resultados da página atual, navegar para a próxima página e depois voltar para a anterior. É uma ótima maneira de explorar a variedade de projetos disponíveis:
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
Parabéns! Está agora equipado com os conhecimentos necessários para gerir sem esforço os seus projectos de aprendizagem automática em Ultralytics HUB-SDK. Experimente estas operações e veja como os seus esforços de ML se tornam mais organizados e eficientes. Se tiver alguma dúvida ou precisar de mais assistência, não hesite em contactar a nossa comunidade de apoio. Boa programação! 🚀