# Matprops
**matprops** is a Python library for visualizing proportional data. It is build above matplotlib (the visualization library). Understanding proportional data is quite easy but when it comes to bigger picture we lack of seeing everything
## Installation
Binary installers for the latest released version are available at the [Python
Package Index (PyPI)](https://pypi.org/project/matprops/)
```sh
# PyPI
pip install matprops
```
The source code is currently hosted on [GitHub](https://github.com/sharajmohamars/matprops.git)
## Area proportional chart
Area proportional charts also known as square area proportional charts is a very easy and basic proportional chart to know first in list. matprops provide a lage amount of customization in creating square area proportional charts
```python
# Pandas - DataFrame Support
import pandas as pd
# Matprops
from matprops import props
```
props is a subclass doing its work for simple proportional charts
```python
# Creating a dataframe with the help of pandas
dataset = pd.DataFrame(
{
'Country': ['France', 'Germany', 'United Arab Emirates'],
'Men (%)': [60, 80, 30],
'Capital': ['Paris', 'Berlin', 'Mecca']
}
)
# Changing the limits
# Limit : 0 -> 1
dataset["Men (%)"] = dataset["Men (%)"]/100
```
Reducing the limits is mandatory as the matprops is all about proportional charts we need to get the value down to 0 -> 1 range. Ignoring the limits may cause unexpected warnings and errors
Simple square area proportional charts are capable of showing some insights through this data
```python
props.AreaProp(dataset, "Men (%)", labels=True, title="Country", description="Capital")
```
Try customizing the graph with everything possible
**matprops** provides fast and reliable data visualizations for proportional data. matprops currently work only for labelled data for which it is found to be more helpful in defining proportions. matprops aims to move more than proportional charts in upcoming versions. We have enough proportional chart libraries around the Python community, but the thing that differs matprops is its creativity and customization. Some rare visualizations are about to be worked on matprops soon
Raw data
{
"_id": null,
"home_page": "https://github.com/shammeer-s/matprops",
"name": "matprops",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "matplotlib, visualization, proportional charts",
"author": "Mohammed Shammeer",
"author_email": "mohammedshammeer.s@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/78/ba/f6261283e25b8ecfd2d07b5a8a9b2d1afcc632f9af6c9a38514fb6f90205/matprops-1.0.4.4.tar.gz",
"platform": null,
"description": "# Matprops\n**matprops** is a Python library for visualizing proportional data. It is build above matplotlib (the visualization library). Understanding proportional data is quite easy but when it comes to bigger picture we lack of seeing everything \n\n## Installation\nBinary installers for the latest released version are available at the [Python\nPackage Index (PyPI)](https://pypi.org/project/matprops/)\n\n```sh\n# PyPI\npip install matprops\n```\n\nThe source code is currently hosted on [GitHub](https://github.com/sharajmohamars/matprops.git)\n\n\n## Area proportional chart\nArea proportional charts also known as square area proportional charts is a very easy and basic proportional chart to know first in list. matprops provide a lage amount of customization in creating square area proportional charts\n\n```python\n# Pandas - DataFrame Support\nimport pandas as pd\n\n# Matprops\nfrom matprops import props\n```\n\nprops is a subclass doing its work for simple proportional charts \n\n```python\n# Creating a dataframe with the help of pandas\ndataset = pd.DataFrame(\n {\n 'Country': ['France', 'Germany', 'United Arab Emirates'], \n 'Men (%)': [60, 80, 30],\n 'Capital': ['Paris', 'Berlin', 'Mecca']\n }\n)\n\n# Changing the limits\n# Limit : 0 -> 1\ndataset[\"Men (%)\"] = dataset[\"Men (%)\"]/100\n```\n\nReducing the limits is mandatory as the matprops is all about proportional charts we need to get the value down to 0 -> 1 range. Ignoring the limits may cause unexpected warnings and errors\n\nSimple square area proportional charts are capable of showing some insights through this data\n```python\nprops.AreaProp(dataset, \"Men (%)\", labels=True, title=\"Country\", description=\"Capital\")\n```\n\n\n\nTry customizing the graph with everything possible\n\n**matprops** provides fast and reliable data visualizations for proportional data. matprops currently work only for labelled data for which it is found to be more helpful in defining proportions. matprops aims to move more than proportional charts in upcoming versions. We have enough proportional chart libraries around the Python community, but the thing that differs matprops is its creativity and customization. Some rare visualizations are about to be worked on matprops soon\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Python library written on top of matplotlib library for customizable proportional charts",
"version": "1.0.4.4",
"project_urls": {
"Homepage": "https://github.com/shammeer-s/matprops"
},
"split_keywords": [
"matplotlib",
" visualization",
" proportional charts"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1b8ca83b966c6f27a40976d6bbc2a8976a338de05b67d075f9a92316d22e72fe",
"md5": "c25a566743f98e0a17de1d4534d62e05",
"sha256": "6d851ce0cb2ab52b348d9908abf35e812c970a4e04d785aa88fb42f6839dded5"
},
"downloads": -1,
"filename": "matprops-1.0.4.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c25a566743f98e0a17de1d4534d62e05",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9583,
"upload_time": "2024-05-23T01:55:33",
"upload_time_iso_8601": "2024-05-23T01:55:33.590850Z",
"url": "https://files.pythonhosted.org/packages/1b/8c/a83b966c6f27a40976d6bbc2a8976a338de05b67d075f9a92316d22e72fe/matprops-1.0.4.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "78baf6261283e25b8ecfd2d07b5a8a9b2d1afcc632f9af6c9a38514fb6f90205",
"md5": "167495bf9c2831db15204cc6ed29f658",
"sha256": "872b32be025181add6cfa1927340d283a2a7ed39a56920ad37e98268529922b7"
},
"downloads": -1,
"filename": "matprops-1.0.4.4.tar.gz",
"has_sig": false,
"md5_digest": "167495bf9c2831db15204cc6ed29f658",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7809,
"upload_time": "2024-05-23T01:55:35",
"upload_time_iso_8601": "2024-05-23T01:55:35.109275Z",
"url": "https://files.pythonhosted.org/packages/78/ba/f6261283e25b8ecfd2d07b5a8a9b2d1afcc632f9af6c9a38514fb6f90205/matprops-1.0.4.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-23 01:55:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "shammeer-s",
"github_project": "matprops",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "matprops"
}
JSON
