Saltar al contenido

Operaciones de gesti贸n de conjuntos de datos con Ultralytics HUB-SDK

隆Bienvenido a la Documentaci贸n de Gesti贸n de Conjuntos de Datos de Ultralytics HUB-SDK! 馃憢

Gestionar conjuntos de datos de forma eficiente es crucial en el mundo del Aprendizaje Autom谩tico. Tanto si eres un cient铆fico de datos experimentado como un principiante en este campo, saber c贸mo manejar las operaciones de los conjuntos de datos puede agilizar tu flujo de trabajo. Esta p谩gina cubre los aspectos b谩sicos de la realizaci贸n de operaciones con conjuntos de datos utilizando Ultralytics HUB-SDK en Python. Los ejemplos que se ofrecen ilustran c贸mo obtener, crear, actualizar, eliminar, listar conjuntos de datos, obtener una URL para acceder a conjuntos de datos y cargar conjuntos de datos.

隆Vamos a sumergirnos! 馃殌

Obtener un conjunto de datos por ID

驴Buscas un conjunto de datos concreto? Obt茅nlo r谩pidamente utilizando su ID 煤nico con el fragmento de c贸digo que aparece a continuaci贸n. Esto te permitir谩 acceder a informaci贸n esencial, incluidos sus datos.

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

Crear un conjunto de datos

驴Listo para empezar un nuevo proyecto? Sigue los pasos que se indican a continuaci贸n para crear un nuevo conjunto de datos. Todo lo que necesitas es definir un nombre amigable para tu conjunto de datos y utilizar la funci贸n create_dataset m茅todo.

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!")

Actualizar un conjunto de datos

A medida que los proyectos evolucionan, tambi茅n deber铆an hacerlo tus conjuntos de datos. Si necesitas modificar los metadatos de tu conjunto de datos, es tan sencillo como ejecutar el c贸digo siguiente con los nuevos datos.

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.")

Eliminar un conjunto de datos

Si alguna vez necesitas eliminar un conjunto de datos, ya sea para despejar tu espacio de trabajo o porque ya no lo necesitas, puedes eliminarlo permanentemente invocando la funci贸n delete como se muestra aqu铆.

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.")

Lista de conjuntos de datos

Para navegar por tus conjuntos de datos o encontrar el que necesitas, puedes listar todos tus conjuntos de datos con paginaci贸n. Es 煤til cuando se trata de un gran n煤mero de conjuntos de datos.

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)

Obtener URL del almac茅n

Esta pr谩ctica funci贸n obtiene una URL para acceder al almacenamiento de conjuntos de datos, lo que facilita la descarga de archivos de conjuntos de datos o artefactos almacenados a distancia.

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)

Cargar conjunto de datos

Cargar tu conjunto de datos es un proceso sencillo. Establece el ID de tu conjunto de datos y la ruta del archivo que deseas cargar y, a continuaci贸n, utiliza el bot贸n upload_dataset como se detalla a continuaci贸n.

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.")

Recuerda que, cuando trabajes con conjuntos de datos, siempre es una buena pr谩ctica comprobar y verificar cada paso del proceso. Comprueba dos veces los ID de tus conjuntos de datos y las rutas de los archivos para asegurarte de que todo funciona correctamente.

Si te encuentras con alg煤n problema o tienes alguna pregunta, nuestro amable equipo de asistencia est谩 aqu铆 para ayudarte a superar cualquier reto. 馃

隆Feliz lucha con los datos, y que tus modelos sean precisos y perspicaces! 馃専


Comentarios