Compat Layer (Drop-in Replacement)

from bids2table_compat import BIDSLayout

layout = BIDSLayout('/data/dataset')
subjects = layout.get_subjects()
files = layout.get(subject='01', suffix='T1w')

✅ Familiar PyBIDS API ✅ Easy migration (change 1 line) ✅ Same query patterns

Native b2t (Best Performance)

import bids2table as b2t
import pandas as pd

tab = b2t.index_dataset('/data/dataset')
df = tab.to_pandas()

subjects = sorted(df['sub'].unique())
files = df[(df['sub'] == '01') & (df['suffix'] == 'T1w')]['path'].tolist()

✅ More flexible (full pandas) ✅ Slightly faster queries ✅ Direct DataFrame access

Which to Use?

Migrating from PyBIDS? → Use compat layer
New project? → Consider native b2t
Need complex queries? → Native b2t gives full pandas power
Want simplicity? → Compat layer is cleaner