Metadata-Version: 2.1
Name: roipy
Version: 1.2
Summary: Plotting brain regions of interest (ROI) for demonstration purposes in Python
Home-page: https://github.com/w-decker/roipy
Author: Will Decker
Author-email: deckerwill7@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: nilearn
Requires-Dist: matplotlib
Requires-Dist: numpy

# roipy

Plotting brain regions of interest (ROI) for demonstration purposes in Python

## Description

Have you ever wanted to plot a region of the brain to include in a talk or presentation? What about in a lecture? Some might arbitrarily highlight the area of the cortex in which they _think_ a particular region might fall. Others might scour the internet for images. Well...you won't need to do that any more. With `roipy`, you can plot exact regions of the brain using the [**Destrieux Atlas**](https://www.ncbi.nlm.nih.gov/pmc/articles/PMC2937159/).

## Installation

This package is hosted on [PyPi](https://pypi.org/project/roipy/). You may use `pip` to install.

```bash
pip install roipy
```

## Usage

There are three types of brain plots included in `roipy`. A "univariate" plot, a "multivariate" plot and a "whole brain multivariate" plot. There are two methods for generating each plot:

1. Using the domain general class, `roipy.plotting.Plot()`
2. Executing each individual plotting method via its own specific function (e.g., `roipy.utils.plot_multivariate()`)

Below is an example of each methods implementation.

```python
# import
from roipy.plotting import Plot
from roipy.utils import plot_multivariate

# Domain general Plot()
P = Plot()
P.plot_multivariate(roi=[1,3,5,34], cmap='viridis')

#Individual function
plot_multivariate(roi=[1,3,5,34], shape='pial', view='lateral', hemi='left', cmap='viridis')

```

The parameter `roi` is given a list of integers which correspond to the Destrieux surface atlas. 

The utility functions exist for more verbose plotting functionality, like animation with `matplotlib.animation.FuncAnimation()`.




