https://github.com/bids-standard/bids-specification
Brain Imaging Data Structure (BIDS) Specification
https://github.com/bids-standard/bids-specification
bids data-standards neuroimaging standards
Last synced: 5 days ago
JSON representation
Brain Imaging Data Structure (BIDS) Specification
- Host: GitHub
- URL: https://github.com/bids-standard/bids-specification
- Owner: bids-standard
- License: cc-by-4.0
- Created: 2018-09-26T17:35:34.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2025-04-18T13:20:11.000Z (6 months ago)
- Last Synced: 2025-04-19T02:25:17.365Z (6 months ago)
- Topics: bids, data-standards, neuroimaging, standards
- Language: Python
- Homepage: https://bids-specification.readthedocs.io/
- Size: 14.2 MB
- Stars: 304
- Watchers: 35
- Forks: 177
- Open Issues: 337
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Citation: CITATION.cff
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
[](https://github.com/bids-standard/bids-specification/actions/workflows/validation.yml)
[](https://circleci.com/gh/bids-standard/bids-specification)
[](https://bsky.app/profile/bidsstandard.bsky.social)

[](https://fosstodon.org/@bidsstandard)
[](https://x.com/BIDSstandard)
[](https://doi.org/10.5281/zenodo.10175845)
![]()
The [Brain Imaging Data Structure (BIDS)](https://bids.neuroimaging.io) is an emerging standard for the
organization of neuroimaging data.In this repository, we develop the
[BIDS specification](https://bids-specification.readthedocs.io/en/latest/).# When to use BIDS
To organize your data in BIDS, all you need is neuro data, a computer, and the
[BIDS specification](https://bids-specification.readthedocs.io/en/stable/).BIDS currently supports the following data modalities with
[more to come in the future](https://bids.neuroimaging.io/extensions/index.html):- MRI
- MEG
- EEG
- iEEG
- behavioral
- physiological
- PET
- microscopy
- NIRS
- motion
- MRS# Formatting your data with BIDS
As a dataset curator, the GitHub repository and all files therein can be safely ignored.
Users should focus on [the rendered content](https://bids-specification.readthedocs.io/en/stable/).
The specification is provided in the form of a webpage, built using
[MkDocs](https://www.mkdocs.org/) and [Read the Docs](https://readthedocs.org/).*Want to learn more about working with BIDS? Have a question, comment, or suggestion?*
1. Read some introductory material, most likely the very basic problems have already been addressed!
- [BIDS Starter Kit](https://github.com/bids-standard/bids-starter-kit) for tutorials, wikis, templates, ...
2. Post your question in one of several channels where BIDS members are active
- see: [BIDS communication channels](#bids-communication-channels)# Contributing to BIDS
BIDS is a community-driven standard, and it depends on contributions from its members.
We welcome new contributors, and we appreciate all contributions to the project!For a current list of our contributors, please see our [Contributors appendix](https://github.com/bids-standard/bids-specification/blob/master/src/appendices/contributors.md).
When you're ready to get started, check out [our contributing guidelines](https://github.com/bids-standard/bids-specification/blob/master/CONTRIBUTING.md).
We ask that all contributions to BIDS across all project-related spaces
(including but not limited to:
[GitHub](https://github.com/bids-standard), and the
[Google group](https://groups.google.com/forum/#!forum/bids-discussion); see
[BIDS communication channels](#bids-communication-channels))
adhere to our [code of conduct](https://github.com/bids-standard/bids-specification/blob/master/CODE_OF_CONDUCT.md).# BIDS communication channels
## Main communication channels
- "Issue" pages on the different GitHub repositories of the [`bids-standard` GitHub organization](https://github.com/bids-standard),
such as the [BIDS specification repository](https://github.com/bids-standard/bids-specification/issues),
for reporting problems or making suggestions
- The [NeuroStars Discourse forum](https://neurostars.org/tags/bids), for asking usage questions
- The [BrainHack Mattermost](https://mattermost.brainhack.org), for instant messaging
(see also this [news item](https://bids.neuroimaging.io/blog/2020/06/24/Join%20the%20BIDS%20community%20on%20the%20BrainHack%20Mattermost.html))
- The [Google group](https://groups.google.com/forum/#!forum/bids-discussion), for broader discussions and announcements surrounding BIDS
- The [BIDS website "blog"](https://bids.neuroimaging.io/blog/index.html), similar to the Google group, for broader discussions and announcements## Social media channels
- [X](https://x.com/BIDSstandard)
- [Mastodon](https://fosstodon.org/@bidsstandard)
- [Bluesky](https://bsky.app/profile/bidsstandard.bsky.social)
- [Youtube](https://www.youtube.com/channel/UCxZUcYfd_nvIVWAbzRB1tlw)
- [Instagram](https://www.instagram.com/bidsstandard/)## Contributors
Thanks goes to these wonderful people.
Aaron Oliver-Taylor
π
Adam Li
π π»
Adam Thomas
π
Adeen Flinker
π
Adina S. Wagner
π¨ π»
Agah Karakuzu
π¬ π π£ π€ π»
Agnese Zazio
π
Aki Nikolaidis
π
Alberto Lazari
π
Alejandro de la Vega
π π» β οΈ
Alessio Giacomel
π
Alex Rockhill
π π§ π»
Alexander Jones
π» π
Alexander L. Cohen
π π» π π¬
Alexander von Lautz
π
Alexandre D'Astous
π π»
Alexandre Gramfort
π π‘
Alexandre Hutton
π
Alexandre Routier
π
Alexandru Foias
π π£
Ali Khan
π
Alizee Wickenheiser
π§
Alyssa Dai
π»
Amber R. Hopkins
π
Ana Fouto
π
Anders Eklund
π π’ π»
Andrea Pigorini
π
Andrew Hoopes
π
Andrew Jahn
π
Andrew Janke
π π»
Anibal SΓ³lon
π» π
Anthony Galassi
π π»
Arianna Sala
π
Ariel Rokem
π π»
Arjen Stolk
π
Arman Jahanpour
π»
Arnaud Delorme
π π‘ π€
Arnaud Marcoux
π
Arshitha Basavaraj
π π π»
Ashley G. Gillman
π
Athanasia Monika Mowinckel
π
Augustijn Vrolijk
π» π
Aysegul Gunduz
π
Azeez Adebimpe
π
B. Nolan Nichols
π
Balint Kincses
π
Benjamin Beasley
π π»
Benjamin Dichter
π π» β οΈ
Benjamin Gagl
π
Bertrand Thirion
π
Boris ClΓ©net
π π»
Bradley Voytek
π
Brent McPherson
π»
Brett L. Foster
π
Brian A. Wandell
π
Brian N. Lundstrom
π
Camille Maumet
π
Carlo Miniussi
π
Cecile Madjar
π£ π§
ChloΓ© Pasturel
π
Chris Benjamin
π
Chris GahnstrΓΆm
π
Chris Holdgraf
π π€ π»
Chris J. Gorgolewski
π π» π¬ π€ π π’ π π‘ π
Chris Rorden
π π»
Christian BΓΌchel
π
Christian Horea
π» π
Christine Rogers
π£ π π€ π π§ π»
Christophe Phillips
π
Christopher G. Schwarz
π»
Christopher J. Honey
π
Christopher J. Markiewicz
π¬ π π» π π¨ π‘ π€ π π π§ π’ π£ π π§
Christopher Lee-Messer
π
Clara Moreau
π
Clint Hansen
π π€
Cody C Baker
π» π
Cyril Pernet
π¬ π π π¨ π‘ π π€ π’
Cyrus Eierud
π
D. Sturgeon
π»
Dan Levitas
π
Dan Lurie
π€ π π§ π π» π¬
Daniel A. Handwerker
π
Daniel McCloy
π
David Alsop
π
David Boas
π
David Groppe
π
David Keator
π
David McAlpine
π
David Thomas
π π£
Dejan Draschkow
π
Desmond Oathes
π
Dianne Patterson
π
Dimitri Papadopoulos Orfanos
π π‘ π€ π¬ π»
Dmitry Petrov
π π»
Dora Hermes
π π» β π π€
Dorien Huijser
π
Dorota Jarecka
π» π
Douglas N. Greve
π
Duncan Macleod
π π
Dung Truong
π π» π§ π€
Dustin Moraczewski
π
Dylan Nielson
π π» π§
Eduard Ort
π π»
Eleonora Marcantoni
π
Elizabeth Bock
π π‘
Elizabeth DuPre
π π‘ π π€ π¬ π»
Elke Warmerdam
π£ π
Erdal Karaca
π»
Eric A. Earl
π π¬ π π§ π§ π€ π»
Eric Achten
π π£ π
Eric Bridgeford
π π§
Erin W. Dickie
π π€ π π’ π¬ π»
Ethan Blackwood
π π
Eugene P. Duff
π
Ezequiel Mikulan
π π»
Fede Raimondo
π»
Felipe Orihuela-Espina
π
Fidel Alfaro Almagro
π¬ π π‘ π
Filip Szczepankiewicz
π
Filippo Maria Castelli
π π£
Franco Pestilli
π π» π¨ π‘ π€ π π§ π π π π’
Franklin W. Feingold
π π β π¬ π€ π¨ π’ π π π π π»
FranΓ§ois Tadel
π π π‘
Friederike Breuer
π
Gaia Rizzo
π
Gang Chen
π
GaΓ«l Varoquaux
π
Ghislain Vaillant
π»
Giacomo Bertazzoli
π
Giacomo Guidali
π
Giacomo Mazzamuto
π π£
Gilles de Hollander
π
Gio Piantoni
π
Giovanna Nordio
π
Gitte M. Knudsen
π
Giulio Castegnaro
π
Giuseppe Gallitto
π
Graham Searle
π
Granville J. Matheson
π
Gregory Kiar
π π» π¨ π§
Gregory Noack
π π» β οΈ
Greydon Gilmore
π π»
Guillaume Flandin
π π»
Guiomar Niso
π€ π¨ π π π π π§ π π» π£ β π¬ π π‘ π’
Gunnar Schaefer
π
Gustav Nilsonne
π
Hamish Innes-Brown
π
Hanne D. Hansen
π
Hanzhang Lu
π
Hao-Ting Wang
π π
Helena Cockx
π π€ π¬
Henk Mutsaerts
π¬ π π» π π‘ π π€ π π’ π
Hernando Ombao
π
Hugo Boniface
π π»
Ilkay Isik
π
Ilona Lipp
π
International Neuroinformatics Coordinating Facility
π΅ π
Iris Groen
π
Isaac To
π»
Isla Staden
π
Jaap von der Aar
π
Jacob Sanz-Robinson
π»
Jakub Kaczmarzyk
π π§ π
James Gholam
π
James Kent
π¬ π»
Jan Mathijs Schoffelen
π
Jan Petr
π¬ π π» π π£ π‘ π π€ π β οΈ π’
Jan Valosek
π»
Jan-Mathijs Schoffelen
π
Jean-Baptiste Poline
π π’ π€ π¨ π»
Jean-Charles Mariani
π π€
Jean-Christophe Houde
π π»
Jean-Dominique Gallezot
π
Jean-Philippe Lachaux
π
Jeanette Mumford
π
Jefferson Casimir
π§ π» π£ π
Jeffrey G. Ojemann
π
Jeffrey S. Grethe
π¬ π β π’ π»
JegouA
π»
Jelle Dalenberg
π
Jeremy Moreau
π π‘
Jessica A. Turner
π
Jochem Rieger
π
John Detre
π
John Pellman
π
John T. Wodder
π»
Joke Durnez
π π§ π»
Jon Haitz Legarreta GorroΓ±o
π» π
Jonathan C. Lau
π
Jonathan Winawer
π
Joost Kuijer
π
Jose Manuel Saborit
π
Joseph Wexler
π π‘
Joseph Woods
π
Julia Guiomar Niso GalΓ‘n
π€ π¨ π π π π π§ π π» π£ β π¬ π π‘ π’
Julia Sprenger
π
Julia-Katharina Pfarr
π» π π§ π‘
Julien Cohen-Adad
π π£ π€
Julio C Hernandez Pavon
π
Julius Welzel
π π‘ π π» π£ π€ π¬ π
JΓ©rΓ©mie Fouquet
π»
Kabilar Gunalan
π»
Kai J. Miller
π
Kangjoo Lee
π
Katja Heuer
π§
Kay Robbins
π» π π
Kevin Larcher
π¬
Kimberly Ray
π π π€ π
Kirstie Whitaker
π π‘ π π€ π’ π¬ π»
Klara Gregorova
π
Klaus Gramann
π π€
Kris Thielemans
π
Kristofer Bouchard
π
Kurt Schilling
π
Laetitia Fesselier
π§
Laura and John Arnold Foundation
π΅
Leandro Beltrachini
π
Lee Kamentsky
π
Lennart Walger
π
Lennart Wittkuhn
π
Liberty Hamilton
π
Luca Pollonini
π
Luis Hernandez-Garcia
π π
Luke J. Edwards
π π¬ π»
Lyuba Zehl
π
Mainak Jas
π π»
Mana Biabani
π
Manjari Narayan
π
Manuel Mercier
π π€
Maqsood Yaqub
π
Marc Lalancette
π π»
Marco Castellaro
π¬ π π» π π‘ β οΈ π’ π
Maria Ermolova
π
Maria de la Iglesia
π
Marie-Hélène Bourget
π π£ π» π€
Mark Mikkelsen
π π» π£ π
Markus Morawski
π
Marta Bortoletto
π
Martin Craig
π£
Martin Noergaard
π π£ π» π€ π’
Martin Szinte
π
Martin Wilson
π
Martina Bulgari
π
Mateusz Pawlik
π π π€ π§ π π»
Mathias Goncalves
π» π§ π’
Mathieu Boudreau
π¬ π€ π’
Mathieu DugrΓ©
π»
Mathieu Guay-Paquet
π π»
Matt Cieslak
π»
Matt Sanderson
π π»
Matt Stead
π»
Matteo Tonietto
π
Matthias GΓΌnther
π
Matthias Van Osch
π
Matthieu Chourrout
π»
Mattia Veronese
π
Maureen J Shader
π
Maurice Pasternak
π
Max A. van den Boom
π» π π π
Melanie Ganz-Benjaminsen
π π£ π» π€ π π π’
Melissa Kline Struhl
π
Michael Chappell
π π£ π
Michael Firbank
π»
Michael Hanke
π π€ π§ π π’
Michael P. Harms
π β οΈ π§
Michael P. Milham
π‘ π
Michael P. Notter
π¬ π β π’ π
Michael Schirner
π
Michelle Wang
π»
MikaΓ«l Naveau
π
Mohammad Torabi
π»
Monique Denissen
π π»
Murat Bilgel
π
Nader Pouratian
π
Natalia Petridou
π
Natalie Rotstein
π
National Institute of Mental Health
π΅
Nell Hardcastle
π» π π€ π π π¬
Nicholas Holmes
π
Nicholas Traut
π π§ π»
Nick F. Ramsey
π
Nick Guenther
π»
Nicole C. Swann
π
Nigel Rogasch
π
Nikhil Bhagwat
π»
Nikita Beliy
π
Nima Bigdely Shamlo
π
Olivier David
π
Orrin Devinsky
π
Oscar Esteban
π π§ π€ π¬ π»
Pamela LaMontagne
π π‘
Parul Sethi
π π§ β οΈ π»
Patricia Clement
π¬ π π» π π£ π‘ π π€ π β οΈ π’
Patrick Park
π π‘ π¬ π»
Paule-Joanne Toussaint
π
Peer Herholz
π¬ π π π§ β π’
Petra Ritter
π
Pierre Rioux
π
Pieter Vandemaele
π π»
Pradeep Reddy Raamana
π» π§
Qian Chu
π»
R. Cameron Craddock
π π’
Remi Gau
π π» π¬ π’ π π» π π π§ π€
Richard HΓΆchenberger
π π»
Richard N. Henson
π
Robert B. Innis
π
Robert E. Smith
π» π
Robert Knight
π
Robert Luke
π»
Robert Oostenveld
π π§ π’ π‘ β β οΈ π€ π¬ π π π» π π£ π¨ π π π π πΉ
Roberto Guidotti
π
Roberto Toro
π§
Rohan Goyal
π
Ross W. Blair
π»
Russell A. Poldrack
π π π’
RΓ©mi Adon
π
Samir Das
π
Samuel Garcia
π€ π π
Samuel Guay
π
Samuel Le Meur-Diebolt
π π€
Samuel Nastase
π»
Sara Elgayar
π
Sasha D'Ambrosio
π
Satrajit S. Ghosh
π π»
Scott Makeig
π
Sebastian Urchs
π» π π€
Sein Jeung
π π‘ π π» π£ π€ π¬ π§ π
Seyed Yahya Shirazi
π π€ π»
Shashank Bansal
π
Silvia Isabella
π
Sjoerd B. Vos
π
Soichi Hayashi
π π§ π
Stefan Appelhoff
π π¬ π€ π π‘ π» π β οΈ π’ β π§ π π π§ π£
Stefanie De Smet
π
Stephan Bickel
π
Steven Meisler
π π» π¬ π§ π
Suyash Bhogawar
π π‘ β οΈ π§ π¬
Sylvain Baillet
π π
Sylvain Takerkart
π
SΓ©bastien Tourbier
π€ π π’ π π» π
SΓΆren Grothkopp
π π£ π
Tal Pal Attia
π
Tal Yarkoni
π» π π€ π π π π’ π π¨
Tamas Spisak
π
TamΓ‘s JΓ³zsa
π
Taylor Khuhn
π
Taylor Salo
π¬ π π π»
Teon L. Brooks
π π» β οΈ π¬ π π€ π§ π π’
Thomas Deffieux
π π€
Thomas E. Nichols
π π’ π§ π π§ π»
Thomas Funck
π
Thomas Kirk
π
Thomas Okell
π
Tibor Auer
π¬ π π‘ π§ π’ π π€
Til Ole Bergmann
π
Timo Dickscheid
π
Timotheus Berg
π π€ π
Tobey Betthauser
π
Tobias Bengfort
π»
Tom Hampshire
π
Tor Wager
π
Torsten StΓΆter
π
Travis Riddle
π π§ π
Tristan Glatard
π π»
Tyler Collins
π£ π§
Ulrike Bingel
π
Vanessa Sochat
π
Vasudev Raguram
π» π¨ π π§
Victor H. Souza
π
Vince D. Calhoun
π
Vittorio Iacovella
π
Viviana Siless
π
Vladimir Litvak
π
Wietske van der Zwaag
π£ π¬
William Clarke
π
William Triplett
π
Wouter V. Potters
π» π
Xiangrui Li
π π»
Yaroslav O. Halchenko
π π’ π§ π¬ π π» π£ π π€ π π π π
YaΓ«l Balbastre
π»
Yoni Ashar
π
Yuan Wang
π»
Zachary Michael
π
Zhi-De Deng
π
ezemikulan
π»
josator2
π»
monkeyman192
π»
patrick-g-h
π»
tstoeter
π»
Γtienne Bergeron
π£ π»