https://github.com/Macquarie-MEG-Research/BIDSHandler

Library for loading and manipulating BIDS compatible MEG data
https://github.com/Macquarie-MEG-Research/BIDSHandler

Last synced: about 1 month ago
JSON representation

Library for loading and manipulating BIDS compatible MEG data

• Host: GitHub
• URL: https://github.com/Macquarie-MEG-Research/BIDSHandler
• Owner: Macquarie-MEG-Research
• License: mit
• Created: 2018-12-05T05:59:10.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2019-03-06T06:44:50.000Z (almost 6 years ago)
• Last Synced: 2024-10-30T00:11:05.426Z (about 1 month ago)
• Language: Python
• Homepage: https://macquarie-meg-research.github.io/BIDSHandler/
• Size: 27.8 MB
• Stars: 3
• Watchers: 8
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-bids - BIDSHandler

README

        
[![CircleCI](https://circleci.com/gh/Macquarie-MEG-Research/BIDSHandler.svg?style=svg)](https://circleci.com/gh/Macquarie-MEG-Research/BIDSHandler)

[![Downloads](https://pepy.tech/badge/bidshandler)](https://pepy.tech/project/bidshandler)

# BIDSHandler

A simple way to manage and manipulate BIDS compatible data.

## Installation

`BIDSHandler` requires only one dependency which can be easily installed using `pip`:

```

pip install pandas

```

To install `BIDSHandler` you can then enter in a terminal:

```

pip install BIDSHandler

```

Entering `import bidshandler` in a python console should not raise an error which indicates that `BIDSHandler` has been installed correctly.

## Basic Usage

`BIDSHandler` has 5 primary objects; `BIDSTree`, `Project`, `Subject`, `Session` and `Scan`, corresponding to different levels within a BIDS archive folder structure.

Generally data will be loaded into a `BIDSTree` object and the child objects are automatically generated. From there it is easy to query and manipulate the BIDS data.

```python

import bidshandler as bh

tree = bh.BIDSTree('folder')

print(tree.projects)

print(tree.subjects)

# etc.

```

## Contributing

BIDSHandler is still in very early stages, but contributions are more than welcome in the form of PR's and by raising issues to discussion potential features.

Ideally BIDSHandler would be able to handle any BIDS data from any modality such as MRI and EEG, but the current focus is on MEG data.