Metadata-Version: 2.4
Name: lobster-visualization
Version: 1.0.1
Summary: Visualization agent for Lobster AI - publication-quality plots and interactive visualizations
Author-email: Omics-OS <info@omics-os.com>
License-Expression: AGPL-3.0-or-later
Project-URL: Homepage, https://www.omics-os.com
Project-URL: Documentation, https://docs.omics-os.com
Project-URL: Source Code, https://github.com/the-omics-os/lobster
Keywords: bioinformatics,visualization,plotting,single-cell,omics
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: lobster-ai~=1.0.0
Dynamic: license-file

# lobster-visualization

Publication-quality plots and interactive visualizations for bioinformatics data analysis.

## Installation

```bash
pip install lobster-visualization
```

## Agents

| Agent | Description |
|-------|-------------|
| `visualization_expert` | General-purpose visualization agent for creating publication-ready figures across all omics data types. |

## Services

| Service | Purpose |
|---------|---------|
| VisualizationService | Core plotting engine with Plotly-based interactive visualizations |

## Features

- UMAP plots with automatic point size scaling based on cell count
- PCA plots with variance explained annotations
- t-SNE visualizations for dimensionality reduction
- Violin plots for gene expression distribution by cluster
- Feature plots showing expression intensity on embeddings
- Dot plots for marker gene comparison across clusters
- Heatmaps with optional row and column standardization
- Elbow plots for PCA variance analysis and component selection
- Cluster composition stacked bar charts for sample contribution
- QC plots with scientific validation (skips inappropriate modalities)
- Interactive Plotly figures with zoom, pan, and hover tooltips
- Static PNG export for publication and presentation use
- Consistent color palettes across related visualizations
- Automatic figure sizing based on data dimensions

## Requirements

- Python 3.12+
- lobster-ai >= 1.0.0
- plotly

## Documentation

Full documentation: [docs.omics-os.com/docs/agents/visualization](https://docs.omics-os.com/docs/agents/visualization)

## License

AGPL-3.0-or-later
