Skip to main content

Simultaneous Multi-region Analysis supported with a network style

Project description

Simuran

Documentation Status Quality Gate Status codecov Maintainability Code style: black License: GPL v3

Demo of UI

To see more details than in the README, our read the docs site, or the PhD thesis of Sean K. Martin.

Installation

pip install simuran

MAC OS

  • To use the UI, you will need to perform at least the following - brew install libpng.
  • It is possible you may also need the MAC command line developer tools.

Usage

Objective

Simuran can help facilitate batch processing of many neural recordings in an easy to handle way.

The main objects to setup are Recordings (containing all information relevant to an experiment, or part of an experiment) and RecordingContainers, which are a series of Recordings. For instance, a RecordingContainer could represent all t-maze running speed, spikes, etc. and associated metadata, while a Recording is an individual t-maze session. This can then support easy extraction of subcontainers, such as, all trials which were successful in mice expressing a particular gene.

API

The API is built around the Recording and RecordingContainer classes, for instance, one way to load an NWB file is as follows:

import simuran

recording = simuran.Recording(
    source_file=PATH_TO_NWB, loader=simuran.loader("NWB"))
recording.load()
recording.inspect() # See what was loaded

The Recording class is designed to be as flexible as possible, and can be used to load any data, as long as a loader is provided. The loader is a class which takes a Recording object and loads the data into it. Other modules include the analysis module, which allows multi-processing of analysis functions, and the base module, which contains the base classes for the API. The plot module contains plotting functions for general use, and also some simple figure handling (auto garbage collection, etc.). Finally, the bridge module contains Bridge class definitions, which are used to allow interoperability between different software tools and data formats in neuroscience.

GUI - Visual node based editor

Here, the focus is mostly on the Recording level, but multiple recordings can be bundled as blocks.

Recordings are loaded and processed via Nodes which are established through the UI and run in a digraph fashion. The UI is built using dearpygui, and supports a subset of the API via nodes, which can be expanded upon.

Demo of UI still

Examples

Some examples are provided in the examples folder.

Contributing

Contributions are welcome, and any issues can be raised on the github page. Please feel free to reach out to me if you have any questions.

License

Simuran is distributed under the GPL-3.0 License.

Inspiration

  1. NeuroChaT: Analysis toolset with GUI for Neuroscience
  2. SpikeInterface · GitHub
  3. A set of python neuroscience scripts which rely on the NeuroChaT API
  4. MNE: Magnetoencephalography (MEG) and Electroencephalography (EEG) in Python
  5. Sumatra - NeuralEnsemble
  6. Snakemake

Update coverage

pytest .
codecov -t ba31944a-6070-401e-a731-1bd2f92a5e55

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

simuran-23.8.0.tar.gz (63.5 kB view hashes)

Uploaded Source

Built Distribution

simuran-23.8.0-py3-none-any.whl (69.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page