Skip to content

Latest commit

 

History

History
153 lines (122 loc) · 23.7 KB

README.md

File metadata and controls

153 lines (122 loc) · 23.7 KB

.github/workflows/build-test-deploy.yml codecov DOI PyPI version Conda version

Python BIDS-Validator

This is a library of helper functions written in Python, for use with BIDS compliant applications written in this language.

The main function determines if a file path is compliant with the BIDS specification.

Installation

To install with pip:

python -m pip install bids_validator

To install with conda:

conda install bids-validator

Quickstart

  1. Open a Python terminal and type: python
  2. Import the BIDS Validator package from bids_validator import BIDSValidator
  3. Check if a file is BIDS compatible BIDSValidator().is_bids('/relative/path/to/a/bids/file')
  4. Note, the file path must be relative to the root of the BIDS dataset, and a leading forward slash / must be added to the file path.

Example

from bids_validator import BIDSValidator

validator = BIDSValidator()

filepaths = ["/sub-01/anat/sub-01_rec-CSD_T1w.nii.gz", "/sub-01/anat/sub-01_acq-23_rec-CSD_T1w.exe"]
for filepath in filepaths:
    print(validator.is_bids(filepath))  # will print True, and then False

Note, the file path must be relative to the root of the BIDS dataset, and a leading forward slash / must be added to the file path.

Acknowledgments

Many contributions to the bids-validator were done by members of the BIDS community. See the list of contributors.

A large part of the initial development of bids-validator was done by Squishymedia, who are in turn financed through different grants offered for the general development of BIDS. See the list below.

Development and contributions were supported through the following federally funded projects/grants:

Maintainers and Contributors

All Contributors

This project follows the all-contributors specification. Contributions of any kind are welcome!

The project is maintained by @rwblair with the help of many contributors listed below. (The emoji key is indicating the kind of contribution)

Please also see Acknowledgments.


Adam Li

💻 ⚠️ 📓 🐛

Adam Thomas

📖

Alexander Jones

💻 ⚠️ 🤔

Ben Beasley

📦

Chris Gorgolewski

🐛 💻 🔣 📖 💡 🤔 🚇 🚧 🧑‍🏫 💬 👀 ⚠️ 📢 📓

Chris Holdgraf

💻

Chris Markiewicz

💻 ⚠️ 🤔 🐛 💬 🔧 🚧

David Nishikawa

💻 ⚠️

Dimitri Papadopoulos Orfanos

💻

Duncan Macleod

🚇

Franklin Feingold

📖

Gregory noack

💻 ⚠️

Horea Christian

💻

Jakub Kaczmarzyk

🚇

Joke Durnez

💻

Mainak Jas

💻 ⚠️ 🤔 👀 📓

Marco Castellaro

💻 ⚠️

Max

💻 🐛

Michael Hanke

📖

Mikael Naveau

💻

Nell Hardcastle

💻 🤔 🚇 💬 👀

Nicolas Traut

💻

Parul Sethi

💻 ⚠️

Patricia Clement

💻

Remi Gau

💻 📖 📓

Richard Höchenberger

💻 📓 ⚠️ 🐛

Robert Oostenveld

💻 🤔 🐛 ⚠️

Rohan Goyal

💻

Ross Blair

🚧 🤔 💻 🐛 🚇 📆 💬 👀 🔧 ⚠️

Russ Poldrack

💻 💵 🔍

Soichi Hayashi

🐛

Stefan Appelhoff

🐛 💻 🔣 📖 💡 🤔 🚇 🚧 🧑‍🏫 💬 👀 ⚠️ 📢 📓

Suyash

💻

Taylor Salo

💻

Teal Hobson-Lowther

💻 ⚠️

Travis Riddle

🐛

VisLab

🤔 💻

Wazeer Zulfikar

📖

Yaroslav Halchenko

🤔 💻 📖 📓

constellates

💻 ⚠️

dewarrn1

💻

dkp

💻

goldmund

💻 ⚠️