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: 4 months 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 (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-04-18T13:20:11.000Z (about 1 year ago)
- Last Synced: 2025-04-19T02:25:17.365Z (about 1 year 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
- awesome-mri-physics - BIDS
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 Baker
💻 🔧
Cody C Baker
💻 📖
Cyril Pernet
💬 📝 📖 🎨 💡 📋 🤔 📢
Cyrus Eierud
📖
D. Sturgeon
💻
Dan Brady
💻 ⚠️
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