kub-dataset

kub-dataset is the main CLI for managing KUB datasets.

It covers four domains:

  • Location datasets: cemdb/locations/<location>/vX.Y.Z

  • Simulator datasets: cemdb/simulators/vX.Y.Z

  • DVC/authentication workflows for reproducible pulls and publication

  • Advanced maintenance (migration, manifests, component-level operations)

1. Split Documentation

This page is intentionally short. Use the focused pages below:

2. Global Synopsis

kub-dataset [-h] [-v] <command> [options]

3. Quick Start

# List available datasets on all configured DMPs
kub-dataset list-locations

# Pull one location dataset locally
kub-dataset pull kernante --version 0.98.0 --api-key $GIRDER_API_KEY

# Summarize local datasets
kub-dataset summary --all --cemdb-root cemdb/locations

# Check DVC tracking state (after kub-dataset init / pull --dvc)
kub-dataset status

4. Command Families

Family Typical Commands

Location datasets

pack, unpack, list, list-dmps, list-locations, push, pull, delete, list-versions, summary, generate, manifest-, fix, policy, migrate*, copy-version, rename-*, set-current, duplicate

Simulator datasets

generate simulator, pack-simulator, unpack-simulator, push-simulator, pull-simulator, list-simulators, list-simulator-versions, delete-simulator

DVC and auth

init, status, login, logout, whoami, plus pull --dvc and pull-simulator --dvc

Component-level and references

push-component, pull-component, list-components, tag-reference, list-reference

5. See Also