تخطي إلى المحتوى

عمليات إدارة مجموعة البيانات مع Ultralytics HUB-SDK

مرحبًا بك في وثائق إدارة مجموعة بيانات Ultralytics HUB-SDK! 👋

تُعد إدارة مجموعات البيانات بكفاءة أمرًا بالغ الأهمية في عالم التعلم الآلي. وسواء كنت عالم بيانات متمرسًا أو مبتدئًا في هذا المجال، فإن معرفة كيفية التعامل مع عمليات مجموعات البيانات يمكن أن تبسط سير عملك. تغطي هذه الصفحة أساسيات إجراء العمليات على مجموعات البيانات باستخدام Ultralytics HUB-SDK في Python. توضّح الأمثلة المقدمة كيفية الحصول على مجموعات البيانات وإنشائها وتحديثها وحذفها وإدراجها في قائمة البيانات، والحصول على عنوان URL للوصول إلى مجموعة البيانات، وتحميل مجموعات البيانات.

دعونا نغوص في! 🚀

الحصول على مجموعة بيانات حسب المعرف

هل تبحث عن مجموعة بيانات محددة؟ اجلبها بسرعة باستخدام معرّفها الفريد باستخدام مقتطف الشفرة أدناه. سيتيح لك ذلك الوصول إلى المعلومات الأساسية، بما في ذلك بياناتها.

from hub_sdk import HUBClient

credentials = {"api_key": "<YOUR-API-KEY>"}
client = HUBClient(credentials)

# Fetch a dataset by ID
dataset = client.dataset("<Dataset ID>")  # Replace with your actual Dataset ID
print(dataset.data)  # This prints the dataset information

إنشاء مجموعة بيانات

هل أنت مستعد لبدء مشروع جديد؟ اتبع الخطوات أدناه لإنشاء مجموعة بيانات جديدة. كل ما تحتاجه هو تحديد اسم مألوف لمجموعة البيانات الخاصة بك واستخدام create_dataset الطريقة.

from hub_sdk import HUBClient

credentials = {"api_key": "<YOUR-API-KEY>"}
client = HUBClient(credentials)

# Define your dataset properties
data = {"meta": {"name": "My Dataset"}}  # Replace 'My Dataset' with your desired dataset name

# Create the dataset
dataset = client.dataset()
dataset.create_dataset(data)
print("Dataset created successfully!")

تحديث مجموعة بيانات

مع تطور المشاريع، يجب أن تتطور مجموعات البيانات الخاصة بك. إذا كنت بحاجة إلى تعديل البيانات الوصفية لمجموعة البيانات الخاصة بك، فالأمر بسيط مثل تشغيل الكود التالي بالتفاصيل الجديدة.

from hub_sdk import HUBClient

credentials = {"api_key": "<YOUR-API-KEY>"}
client = HUBClient(credentials)

# Obtain the dataset
dataset = client.dataset("<Dataset ID>")  # Insert the correct Dataset ID

# Update the dataset's metadata
dataset.update({"meta": {"name": "Updated Name"}})  # Modify 'Updated Name' as required
print("Dataset updated with new information.")

حذف مجموعة بيانات

إذا احتجتَ في أي وقت إلى إزالة مجموعة بيانات، سواءً كان ذلك لإزالة الفوضى من مساحة عملك أو لعدم الحاجة إليها، يمكنك حذفها نهائيًا عن طريق استدعاء delete كما هو موضح هنا.

from hub_sdk import HUBClient

credentials = {"api_key": "<YOUR-API-KEY>"}
client = HUBClient(credentials)

# Select the dataset by its ID
dataset = client.dataset("<Dataset ID>")  # Ensure the Dataset ID is specified

# Delete the dataset
dataset.delete()
print("Dataset has been deleted.")

قائمة مجموعات البيانات

لتصفح مجموعات البيانات الخاصة بك أو العثور على المجموعة التي تحتاجها، يمكنك سرد جميع مجموعات البيانات الخاصة بك مع ترقيم الصفحات. وهو مفيد عند التعامل مع عدد كبير من مجموعات البيانات.

from hub_sdk import HUBClient

credentials = {"api_key": "<YOUR-API-KEY>"}
client = HUBClient(credentials)

# Retrieve the first page of datasets
dataset = client.dataset_list(page_size=10)
print("Current dataset:", dataset.results)  # Show the datasets on the current page

# Move to the next page and show results
dataset.next()
print("Next page result:", dataset.results)

# Go back to the previous page
dataset.previous()
print("Previous page result:", dataset.results)

الحصول على عنوان URL من التخزين

تعمل هذه الوظيفة الملائمة على جلب عنوان URL للوصول إلى تخزين مجموعة البيانات، مما يجعل تنزيل ملفات مجموعة البيانات أو القطع الأثرية المخزنة عن بُعد أمرًا سهلاً.

from hub_sdk import HUBClient

credentials = {"api_key": "<YOUR-API-KEY>"}
client = HUBClient(credentials)

# Define the dataset ID for which you want a download link
dataset = client.dataset("<Dataset ID>")  # Don't forget to replace Dataset ID with the actual dataset ID

# Retrieve the URL for downloading dataset contents
url = dataset.get_download_link()
print("Download URL:", url)

تحميل مجموعة البيانات

إن تحميل مجموعة بياناتك عملية بسيطة ومباشرة. قم بتعيين معرّف مجموعة البيانات الخاصة بك ومسار الملف الذي ترغب في تحميله، ثم استخدم upload_dataset على النحو المفصل أدناه.

from hub_sdk import HUBClient

credentials = {"api_key": "<YOUR-API-KEY>"}
client = HUBClient(credentials)

# Select the dataset
dataset = client.dataset("<Dataset ID>")  # Substitute with the real dataset ID

# Upload the dataset file
dataset.upload_dataset(file="<Dataset File>")  # Make sure to specify the correct file path
print("Dataset has been uploaded.")

تذكّر، عند العمل مع مجموعات البيانات، من الجيد دائمًا التحقق من كل خطوة من خطوات العملية والتحقق منها. تحقق مرة أخرى من معرفات مجموعات البيانات ومسارات الملفات لضمان سير كل شيء بسلاسة.

في حال واجهتك أي مشاكل أو كانت لديك أي أسئلة، فإن فريق الدعم الودود لدينا هنا لمساعدتك في التغلب على أي تحديات. 🤝

كل عام وأنتم بخير، وعسى أن تكون نماذجكم دقيقة وثاقبة! 🌟

التعليقات