| Name | tueplots JSON |
| Version |
0.0.17
JSON |
| download |
| home_page | None |
| Summary | Scientific plotting made easy. |
| upload_time | 2024-10-17 12:59:33 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<p align="center">
<img src="https://raw.githubusercontent.com/pnkraemer/tueplots/main/docs/source/img/logo.png" width="400"/>
</p>
# TUEplots: Extend matplotlib for scientific publications
[](https://pypi.org/project/tueplots/)
[](https://github.com/pnkraemer/tueplots)
[](https://github.com/pnkraemer/tueplots)
[](https://github.com/pnkraemer/tueplots/actions?query=workflow%3Aci)
<a href="https://github.com/pnkraemer/tueplots/blob/master/LICENSE"><img src="https://img.shields.io/github/license/pnkraemer/tueplots?style=flat-square&color=2b9348" alt="License Badge"/></a>
## Why?
`tueplots` helps you to create scientific plots that can be used in papers, presentations, posters, or other publications.
`tueplots` does not try to make your plots as beautiful as possible (who are we to judge your favourite color).
Instead, it makes it effortless to avoid common issues like too-small figures, inappropriate fontsizes, or inconsistencies among figures.
Because good-looking figures _are_ important.
For example, consider the style tailored to the ICML2022 template.
(Left: default matplotlib, middle: one line of tueplots-code, right: two lines of tueplots-code)
<p align="center">
<img src="https://raw.githubusercontent.com/pnkraemer/tueplots/main/docs/img_for_readme/before.png" width="200"/>
<img src="https://raw.githubusercontent.com/pnkraemer/tueplots/main/docs/img_for_readme/after1.png" width="200"/>
<img src="https://raw.githubusercontent.com/pnkraemer/tueplots/main/docs/img_for_readme/after2.png" width="200"/>
</p>
## Principles
**`tueplots` has no internal state:**
It only passes around dictionaries, whose key-value pairs match those that matplotlib uses.
Instead of updating global state, it makes it easy for you to do it yourself!
If you want to globally change settings, pass them to `matplotlib.pyplot.rcParams.update()`.
If you only need them for specific contexts, pass them to `matpltlib.pyplot.rc_context()`.
`tueplots` makes the change easy, so you can make the easy change. This should make `tueplots` naturally compatible with other matplotlib extensions.
Usage examples are given below.
**`tueplots` has no opinions:**
It does not tell you what your figures should look like in the end, but helps you to tailor your plots to your own needs.
We like all the colors, frame-styles, markers, or linewidths.
But we _do_ think that figure sizes should match the text-width in your publication,
and that the font-size in the plot should be readable, and similar to the rest of the paper/presentation/....
## Getting started
Installing `tueplots` is explained [**here**](https://tueplots.readthedocs.io/en/latest/getting_started/installation.html).
Some usage examples are given [**at this url**](https://tueplots.readthedocs.io/en/latest/getting_started/usage_example.html).
A more specific tutorial, applying `tueplots` to figures intended for ICML 2022, is [**on this page**](https://tueplots.readthedocs.io/en/latest/getting_started/application_icml2022.html).
If something is not working as promised, please refer to the [**troubleshooting**](https://tueplots.readthedocs.io/en/latest/getting_started/troubleshooting.html) site.
For more advanced tutorials, you may refer to the example notebooks.
## Related packages
There are similar packages to `tueplots` (with different foci, respectively):
* Seaborn: https://seaborn.pydata.org/index.html
* ProPlot: https://proplot.readthedocs.io/en/latest/cycles.html
* SciencePlots: https://github.com/garrettj403/SciencePlots
* MatplotX: https://github.com/nschloe/matplotx
* Themepy: https://github.com/petermckeeverPerform/themepy
The [**matplotlib third-party plots**](https://matplotlib.org/mpl-third-party/) contains a more comprehensive list.
If you know of any others, please feel invited to open an issue/PR.
# Miscellaneous
`tueplots`has been started at the University of Tübingen (hence the name).
Raw data
{
"_id": null,
"home_page": null,
"name": "tueplots",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Nicholas Kr\u00e4mer <pekra@dtu.dk>",
"download_url": null,
"platform": null,
"description": "\n<p align=\"center\">\n<img src=\"https://raw.githubusercontent.com/pnkraemer/tueplots/main/docs/source/img/logo.png\" width=\"400\"/>\n</p>\n\n# TUEplots: Extend matplotlib for scientific publications\n\n[](https://pypi.org/project/tueplots/)\n[](https://github.com/pnkraemer/tueplots)\n[](https://github.com/pnkraemer/tueplots)\n[](https://github.com/pnkraemer/tueplots/actions?query=workflow%3Aci)\n<a href=\"https://github.com/pnkraemer/tueplots/blob/master/LICENSE\"><img src=\"https://img.shields.io/github/license/pnkraemer/tueplots?style=flat-square&color=2b9348\" alt=\"License Badge\"/></a>\n\n\n\n## Why?\n\n`tueplots` helps you to create scientific plots that can be used in papers, presentations, posters, or other publications.\n`tueplots` does not try to make your plots as beautiful as possible (who are we to judge your favourite color).\nInstead, it makes it effortless to avoid common issues like too-small figures, inappropriate fontsizes, or inconsistencies among figures.\nBecause good-looking figures _are_ important. \n\nFor example, consider the style tailored to the ICML2022 template.\n(Left: default matplotlib, middle: one line of tueplots-code, right: two lines of tueplots-code)\n\n<p align=\"center\">\n<img src=\"https://raw.githubusercontent.com/pnkraemer/tueplots/main/docs/img_for_readme/before.png\" width=\"200\"/>\n<img src=\"https://raw.githubusercontent.com/pnkraemer/tueplots/main/docs/img_for_readme/after1.png\" width=\"200\"/>\n<img src=\"https://raw.githubusercontent.com/pnkraemer/tueplots/main/docs/img_for_readme/after2.png\" width=\"200\"/>\n</p>\n\n\n## Principles\n\n**`tueplots` has no internal state:**\nIt only passes around dictionaries, whose key-value pairs match those that matplotlib uses.\nInstead of updating global state, it makes it easy for you to do it yourself! \nIf you want to globally change settings, pass them to `matplotlib.pyplot.rcParams.update()`.\nIf you only need them for specific contexts, pass them to `matpltlib.pyplot.rc_context()`.\n`tueplots` makes the change easy, so you can make the easy change. This should make `tueplots` naturally compatible with other matplotlib extensions.\nUsage examples are given below.\n\n\n**`tueplots` has no opinions:**\nIt does not tell you what your figures should look like in the end, but helps you to tailor your plots to your own needs.\nWe like all the colors, frame-styles, markers, or linewidths.\nBut we _do_ think that figure sizes should match the text-width in your publication, \nand that the font-size in the plot should be readable, and similar to the rest of the paper/presentation/....\n\n## Getting started \n\nInstalling `tueplots` is explained [**here**](https://tueplots.readthedocs.io/en/latest/getting_started/installation.html).\nSome usage examples are given [**at this url**](https://tueplots.readthedocs.io/en/latest/getting_started/usage_example.html).\nA more specific tutorial, applying `tueplots` to figures intended for ICML 2022, is [**on this page**](https://tueplots.readthedocs.io/en/latest/getting_started/application_icml2022.html).\nIf something is not working as promised, please refer to the [**troubleshooting**](https://tueplots.readthedocs.io/en/latest/getting_started/troubleshooting.html) site.\nFor more advanced tutorials, you may refer to the example notebooks.\n\n## Related packages\nThere are similar packages to `tueplots` (with different foci, respectively):\n* Seaborn: https://seaborn.pydata.org/index.html\n* ProPlot: https://proplot.readthedocs.io/en/latest/cycles.html\n* SciencePlots: https://github.com/garrettj403/SciencePlots\n* MatplotX: https://github.com/nschloe/matplotx\n* Themepy: https://github.com/petermckeeverPerform/themepy\n\nThe [**matplotlib third-party plots**](https://matplotlib.org/mpl-third-party/) contains a more comprehensive list.\nIf you know of any others, please feel invited to open an issue/PR. \n\n\n# Miscellaneous\n\n`tueplots`has been started at the University of T\u00fcbingen (hence the name).\n",
"bugtrack_url": null,
"license": null,
"summary": "Scientific plotting made easy.",
"version": "0.0.17",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "22619cd9103afd60c3597b080e35de62d8fc66494a169ab6873efd81f4750a14",
"md5": "9e7f0a52f53c3eb9fb9c158d3bfe479b",
"sha256": "3f5843ae63e374eadb355d10daeadfaef87734510fe7b9a8ce017bf5b9760856"
},
"downloads": -1,
"filename": "tueplots-0.0.17-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9e7f0a52f53c3eb9fb9c158d3bfe479b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 14441,
"upload_time": "2024-10-17T12:59:33",
"upload_time_iso_8601": "2024-10-17T12:59:33.333254Z",
"url": "https://files.pythonhosted.org/packages/22/61/9cd9103afd60c3597b080e35de62d8fc66494a169ab6873efd81f4750a14/tueplots-0.0.17-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-17 12:59:33",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "tueplots"
}
