Skip to content

Integration with other standards

This standard describes the contents of a BIDS Stats Model document. Here we discuss the relationship of this standard to other standards.

The Brain Imaging Data Structure (BIDS)

The models described by this standard are intended to supplement datasets structured according to the Brain Imaging Data Structure (BIDS) standard. BIDS describes the naming and organization of neuroimages, task events and timing parameters. A BIDS Stats Model will use variables extracted from BIDS tabular files, filename components (for example, "task"), and possibly metadata extracted from JSON "sidecars", but otherwise has no strong dependence on the BIDS standard.

Naming of BIDS Stats Models files in BIDS datasets

The location and naming scheme were not specified in BIDS at the time of this writing, but this may have changed since publication. See the latest version of BIDS at https://bids-specification.readthedocs.io. Until these conventions are established in BIDS, it is RECOMMENDED to use the following:

Template:

models/model-<label>_[desc-<description>]_smdl.json

Examples:

models/model-nback_desc-preprint_smdl.json
models/model-nback_desc-postreview_smdl.json
models/model-nonwordrepetition_smdl.json

The smdl suffix stands for "statistical model".

BIDS Derivatives

BIDS Stats Models does not prescribe naming conventions for the outputs of estimators implementing the BIDS Stats Models specification. We recommend using following the BIDS Derivatives specification to the extent possible.

NIDM-Results

The purpose of BIDS Stats Models is prescriptive, essentially a recipe for how to fit a model, rather than a description of a model that was already fit. NIDM-Results describes the results of modeling, and does not conflict with BIDS Stats Models.