Mesoscopy is an open-source package for the analysis of mesoscale calcium recordings. It handles the preprocessing of mesoscale recording files to extract ∆F responses, the anatomical registration of recordings to the Allen Brain atlas as well as analysis of recordings captured at rest or with behaviour.
Prerequisites
Mesoscopy works best with data acquired in the NWB format. Alternatively, recordings acquired as HDF5 files compatible with mesoscopy's raw data schema may be used.
Dual-channel recordings with an accompanying haemodynamic response channel (e.g. using both 470nm and 405nm excitation for GCaMP) will be automatically separated during preprocessing and yield a corrected ∆F signal.
An example acquisition script (designed for FLIR Grasshopper cameras) can be found here.
Installing mesoscopy
The recommended way to install mesoscopy is by using pipx (https://pypa.github.io/pipx/). pipx will create an isolated python environment from which mesoscopy will run, leaving the system python alone. This is the recommended way to install mesoscopy, as it will not interfere with any other python packages you may have installed on your system.
On Linux
-
Install
pipx.-
On Ubuntu / Debian:
sudo apt update sudo apt install pipx pipx ensurepath sudo pipx ensurepath
-
On Fedora:
sudo dnf install pipx pipx ensurepath sudo pipx ensurepath
-
For other distributions, install
pipxwithpip:python3 -m pip install --user pipx python3 -m pipx ensurepath sudo pipx ensurepath
-
-
Install
mesoscopy.pipx install mesoscopy
On MacOS
-
Install
pipxwith homebrew.brew install pipx pipx ensurepath sudo pipx ensurepath
-
Install
mesoscopy.pipx install mesoscopy
On Windows
With Windows, you have two choices. You can either use mesoscopy with the Windows Subsystem for Linux (WSL) and follow the instructions above for installing mesoscopy on Linux (recommended), or you can run mesoscopy directly on Windows via PowerShell. The choice is of course yours, but you should bear in mind that mesoscopy primarily targets Unix-like OSs (Linux & MacOS) at the moment, so while everything should work fine on Windows, your mileage may vary.
To install mesoscopy directly on Windows, first install pipx using Scoop:
scoop install pipx
pipx ensurepath
Then install mesoscopy via pipx:
pipx install mesoscopy
Usage
For detailed documentation on how to use mesoscopy, please refer to our documentation.
To see all available mesoscopy commands, run
mesoscopy --help
mesoscopy commands are self-documenting. Run mesoscopy <command> --help to get more information or see available sub-commands.
Upgrading
Use pipx to upgrade mesoscopy:
pipx upgrade mesoscopy
Contributing
Mesoscopy is currently closed to PRs, except bugfixes. Please open an issue if you wish to contribute.
Funders
1 maintainer
Metadata
1 maintainer
Release files for mesoscopy 0.17.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mesoscopy-0.17.0.tar.gz | 7.2 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mesoscopy-0.17.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 7.4 MB
Release files / mesoscopy-0.17.0.tar.gz
| Download URL | mesoscopy-0.17.0.tar.gz |
|---|---|
| Size | 7.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
874d6e65cef1b50578f380f8fa08d0948a442413147da2613b47f2cf9d86ba7e
|
|
BLAKE2b-256 checksum How to use checksums |
7ebba97dbfdb32ac07f3a800d5b45de19f5d126210fd7b020f99a62878dede5e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mesoscopy-0.17.0-py3-none-any.whl
| Download URL | mesoscopy-0.17.0-py3-none-any.whl |
|---|---|
| Size | 162.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d0bb5e7b242b5af0ad39febffd2ed39804b5ab2e3f13b17f9abfe2b4b6f39d6f
|
|
BLAKE2b-256 checksum How to use checksums |
95f64beabb881c809e557225e912bdd5d3baa67578ab42d4c90cd28c816645e6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
