E563
Skip to content

Add BIDS (Brain Imaging Data Structure) skill#125

Open
yarikoptic wants to merge 3 commits intoK-Dense-AI:mainfrom
yarikoptic:enh-bids
Open

Add BIDS (Brain Imaging Data Structure) skill#125
yarikoptic wants to merge 3 commits intoK-Dense-AI:mainfrom
yarikoptic:enh-bids

Conversation

@yarikoptic
Copy link
Copy Markdown

Add comprehensive BIDS (Brain Imaging Data Structure) skill covering the community standard for organizing and describing neuroscience and biomedical research datasets. While originating for MRI, BIDS now covers 11 modalities: imaging (MRI, PET, microscopy), electrophysiology (EEG, MEG, iEEG, EMG), and other data (NIRS, motion capture, behavioral, MR spectroscopy), with active BEPs extending to microelectrode electrophysiology (Neuropixels), stimuli, and more.

Changes

SKILL.md (746 lines)

  • BIDS directory structure, file naming conventions, and entity ordering
  • PyBIDS querying (BIDSLayout) with basic and advanced usage
  • Dataset validation using bids-validator-deno (PyPI) or Deno directly
  • DICOM-to-BIDS conversion with three HeuDiConv modes:
    • ReproIn (turnkey, recommended for new studies)
    • Map into ReproIn (for existing data with arbitrary protocol names)
    • Custom heuristic (full flexibility)
  • Also covers dcm2bids (JSON config) and BIDScoin (GUI + YAML)
  • JSON sidecar metadata and inheritance, events files, participants files
  • BIDS derivatives conventions (space-, desc-, GeneratedBy)
  • BIDS-Apps interface (fMRIPrep, MRIQC, QSIPrep)
  • All 25 current BEPs listed with status and PR links
  • bids-examples highlighted as canonical reference collection
  • 11 best practices, 8 common issues with solutions
  • Related tools ecosystem including nwb2bids, CuBIDS, bids2table, DataLad

references/

  • bids_schema.json: Machine-readable BIDS schema (v1.2.1 / BIDS v1.11.1) fetched from https://bids-specification.readthedocs.io/en/stable/schema.json
  • beps.yml: Full BEP listing (25 BEPs) from bids-website
  • bids_specification.md: Entity table with all 35 entities in correct schema ordering (from rules.entities), datatypes, file extensions, template spaces
  • metadata_fields.md: Required/recommended JSON sidecar fields for every modality (anat, func, dwi, fmap, perf, EEG, MEG, iEEG, PET, microscopy, NIRS, motion)
  • conversion_tools.md: Detailed HeuDiConv, dcm2bids, and BIDScoin workflows with heuristic/config examples

scripts/

  • update_schema.py: Stdlib-only script to refresh schema.json and beps.yml from upstream. Supports --schema-url for PR previews or BEP-specific schemas

docs/scientific-skills.md

  • Added BIDS entry under "Neuroscience & Electrophysiology"

🤖 Generated with Claude Code and eyeballed and improved a little with my past BIDS steering committee member hat on, and heudiconv/reproin developer hat on, etc.

yarikoptic and others added 3 commits April 6, 2026 16:02
Comprehensive skill covering the BIDS standard for organizing neuroimaging data:

SKILL.md (746 lines):
- BIDS directory structure, file naming, entity ordering
- PyBIDS querying (BIDSLayout), dataset validation (bids-validator-deno)
- DICOM-to-BIDS conversion with HeuDiConv (ReproIn turnkey, map-into-reproin,
  and custom heuristic modes), dcm2bids, and BIDScoin
- JSON sidecar metadata and inheritance, events files, participants files
- BIDS derivatives conventions, BIDS-Apps interface
- All 25 current BEPs listed with status
- bids-examples as canonical reference collection
- 11 best practices, 8 common issues with solutions

references/:
- bids_schema.json: machine-readable schema (v1.2.1 / BIDS v1.11.1) from RTD
- beps.yml: full BEP listing from bids-website
- bids_specification.md: entity table in correct schema ordering (35 entities)
- metadata_fields.md: required/recommended sidecar fields for all modalities
- conversion_tools.md: detailed HeuDiConv/dcm2bids/BIDScoin workflows

scripts/update_schema.py: stdlib-only script to refresh schema + BEPs from upstream

Also listed in docs/scientific-skills.md under Neuroscience & Electrophysiology.

Co-Authored-By: Claude Code 2.1.92 / Claude Opus 4.6 <noreply@anthropic.com>
BIDS now covers 11 modalities: imaging (MRI, PET, microscopy),
electrophysiology (EEG, MEG, iEEG, EMG), and other data (NIRS,
motion capture, behavioral, MR spectroscopy). Updated descriptions
throughout to reflect this scope.

Note BEP032 (microelectrode electrophysiology) connection to
Neuropixels probes and the neuropixels-analysis skill.

Co-Authored-By: Claude Code 2.1.92 / Claude Opus 4.6 <noreply@anthropic.com>
=== Do not change lines below ===
{
 "chain": [],
 "cmd": "python scientific-skills/bids/scripts/update_schema.py",
 "exit": 0,
 "extra_inputs": [],
 "inputs": [],
 "outputs": [],
 "pwd": "."
}
^^^ Do not change lines above ^^^
Copy link
Copy Markdown
@claude claude bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Claude Code Review

This pull request is from a fork — automated review is disabled. A repository maintainer can comment @claude review to run a one-time review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

0