Scroll to navigation

datalad create-test-dataset(1) General Commands Manual datalad create-test-dataset(1)

NAME

datalad create-test-dataset - create test (meta-)dataset.

SYNOPSIS

datalad create-test-dataset [-h] [--spec SPEC] [--seed SEED] [--nfiles NFILES] [--version] path

OPTIONS

path/name where to create (if specified, must not exist). Constraints: value must be a string or value must be NONE

show this help message. --help-np forcefully disables the use of a pager for displaying the help message
spec for hierarchy. Each level is separated by ``/`` and has the form ``[d]min[-max][+Nf]``. ``min-max`` defines how many (random from min to max) sub-datasets to generate at that level (min can be omitted to assume 0). Prefix ``d`` makes entries plain directories instead of subdatasets (e.g. ``d3`` creates 3 dirs with files). Suffix ``+Nf`` creates N tracked files per entry at that level (overrides --nfiles for that level). Examples:: 1-3/-2 1–3 subdatasets at L1, up to 2 at L2 2+100f/-2 2 subs at L1 each with 100 files, up to 2 at L2 10/d5+50f 10 subs, each containing 5 plain dirs with 50 files. Constraints: value must be a string or value must be NONE
seed for rng. Constraints: value must be convertible to type 'int' or value must be NONE
number of files to create in each dataset (default 1). Per-level +Nf suffix in spec overrides this. Constraints: value must be convertible to type 'int' or value must be NONE
show the module and its version which provides the command

AUTHORS


datalad is developed by The DataLad Team and Contributors <team@datalad.org>.

2026-10-01 datalad create-test-dataset 1.6.5