datalad-create-test-dataset - Man Page

create test (meta-)dataset.

Synopsis

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

Options

path

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

-h,  --help,  --help-np

show this help message. --help-np forcefully disables the use of a pager for displaying the help message

--spec SPEC

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 SEED

seed for rng. Constraints: value must be convertible to type 'int' or value must be NONE

--nfiles NFILES

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

--version

show the module and its version which provides the command

Authors

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

Info

2026-07-27 datalad create-test-dataset 1.6.1