Metadata-Version: 2.4
Name: plotfig
Version: 1.20.0
Summary: Scientific plotting package for Cognitive neuroscience
Author-email: Ricardo Ryn <ricardoRyn1317@gmail.com>
License-File: LICENSE
Keywords: neuroscience,plotting,visualization
Requires-Python: >=3.11
Requires-Dist: brainspace>=0.1.22
Requires-Dist: imageio>=2.37.2
Requires-Dist: kaleido>=1.0.0
Requires-Dist: loguru>=0.7.3
Requires-Dist: matplotlib>=3.10.6
Requires-Dist: nibabel>=5.3.2
Requires-Dist: numpy>=2.3.2
Requires-Dist: plotly>=6.3.0
Requires-Dist: pycirclize>=1.10.0
Requires-Dist: scipy>=1.16.1
Requires-Dist: tqdm>=4.67.1
Description-Content-Type: text/markdown

<div align="center">

# plotfig

[English](README.md) | [中文文档](README_zh.md)

[![PyPI version](https://badge.fury.io/py/plotfig.svg)](https://badge.fury.io/py/plotfig)
[![Python version](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)

A Python visualization library designed for cognitive neuroscience research, providing efficient, easy-to-use, and beautiful plotting tools.

![plotfig](./docs/en/assets/plotfig.png)

</div>

## Features

- 📊 **Multiple Chart Types**: Bar charts, matrix plots, correlation plots, circos plots, brain surface plots, brain connectivity plots
- 🎨 **Professional Research Style**: Built-in color schemes that meet academic publication standards
- 📈 **Automatic Significance Testing**: Built-in statistical methods with automatic significance annotations
- 🔬 **Designed for Neuroscience**: Supports common primate brain atlases and brain network visualization
- 🚀 **Easy to Use**: Simple API for quick getting started

## Quick Start

```python
from plotfig import plot_one_group_bar_figure

# Plot single group bar chart
data = [[1.2, 2.3, 3.1], [4.5, 5.6, 6.2]]
plot_one_group_bar_figure(data)
plt.show()
```

## Installation

`plotfig` requires Python 3.11 or higher.

**Install with uv:**

```bash
uv add plotfig
```

**Install with pip:**

```bash
pip install plotfig
```

## Documentation

For detailed documentation and usage examples, please visit the [plotfig documentation](https://ricardoryn.github.io/plotfig/).

## Contributing

We welcome Issues and PRs! Whether it's bug reports, feature suggestions, or documentation improvements, please feel free to open an [Issue](https://github.com/RicardoRyn/plotfig/issues).
