behapy: A behavioural neuroscience analysis package for Python

Title

Leaders

Chris Nolan

Collaborators

No response

Brainhack Global 2024 Event

Brainhack Aus

Project Description

Studies using optic fibres to record real-time fluorescent biosensors in-vivo are now commonplace, yet despite an increasing literature on best practices for analysing such data, there is a surprising lack of fit-for-purpose API-level tooling. This project is a continuing effort to fill this gap by providing flexible Python-based implementations of common normalisation and artefact correction procedures for fluorescent biosensors, along with useful event-based analyses.

The goals of this project will extend beyond Brainhack Global 2024, but all are in an effort to create an open-source API and workbench for analysing fibre photometry data in a behavioural neuroscience context. Since Brainhack Global 2022, we have created a basic artefact-rejection workbench, a preprocessing stage and implemented simple linear regression for event-level analysis. This year the goal is to create a method to benchmark normalisation methods by creating data simulation functionality under different assumptions about the sources of recording noise. We are also aiming to generalise second-level linear mixed model testing for events of interest.

Link to project repository/sources

https://github.com/crnolan/behapy

Goals for Brainhack Global

Create a utility for simulating raw fibre photometry data under a variety of assumptions (for testing the toolkit).
Implement second-level linear mixed model tests for events of interest.
Develop both API-level and tutorial documentation. Docstrings are currently sparse and light on detail, and walkthroughs are virtually non-existent.
Add import scripts for MedPC datasets, and put together a skeleton framework for event summary and plotting functions.

Good first issues

Check and update installation instructions for behapy package.
Document end-user experience for running existing fibre preprocessing workbench on sample data.
Establish a configuration format / tool for importing structured MedPC files.
Add the capability in the pre-processing interface to interactively compare / select different but reasonable normalisation methods.

Communication channels

https://mattermost.brainhack.org/brainhack/channels/behapy

Skills

Primarily, some knowledge of fluorescent biosensor normalisation and analysis procedures will be useful. We'll be predominantly working in Python, but there will be tasks for all levels of Python competency.

Bonus useful skills:

Signal processing (we'll be filtering and fitting timeseries data)
Python interactive visualisation (bokeh / holoviews / panel / seaborn / matplotlib)
Working knowledge of linear regression and mixed effects models
BIDS experience - while we won't be attempting to add an official BIDS extension for fibre photometry in this project, we are trying to stay approximately in line with BIDS format

Onboarding documentation

No response

What will participants learn?

Data manipulation in Python (numpy / pandas)
Signal filtering in Python
GitHub collaboration techniques

Data to use

BYO fibre & behavioural data - we'll create a repository of useful examples.

Number of collaborators

Credit to collaborators

Project contributors will be listed on the project README (hosted on github).

Image

Leave this text if you don't have an image yet.

Type

data_management, pipeline_development, visualization

Development status

0_concept_no_content

Topic

data_visualisation, systems_neuroscience

Tools

BIDS, other

Programming language

Python

Modalities

behavioral, other

Git skills

1_commit_push

Anything else?

No response

Things to do after the project is submitted and ready to review.

[x] Add a comment below the main post of your issue saying: Hi @brainhackorg/project-monitors my project is ready!
[ ] Twitter-sized summary of your project pitch.

brainhackorg / global2024