# Huez
A unified color scheme solution for Python visualization libraries.
## Installation
```bash
pip install huez
```
## Quick Start
```python
import huez as hz
import matplotlib.pyplot as plt
# Apply a color scheme
hz.use("scheme-1")
# Create plots with automatic coloring
plt.plot(x, y1, label='Data 1')
plt.plot(x, y2, label='Data 2')
plt.legend()
plt.show()
```
## Supported Libraries
- **Matplotlib** - Automatic color cycling
- **Seaborn** - Consistent palette integration
- **plotnine** - Native ggplot2-style coloring
- **Altair** - Theme-based color schemes
- **Plotly** - Template-based styling
## Built-in Schemes
- `scheme-1` - Nature journal style (NPG colors)
- `scheme-2` - Science journal style (AAAS colors)
- `scheme-3` - NEJM medical journal style
- `scheme-4` - Lancet journal style
- `scheme-5` - JAMA journal style
## Custom Configuration
Create a YAML config file:
```yaml
version: 1
default_scheme: my_style
schemes:
my_style:
title: "My Custom Style"
fonts: { family: "Arial", size: 11 }
palettes:
discrete: "npg"
sequential: "viridis"
diverging: "coolwarm"
cyclic: "twilight"
figure: { dpi: 300 }
style: { grid: "y", legend_loc: "best", spine_top_right_off: true }
```
Load and use:
```python
hz.load_config("my_config.yaml")
hz.use("my_style")
```
## License
MIT License - see [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "huez",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "Ang <ang@hezhiang.com>",
"keywords": "visualization, color, scheme, matplotlib, seaborn, plotly, altair, plotnine",
"author": null,
"author_email": "Ang <ang@hezhiang.com>",
"download_url": "https://files.pythonhosted.org/packages/e0/91/ab6e5822ba2dd9ac0bd8b2eeaf9b996aef4e04fef1c394424abe6c84ae1c/huez-0.0.3.tar.gz",
"platform": null,
"description": "# Huez\r\n\r\nA unified color scheme solution for Python visualization libraries.\r\n\r\n## Installation\r\n\r\n```bash\r\npip install huez\r\n```\r\n\r\n## Quick Start\r\n\r\n```python\r\nimport huez as hz\r\nimport matplotlib.pyplot as plt\r\n\r\n# Apply a color scheme\r\nhz.use(\"scheme-1\")\r\n\r\n# Create plots with automatic coloring\r\nplt.plot(x, y1, label='Data 1')\r\nplt.plot(x, y2, label='Data 2')\r\nplt.legend()\r\nplt.show()\r\n```\r\n\r\n## Supported Libraries\r\n\r\n- **Matplotlib** - Automatic color cycling\r\n- **Seaborn** - Consistent palette integration \r\n- **plotnine** - Native ggplot2-style coloring\r\n- **Altair** - Theme-based color schemes\r\n- **Plotly** - Template-based styling\r\n\r\n## Built-in Schemes\r\n\r\n- `scheme-1` - Nature journal style (NPG colors)\r\n- `scheme-2` - Science journal style (AAAS colors)\r\n- `scheme-3` - NEJM medical journal style\r\n- `scheme-4` - Lancet journal style\r\n- `scheme-5` - JAMA journal style\r\n\r\n## Custom Configuration\r\n\r\nCreate a YAML config file:\r\n\r\n```yaml\r\nversion: 1\r\ndefault_scheme: my_style\r\nschemes:\r\n my_style:\r\n title: \"My Custom Style\"\r\n fonts: { family: \"Arial\", size: 11 }\r\n palettes:\r\n discrete: \"npg\"\r\n sequential: \"viridis\"\r\n diverging: \"coolwarm\"\r\n cyclic: \"twilight\"\r\n figure: { dpi: 300 }\r\n style: { grid: \"y\", legend_loc: \"best\", spine_top_right_off: true }\r\n```\r\n\r\nLoad and use:\r\n\r\n```python\r\nhz.load_config(\"my_config.yaml\")\r\nhz.use(\"my_style\")\r\n```\r\n\r\n## License\r\n\r\nMIT License - see [LICENSE](LICENSE) file for details.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A unified color scheme solution for Python visualization",
"version": "0.0.3",
"project_urls": {
"Homepage": "https://github.com/hzacode/huez",
"Issues": "https://github.com/hzacode/huez/issues",
"Repository": "https://github.com/hzacode/huez"
},
"split_keywords": [
"visualization",
" color",
" scheme",
" matplotlib",
" seaborn",
" plotly",
" altair",
" plotnine"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b7118d227979c63f6434f8f896cddf6a5048b49cebb877d454de9033a3ea9b6c",
"md5": "e915ed0bdbbcd0249c7577ce6c557508",
"sha256": "103453251b1e1462108756ef8bc6d59d14d3d0b48f39abfbf91633c7d0afe2e4"
},
"downloads": -1,
"filename": "huez-0.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e915ed0bdbbcd0249c7577ce6c557508",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 52639,
"upload_time": "2025-09-12T05:44:05",
"upload_time_iso_8601": "2025-09-12T05:44:05.793828Z",
"url": "https://files.pythonhosted.org/packages/b7/11/8d227979c63f6434f8f896cddf6a5048b49cebb877d454de9033a3ea9b6c/huez-0.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e091ab6e5822ba2dd9ac0bd8b2eeaf9b996aef4e04fef1c394424abe6c84ae1c",
"md5": "030da52dedfd92bf54b1143aad281ce8",
"sha256": "7c37b12991ec0404f567a0b5f08c92c3781c5459ad2d743dd88dd33786b2b254"
},
"downloads": -1,
"filename": "huez-0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "030da52dedfd92bf54b1143aad281ce8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 43141,
"upload_time": "2025-09-12T05:44:07",
"upload_time_iso_8601": "2025-09-12T05:44:07.381888Z",
"url": "https://files.pythonhosted.org/packages/e0/91/ab6e5822ba2dd9ac0bd8b2eeaf9b996aef4e04fef1c394424abe6c84ae1c/huez-0.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-12 05:44:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hzacode",
"github_project": "huez",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "huez"
}
JSON
