Projeto - Operações do Ultralytics HUB-SDK
Bem-vindo à documentação do HUB-SDK Ultralytics ! Este guia orienta-o nos aspectos essenciais da gestão dos seus projectos de aprendizagem automática utilizando o HUB-SDK. Cobrimos tudo, desde a criação de um novo projeto e a atualização dos existentes até a navegação por listas de projetos, tudo com trechos de código Python fáceis de seguir. Nosso objetivo é fornecer uma experiência simples e direta, permitindo que você se concentre na criação e implantação de modelos excepcionais de aprendizado de máquina. Vamos mergulhar de cabeça 🏊!
Obter um projeto por ID
Para recuperar um projeto alojado na plataforma Ultralytics e ver os seus detalhes ou fazer alterações, procure-o pelo seu ID único. Passe o ID para o comando client.project como mostrado no trecho abaixo:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # Replace with your API key
client = HUBClient(credentials)
project = client.project("<Project ID>") # Replace '<Project ID>' with your actual project ID
print(project.data) # Displays the project's data
Para mais pormenores, ver o referência para hub_sdk/modules/projects.py.
Criar um novo projeto
Comece um novo projeto de aprendizagem automática criar um projeto no Ultralytics HUB. O seguinte código Python descreve como definir os detalhes do projeto (neste caso, o seu nome) e criar o projeto utilizando o comando create_project método:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # Replace with your API key
client = HUBClient(credentials)
data = {"meta": {"name": "my project"}} # Define the project name
project = client.project() # Initialize a project instance
project.create_project(data) # Create the new project with the specified data
Atualizar um projeto existente
Actualize facilmente os metadados do seu projeto, especificando o ID do projeto e os novos detalhes. Isto pode incluir uma alteração de nome, uma atualização da descrição ou outras propriedades modificáveis. Execute essas alterações com o seguinte trecho de código:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # Replace with your API key
client = HUBClient(credentials)
project = client.project("<Project ID>") # Replace with your actual project ID
project.update({"meta": {"name": "Project name update"}}) # Update the project's name or other metadata
Eliminar um projeto
Para remover um projeto da plataforma Ultralytics , utilize o comando delete no objeto do projeto. O seguinte snippet orienta-o na eliminação de um projeto utilizando o seu ID:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # Replace with your API key
client = HUBClient(credentials)
project = client.project("<Project ID>") # Replace with the project ID to delete
project.delete() # Permanently deletes the project
Listar e navegar nos projectos
Navegue pelos seus projectos ou explore projectos públicos no Ultralytics , obtendo uma lista com o tamanho de página pretendido. O trecho de código abaixo demonstra como visualizar os resultados da página atual, navegar para a próxima página e retornar à anterior:
from hub_sdk import HUBClient
credentials = {"api_key": "<YOUR-API-KEY>"} # Replace with your API key
client = HUBClient(credentials)
projects = client.project_list(page_size=10) # Fetch a list of projects with a specified page size
print("Current result:", projects.results) # Display the projects on the current page
projects.next() # Navigate to the next page
print("Next page result:", projects.results) # Display the projects on the next page
projects.previous() # Go back to the previous page
print("Previous page result:", projects.results) # Confirm the projects on the previous page
Parabéns! Está agora equipado para gerir sem esforço os seus projectos de aprendizagem automática no Ultralytics HUB. Experimente essas operações para melhorar a organização e a eficiência de seus esforços de ML. Para qualquer dúvida ou assistência adicional, sinta-se à vontade para entrar em contato com nossa comunidade. Codificação feliz! 🚀
