Dataset suite (dataset-suite)

Store scientific data in HDF5 files, but with pleasant Python bindings!

A general data handling toolkit with a powerful class for abstracting away work with multidimensional set.

Documentation: https://dataset-suite.readthedocs.io
Repository: https://github.com/jdranczewski/dataset-suite-pip

Parts of this code were created as part of PhD work supported by the EU ITN EID project CORAL (GA no. 859841).

Installation

You can install this package from pip:

pip install dataset-suite

Once installed, all useful functions are in the top-level module:

import dataset_suite as ds

Basic usage

A short introduction to using the library:

import dataset_suite as ds

# Create a dataset out of a set of spectra
data = ds.dataset(
    array,
    index=np.arange(array.shape[0]) # A basic numerical index
    wavelength=spectrometer.wavelength # You can store a numpy array as an axis descriptor
    # alongside your data. This way you know that the second axis of this dataset is a
    # "wavelength", and what wavelength corresponds to each datapoint
)
data.metadata["comment"] = "afternoon spectra"
# Save the dataset to a HDF5 file
data.save_h5("file.h5")
# Load a dataset from a file
data = ds.load_h5('file.h5')
# inspect the dataset - what axes does it have?
print(data)
# dataset(index[10], wavelength[100])

data.raw # access the underlying numpy array
data.wl # use axis names as attributes to get the values for a given axis,
#         like wavelength here
data.wl[10] # this is the wavelength corresponding to the 10th column of the array
data.take(index=5) # slice along the index axis: dataset(wavelength[100])
data.take_sum("wavelength") # sum along the wavelength axis: dataset(index[10])
data.metadata # dictionary of measurement metadata

The library also includes some convenient helpers like a function mapping values to colours using matplotlib colormaps, and a number of filename search/analysis tools. Have a look at https://dataset-suite.readthedocs.io/en/latest/api.html

Development Status
- 3 - Alpha
License
- OSI Approved :: Apache Software License
Operating System
- OS Independent
Programming Language
- Python :: 3

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dataset_suite-0.4.0.tar.gz (126.3 kB view details)

Uploaded Sep 16, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

dataset_suite-0.4.0-py3-none-any.whl (10.1 kB view details)

Uploaded Sep 16, 2026 Python 3

File details

Details for the file dataset_suite-0.4.0.tar.gz.

File metadata

Download URL: dataset_suite-0.4.0.tar.gz
Upload date: Sep 16, 2026
Size: 126.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for dataset_suite-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`68e748268d2a04dfe7841ed8a933a3afde6e810704158585f4ca2256e540bd39`
MD5	`5c6a8b24d8c95bf9921d637f483567fd`
BLAKE2b-256	`2f60c76b3afb6307e3f54d5b96fda15af0b51d22259dd6d6dc30af4e47ee16af`

See more details on using hashes here.

Provenance

The following attestation bundles were made for dataset_suite-0.4.0.tar.gz:

Publisher: python-publish.yml on jdranczewski/dataset-suite-pip

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: dataset_suite-0.4.0.tar.gz
- Subject digest: 68e748268d2a04dfe7841ed8a933a3afde6e810704158585f4ca2256e540bd39
- Sigstore transparency entry: 2862742185
- Sigstore integration time: Sep 16, 2026
Source repository:
- Permalink: jdranczewski/dataset-suite-pip@7e215a3ae63eba564bd5deb5f7a8f5f016b9d6dc
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/jdranczewski
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-publish.yml@7e215a3ae63eba564bd5deb5f7a8f5f016b9d6dc
- Trigger Event: release