Ultralytics Operações de gestão de projectos do HUB-SDK
Bem-vindo à documentação do Ultralytics HUB-SDK! Aqui, vamos guiar-te através dos elementos essenciais da gestão dos teus projectos de aprendizagem automática utilizando o HUB-SDK. Desde a criação de um novo projeto, atualização de um existente, até à navegação através de listas de projectos, cobrimos tudo isto para ti com snippets de código Python fáceis de seguir. O nosso objetivo é tornar a tua experiência simples e direta, para que te possas concentrar no que é importante - construir e implementar modelos de aprendizagem automática excepcionais. Vamos mergulhar de cabeça 🏊!
Busca um projeto por ID
Quando já tiveres um projeto alojado na plataforma Ultralytics , podes querer recuperá-lo para ver os seus detalhes ou fazer alterações. Para obter um projeto pelo seu ID único, só precisas de passar o ID para a função client.project
função. Abaixo está um snippet que te 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ás 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. Vê 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 o projeto existente
Actualiza os metadados do teu projeto com facilidade, especificando o ID do projeto e os novos detalhes que pretendes incluir. Pode ser uma alteração de nome, uma atualização da descrição ou qualquer outra propriedade modificável. Descobre como executar estas alterações com este simples excerto de código:
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 precisares de um projeto e quiseres eliminá-lo da plataforma Ultralytics , podes fazê-lo com uma simples chamada ao delete
no objeto do projeto. O seguinte snippet irá guiar-te na 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
Lista e navega pelos projectos
Em alguns casos, poderás querer navegar pelos teus 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ás agora equipado com os conhecimentos necessários para gerir sem esforço os teus projectos de aprendizagem automática em Ultralytics HUB-SDK. Experimenta estas operações e vê como os teus esforços de ML se tornam mais organizados e eficientes. Se tiveres alguma dúvida ou precisares de mais assistência, não hesites em contactar a nossa comunidade de apoio. Boa programação! 🚀