qdrive

Dataset management and measurement library for the qHarbor data platform.

qdrive is the Python interface for creating, managing, and syncing scientific datasets with qHarbor.

Features

📦 Create & manage datasets — Store measurements with rich metadata (tags, attributes, descriptions)
📁 Multi-file support with versioning — Attach xarray, NumPy, JSON, HDF5 or any file, with automatic version tracking
🔍 Powerful search — Filter datasets by attributes, date range, tags, or text
☁️ Cloud sync — Automatic synchronization via the sync agent
📊 Measurement tools — Built-in do0D, do1D, do2D sweep functions using native qHarbor format, compatible with QCoDeS parameters

Installation

pip install qdrive

Quick Start

Log in

import qdrive
qdrive.launch_GUI()

Create a dataset

from qdrive import dataset

ds = dataset.create(
    'Qubit T2* measurement',
    tags=['calibration'],
    attributes={'sample': 'Q7-R3', 'fridge': 'BlueFors-1'}
)

Add files to a dataset

import numpy as np
import xarray as xr

# Add various file types
ds['config.json'] = {'param1': 42, 'param2': 'value'}
ds['raw_data.npz'] = np.random.rand(100, 100)
ds['measurement.hdf5'] = xr.Dataset({'signal': (['time'], np.sin(np.linspace(0, 10, 100)))})
ds['script.py'] = __file__  # Attach the current script

Retrieve and access data

from qdrive import dataset

ds = dataset('59c40af3-cef3-49aa-8747-64707a9b080a')  # Load by UUID

# Access files in multiple formats
xr_data = ds['measurement.hdf5'].xarray
json_data = ds['config.json'].json

Search datasets

from qdrive.dataset.search import search_datasets

results = search_datasets(
    search_query='T2*',
    attributes={'sample': 'Q7-R3'},
    ranking=1
)

for ds in results:
    print(ds.name, ds.uuid)

Documentation

📖 Full Documentation
🖥️ DataQruiser App — Browse and visualize your data
💬 Support

License

Release files for qdrive 0.2.61

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for qdrive 0.2.61
File	Interpreter	ABI	Platform	Reset
qdrive-0.2.61-py3-none-any.whl 132.1 kB Jun 18, 2026	Python 3	none	any	Details

Release files / qdrive-0.2.61-py3-none-any.whl

Download URL	qdrive-0.2.61-py3-none-any.whl
Size	132.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`74012929b6b8d3d54e9c89a0dc15e5c6382c88b95a1221e8f52ed76623828cd7`
BLAKE2b-256 checksum How to use checksums	`d88f7e897e4fccbb7792a9a88d43226d3d5bf22049b89dadddaf9cd76dbffb57`
Upload date	Jun 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.11.12`