{"library":"pybids","title":"PyBIDS","description":"PyBIDS is a Python library that provides an interface for interacting with datasets organized according to the Brain Imaging Data Structure (BIDS) specification. It allows users to query, manage, and extract information from BIDS datasets, supporting local and cloud-based paths. The current version is 0.22.0, and the library maintains an active release cadence with minor feature releases every few months and frequent bug-fix updates.","language":"python","status":"active","last_verified":"Fri Apr 17","install":{"commands":["pip install pybids"],"cli":null},"imports":["from bids import BIDSLayout","from bids.layout import BIDSLayoutIndexer"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nfrom bids import BIDSLayout\n\n# Create a dummy BIDS directory for demonstration\ndummy_bids_dir = 'my_bids_dataset'\nos.makedirs(os.path.join(dummy_bids_dir, 'sub-01', 'ses-01', 'anat'), exist_ok=True)\nwith open(os.path.join(dummy_bids_dir, 'dataset_description.json'), 'w') as f:\n    f.write('{\"Name\": \"My Dummy Dataset\", \"BIDSVersion\": \"1.4.0\"}')\nwith open(os.path.join(dummy_bids_dir, 'sub-01', 'ses-01', 'anat', 'sub-01_ses-01_T1w.nii.gz'), 'w') as f:\n    f.write('dummy data')\n\n# Initialize the BIDSLayout\nlayout = BIDSLayout(dummy_bids_dir, validate=False)\n\n# Query for files\nt1w_files = layout.get(subject='01', suffix='T1w', extension='.nii.gz')\n\nprint(f\"Found {len(t1w_files)} T1w files for subject 01:\")\nfor f in t1w_files:\n    print(f.path)\n\n# Clean up dummy directory (optional)\n# import shutil\n# shutil.rmtree(dummy_bids_dir)","lang":"python","description":"This quickstart demonstrates how to initialize a `BIDSLayout` for a BIDS-compliant dataset and query for specific files using entity key-value pairs. It includes creating a minimal dummy BIDS structure to make the example runnable without an existing dataset.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":null}