Get involved in making BIDS better

The easiest way to contribute to BIDS is to ask questions you have about the specification on Neurostars. If your question has a bids tag it will be much easier for others to find the answer.

You can also get involved by answering questions on Neurostars!

You can contribute to the BIDS specification by opening Issues and propose changes via Pull Requests on GitHub.

To make improvements to the website that you are reading right now, you can also open an Issue and propose changes via Pull Requests at its GitHub repository.

There are so many ways to help us build this community. You could help someone else learn the benefits of BIDS, give a talk in your local organisation, or build a BIDS App!

The only requirement is that everyone who contributes adheres to our BIDS Code of Conduct.

Thank you for your contributions!

Extending the BIDS specification

The BIDS specification can be extended in a backwards compatible way and will evolve over time. These are accomplished with BIDS Extension Proposals (BEPs), which are community-driven processes.

Do you want to extend BIDS to a new modality or set of data types? Please draft a BIDS Extension Proposal (BEP) following the BIDS Extension Proposals Guide.

You can also contribute to ongoing BIDS Extension Proposals. Below is a table of currently-active BEPs. The “Extension label” column provides a direct link to the documentation.

Please find our latest BEP update presented in the Open Science Room at OHBM.

Note that all of the extension ideas that are not backwards compatible and thus will have to wait for BIDS 2.0 are listed here.

Extension label Title Moderators/ leads Summary Blocking point(s)
BEP002 The BIDS Models Specification Tal Yarkoni Recently went through and removed several sections. Resolving remaining comments and adding examples.
BEP004 Susceptibility Weighted Imaging (SWI) Available Looking for a new leader. Searching for a new leader.
BEP011 The structural preprocessing derivatives Viviana Siless Opened the pull request. Need to conform with final Common Derivatives and gather community feedback. None.
BEP012 The functional preprocessing derivatives Camille Maumet and Chris Markiewicz Opened the pull request. Need to conform with final Common Derivatives and gather community feedback. None.
BEP013 The resting state fMRI derivatives Steven Giavasis Merged into BEP012. None.
BEP014 The affine transformations and nonlinear field warps Oscar Esteban A new file format (X5) to store spatial transforms is being created, and a draft proposal has been discussed under the scope of this BEP. There is a software prototype - NiTransforms demonstrating the implementation of this BEP. NiTransforms prototype is thoroughly tested. In progress.
BEP016 The diffusion weighted imaging derivatives Franco Pestilli and Oscar Esteban Being discussed in a GitHub repository. Discussions related to this BEP will enable it to progress. Coordinating with BEP017.  
BEP017 Generic BIDS connectivity data schema Eugene Duff and Paul McCarthy This BEP is searching for a reviewer with fresh eyes that understands the scope of this BEP. Coordinating with BEP016. None.
BEP019 DICOM Metadata Satrajit Ghosh Not active. Could be a NIDM extension rather than in BIDS. None.
BEP020 Eye Tracking including Gaze Position and Pupil Size(ET) Benjamin Gagl and Dejan Draschkow BEP is close to being submitted as a pull request. Examples and validator are under development. None.
BEP021 Common Electrophysiological Derivatives Mainak Jas, Stefan Appelhoff, Cyril Pernet, Robert Oostenveld Discussions held in a GitHub repository  
BEP022 Magnetic Resonance Spectroscopy (MRS) Mark Mikkelsen and William Clarke Group discussions underway. Developing a NifTI standard for MRS data - submitted an ISMRM abstract. Resuming BEP development following their NifTI standard.  
BEP023 PET Preprocessing derivatives Martin Noergaard, Graham Searle, Melanie Ganz Work is paused until BEP009 has been incorporated into the specification. A blocking item is the need for more contributors, especially from senior PET experts.
BEP024 Computed Tomography scan (CT) Hugo Boniface Lead seeking more contributors and experts. None.
BEP025 Medical Imaging Data structure (MIDS) Jose Manuel Saborit Torres, Maria de la Iglesia Vayá Enhancing the BEP025 preprint. Have an automated tool to convert projects uploaded to XNAT platforms to BIDS/MIDS. They have three example datasets: Massive Image Data Anatomy Spine, BIMCV-COVID19+, and BIMCV-COVID19- None.
BEP026 Microelectrode Recordings (MER) Greydon Gilmore Active effort. Looking for thoughts and contributions. None.
BEP027 BIDS Execution Chris Markiewicz and Greg Kiar Focusing on: command-line conventions, I/O interface descriptors, and common behavior (e.g., exit codes for failure modes). None.
BEP028 Provenance Satra Ghosh and Camille Maumet BEP is developing with dicussions held in their repository. A set of examples and user stories are currently being refined. None.
BEP029 Virtual and physical motion data Sein Jeung and Julius Welzel BEP is developing and starting to finalize. Example datasets are starting to be created. None.
BEP030 Near Infrared Spectroscopy (NIRS) Robert Luke and Luca Pollonini BEP presented at the society for fNIRS conference. BEP has gathered community feedback and is currently incorporating them into the BEP. None.
BEP031 Microscopy Marie-Hélène Bourget and Julien Cohen-Adad BEP has developed with great community feedback. BEP is starting to finalize. None.
BEP032 Animal electrophysiology Sylvain Takerkart and Julia Sprenger New BEP, actively looking for contributors and community input. Comments may be submitted directly on the document or their GitHub page None.
BEP033 Advanced Diffusion Weighted Imaging (aDWI) James Gholam, Leandro Beltrachini and Filip Szczepankiewicz New BEP, actively looking for contributors and community input. Comments may be submitted directly on the document. None.

Completed BEPs

When an extension reaches maturity it is merged into the main body of the specification. Below is a table of BEPs that have been merged in the main body of the specification.

Extension label Title Moderators/leads
BEP001 Structural acquisitions that include multiple contrasts (multi echo, flip angle, inversion time) sequences Gilles de Hollander and Kirstie Whitaker
BEP003 Common Derivatives Chris Markiewicz
BEP005 Arterial Spin Labeling (ASL) Henk-Jan Mutsaerts, Patricia Clement, Jan Petr, Marco Castellaro
BEP006 Electroencephalography (EEG) Cyril Pernet, Stefan Appelhoff, Robert Oostenveld
BEP007 Hierarchical Event Descriptor (HED) Tags Chris Gorgolewski
BEP008 Magnetoencephalography (MEG) Guiomar Niso
BEP009 Positron Emission Tomography (PET) Melanie Ganz
BEP010 intracranial Electroencephalography (iEEG) Chris Holdgraf, Dora Hermes
BEP018 Genetic information Cyril R Pernet, Clara Moreau, Thomas Nichols

Some proposals that set out to extend the BIDS specification have instead become tools for handling BIDS. See the table below.

Extension label Title Moderators/leads Tool name
BEP015 Mapping file Eric Earl, Camille Maumet, and Vasudev Raguram File mapper