33[ ![ Codecov] ( https://codecov.io/gh/bids-standard/bids-validator/branch/master/graph/badge.svg )] ( https://codecov.io/gh/bids-standard/bids-validator )
44[ ![ DOI] ( https://zenodo.org/badge/DOI/10.5281/zenodo.3688707.svg )] ( https://doi.org/10.5281/zenodo.3688707 )
55
6-
76# BIDS-Validator
87
9- * [ BIDS-Validator] ( #bids-validator )
10- * [ Quickstart] ( #quickstart )
11- * [ Support] ( #support )
12- * [ Maintainers and Contributors] ( #maintainers-and-contributors )
13- * [ Use] ( #use )
14- * [ API] ( #api )
15- * [ .bidsignore] ( #bidsignore )
16- * [ Configuration] ( #configuration )
17- * [ In the Browser] ( #in-the-browser )
18- * [ On the Server] ( #on-the-server )
19- * [ Through Command Line] ( #through-command-line )
20- * [ Docker image] ( #docker-image )
21- * [ Python Library] ( #python-library )
22- * [ Example] ( #example )
23- * [ Development] ( #development )
24- * [ Running Locally in a Browser] ( #running-locally-in-a-browser )
25- * [ Testing] ( #testing )
26- * [ Publishing] ( #publishing )
27- * [ Acknowledgments] ( #acknowledgments )
8+ - [ BIDS-Validator] ( #bids-validator )
9+ - [ Quickstart] ( #quickstart )
10+ - [ Support] ( #support )
11+ - [ Maintainers and Contributors] ( #maintainers-and-contributors )
12+ - [ Use] ( #use )
13+ - [ API] ( #api )
14+ - [ .bidsignore] ( #bidsignore )
15+ - [ Configuration] ( #configuration )
16+ - [ In the Browser] ( #in-the-browser )
17+ - [ On the Server] ( #on-the-server )
18+ - [ Through Command Line] ( #through-command-line )
19+ - [ Docker image] ( #docker-image )
20+ - [ Python Library] ( #python-library )
21+ - [ Example] ( #example )
22+ - [ Development] ( #development )
23+ - [ Running Locally in a Browser] ( #running-locally-in-a-browser )
24+ - [ Testing] ( #testing )
25+ - [ Publishing] ( #publishing )
26+ - [ Acknowledgments] ( #acknowledgments )
2827
2928## Quickstart
3029
47461 . Python Library:
4847 1 . Install [ Python] ( https://www.python.org/ ) (works with python2 and python3)
4948 1 . Install [ Pip] ( https://pip.pypa.io/en/stable/installing/ ) package manager for python, if
50- not already installed.
49+ not already installed.
5150 1 . From a terminal run ` pip install bids_validator ` to acquire the
5251 [ BIDS Validator PyPi package] ( https://pypi.org/project/bids-validator/ )
5352 1 . Open a Python terminal ` python `
@@ -281,11 +280,12 @@ To use bids validator with [docker](https://www.docker.com/), you simply need to
281280[ install docker] ( https://docs.docker.com/install/ ) on your system.
282281
283282And then from a terminal run:
284- - ` docker run -ti --rm bids/validator --version ` to print the version of the
283+
284+ - ` docker run -ti --rm bids/validator --version ` to print the version of the
285285 docker image
286- - ` docker run -ti --rm bids/validator --help ` to print the help
286+ - ` docker run -ti --rm bids/validator --help ` to print the help
287287- ` docker run -ti --rm -v /path/to/data:/data:ro bids/validator /data `
288- to validate the dataset ` /path/to/data ` on your host machine
288+ to validate the dataset ` /path/to/data ` on your host machine
289289
290290See here for a brief explanation of the commands:
291291
@@ -298,12 +298,12 @@ See here for a brief explanation of the commands:
298298- the ` -v ` flag is adding your local data to the docker container
299299 ([ bind-mounts] ( https://docs.docker.com/storage/bind-mounts/ ) ). Importantly,
300300 the input after the ` -v ` flag consists of three fields separated colons: ` : `
301- - the first field is the path to the directory on the host machine:
302- ` /path/to/data `
303- - the second field is the path where the directory is mounted in the
304- container
305- - the third field is optional. In our case, we use ` ro ` to specify that the
306- mounted data is * read only *
301+ - the first field is the path to the directory on the host machine:
302+ ` /path/to/data `
303+ - the second field is the path where the directory is mounted in the
304+ container
305+ - the third field is optional. In our case, we use ` ro ` to specify that the
306+ mounted data is _ read only _
307307
308308## Python Library
309309
@@ -341,17 +341,17 @@ A note about OS X, the dependencies for the browser require a npm package called
341341node-gyp which needs xcode to be installed in order to be compiled.
342342
3433431 . The browser version of ` bids-validator ` lives in the repo subdirectory
344- `/bids-validator-web`. It is a [React.js](https://reactjs.org/) application
345- that uses the [next.js](https://nextjs.org/) framework.
344+ ` /bids-validator-web ` . It is a [ React.js] ( https://reactjs.org/ ) application
345+ that uses the [ next.js] ( https://nextjs.org/ ) framework.
3463462 . To develop ` bids-validator ` and see how it will act in the browser, simply run
347- `yarn web-dev` in the project root and navigate to `localhost:3000`.
347+ ` yarn web-dev ` in the project root and navigate to ` localhost:3000 ` .
3483483 . In development mode, changes to the codebase will trigger rebuilds of the application
349- automatically.
349+ automatically.
3503504 . Changes to the ` /bids-validator ` in the codebase will also be reflected in the
351- web application.
351+ web application.
3523525 . Tests use the [ Jest] ( https://jestjs.io/index.html ) testing library and should be developed in ` /bids-validator-web/tests ` .
353- We can always use more tests, so please feel free to contribute a test that reduces the chance
354- of any bugs you fix!
353+ We can always use more tests, so please feel free to contribute a test that reduces the chance
354+ of any bugs you fix!
3553556 . To ensure that the web application compiles successfully in production, run ` yarn web-export `
356356
357357### Testing
@@ -383,6 +383,7 @@ below.
383383
384384Development and contributions were supported through the following federally
385385funded projects/grants:
386+
386387- [ BIDS Derivatives (NIMH: R24MH114705, PI: Poldrack)] ( http://grantome.com/grant/NIH/R24-MH114705-01 )
387388- [ OpenNeuro (NIMH: R24MH117179, PI: Poldrack)] ( http://grantome.com/grant/NIH/R24-MH117179-01 )
388389- [ Spokes: MEDIUM: WEST (NSF: 1760950, PI: Poldrack & Gorgolewski)] ( http://grantome.com/grant/NSF/IIS-1760950 )
0 commit comments