Dự án - Các hoạt động của Ultralytics HUB-SDK
Chào mừng bạn đến với tài liệu Ultralytics HUB-SDK! Hướng dẫn này sẽ giúp bạn nắm vững những điều cơ bản để quản lý các dự án máy học của mình bằng HUB-SDK. Chúng tôi đề cập đến mọi thứ, từ việc tạo một dự án mới và cập nhật các dự án hiện có đến điều hướng qua danh sách các dự án, tất cả đều có các đoạn mã Python dễ thực hiện theo. Mục tiêu của chúng tôi là cung cấp trải nghiệm liền mạch và đơn giản, cho phép bạn tập trung vào việc xây dựng và triển khai các mô hình máy học đặc biệt. Hãy cùng bắt đầu 🏊!
Tìm nạp một Dự án theo ID
Để truy xuất một dự án được lưu trữ trên nền tảng Ultralytics và xem chi tiết của nó hoặc thực hiện các thay đổi, hãy tìm nạp nó bằng ID duy nhất của nó. Chuyển ID đến client.project function như được hiển thị trong đoạn mã dưới đây:
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
Để biết thêm chi tiết, hãy xem tài liệu tham khảo cho hub_sdk/modules/projects.py.
Tạo một Dự án Mới
Bắt đầu một dự án machine learning mới bằng cách tạo một dự án trong Ultralytics HUB. Đoạn code Python sau đây phác thảo cách xác định chi tiết dự án (trong trường hợp này là tên của nó) và tạo dự án bằng cách sử dụng create_project phương thức:
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
Cập nhật một dự án hiện có
Dễ dàng cập nhật metadata của dự án bằng cách chỉ định ID dự án và thông tin chi tiết mới. Điều này có thể bao gồm thay đổi tên, cập nhật mô tả hoặc các thuộc tính có thể sửa đổi khác. Thực hiện các thay đổi này với đoạn mã sau:
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
Xóa một dự án
Để xóa một dự án khỏi nền tảng Ultralytics, hãy sử dụng delete method trên đối tượng dự án. Đoạn mã sau đây hướng dẫn bạn cách xóa một dự án bằng ID của nó:
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
Liệt kê và điều hướng các dự án
Duyệt qua các dự án của bạn hoặc khám phá các dự án công khai trên Ultralytics bằng cách tìm nạp danh sách với kích thước trang mong muốn của bạn. Đoạn mã dưới đây minh họa cách xem kết quả trang hiện tại, điều hướng đến trang tiếp theo và quay lại trang trước:
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
Chúc mừng bạn! Giờ đây, bạn đã có thể quản lý các dự án máy học của mình trên Ultralytics HUB một cách dễ dàng. Hãy thử nghiệm với các thao tác này để nâng cao khả năng tổ chức và hiệu quả các nỗ lực ML của bạn. Nếu có bất kỳ câu hỏi nào hoặc cần hỗ trợ thêm, vui lòng liên hệ với cộng đồng của chúng tôi. Chúc bạn viết code vui vẻ! 🚀
