Metadata-Version: 2.1
Name: brainsurfy
Version: 0.0.1
Summary: brainsurfy
Home-page: https://github.com/teanijarv/brainsurfy
Author: Toomas Erik Anijärv
Author-email: toomaserikanijarv@gmail.com
License: MIT License
Keywords: brainsurfy
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas >=1.3.5
Requires-Dist: matplotlib >=3.5.2
Requires-Dist: seaborn >=0.11

# brainsurfy

Simple surface plots in Python based on ggseg parcellations.

```
import matplotlib.pyplot as plt

from brainsurfy import fetch_atlas_data, simulate_data, plot_surf

atlas_data = fetch_atlas_data('schaefer7_400')
sim_data = simulate_data(atlas_data)

plot_surf(atlas_data, sim_data, cmap=plt.cm.viridis, cbar=True)
```

Output:

![image](docs/images/output_v0.1.0.png)

## Installation
brainsurfy is meant to be used with Python 3.9 or above, and has been tested on Python 3.9-3.12.

#### Dependencies
- [NumPy](https://numpy.org/)
- [Pandas](https://pandas.pydata.org/)
- [matplotlib](https://matplotlib.org/)
- [seaborn](https://seaborn.pydata.org/)

#### User installation
To install brainsurfy, run this command in your terminal:

`pip install brainsurfy`

This is the preferred method to install brainsurfy, as it will always install the most recent stable release.

If you don’t have [pip](https://pip.pypa.io/) installed, this [Python installation guide](http://docs.python-guide.org/en/latest/starting/installation/) can guide you through the process.

## to-do:
- a lot of things...
- look into 3d surface plots
- docs (once there is more stuff)
- form into package and upload to pypi

=======
History
=======

0.0.1 (2024-03-15)
------------------

* First release on PyPI.
