CADET-RDM
CADET-RDM is a Research Data Management toolbox developed at Forschungszentrum Jülich. It supports computational research projects by tracking code, data, environments, and generated results in a reproducible and shareable way.
The toolbox is domain-agnostic and can be applied to any computational project with a structured workflow.
Scope and purpose
CADET-RDM helps manage and version
- input data
- source code
- configurations and metadata
- software and environment versions
- generated output data
The primary goal is to ensure reproducibility, traceability, and reuse of computational results by explicitly linking them to the project state that produced them.
Repository structure
A CADET-RDM project consists of two independent but coupled Git repositories:
-
Project repository Contains source code, configuration files, documentation, and metadata required to execute the computations.
-
Output repository Contains the results generated by running the project code, including data products, models, figures, and run-specific metadata.
Both repositories have separate Git histories and remotes. CADET-RDM provides workflows that operate on both repositories to maintain a consistent link between code and results.
Using CADET-RDM
Result tracking and reproducibility
Each execution of project code creates a new output branch that contains only the files generated by that run.
In addition, a central run history records
- the project repository commit used for the run
- software and environment information
- metadata required to reproduce the result
This commit structure allows results to be reproduced and inspected without manual bookkeeping.
Interfaces
CADET-RDM can be used through
- a command line interface (CLI), e.g. for scripted or automated bash workflows
- a Python interface, e.g. for direct context tracking of code within existing Python workflows
Additionally, CADET-RDM can be used within Jupyter Lab with some limitations.
Detailed descriptions of commands and APIs are provided in the dedicated interface documentation.
Typical workflow
- Initialize or clone a CADET-RDM project
- Develop and commit project code
- Execute computations with CADET-RDM result tracking
- Generate versioned output branches automatically
- Push project and output repositories to their remotes
- Reuse or reference results via their output branches
The links between the project and output repositories are kept up to date by every commit made through CADET-RDM.
For commits made with plain git, an optional pre-commit hook, rdm-check, does the same; see the command line interface documentation.
Results are referenced by unique output branch names that encode the timestamp, active project branch, and project commit hash, followed by a random suffix. CADET-RDM provides a local cache mechanism that allows results from previous runs or from other CADET-RDM projects to be reused as input data while preserving provenance information.
Getting started
The full documentation is available at https://cadet-rdm.readthedocs.io
It includes installation instructions, usage guides for the different interfaces, and detailed descriptions of repository and result management workflows.
Project information
- License: see LICENSE
- Contributing: see CONTRIBUTING
- Authors and contributors: see AUTHORS
2 maintainers
Metadata
2 maintainers
Release files for CADET-RDM 1.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cadet_rdm-1.2.0.tar.gz | 80.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cadet_rdm-1.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 147.4 kB
Release files / cadet_rdm-1.2.0.tar.gz
| Download URL | cadet_rdm-1.2.0.tar.gz |
|---|---|
| Size | 80.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f84a811c42fe8bf97aaa39320ed18130c1ff8dc7b1a4721bfdfe1dbc883b0501
|
|
BLAKE2b-256 checksum How to use checksums |
1d9f75e5e9c234bbe4191642f444a3f01cfe3bc0cbda403be8dc59e8aa433abe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 5, 2026.
Transparency logRelease files / cadet_rdm-1.2.0-py3-none-any.whl
| Download URL | cadet_rdm-1.2.0-py3-none-any.whl |
|---|---|
| Size | 67.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f3096b755a1236e5cfd9e88b151548b4e8668346bbbe8e4ce3f7ac3e23f9e5f3
|
|
BLAKE2b-256 checksum How to use checksums |
a76792b5ea3f0826f1de50e958bbee46499a712e9764c79135f197c949c49c72
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 5, 2026.
Transparency log
