<h1 align="center">Quantium</h1>
<p align="center">
<img src="https://github.com/user-attachments/assets/f2edd31b-5091-4432-a8c9-34c664aa2b2f"
alt="Quantium logo"
width="300"
height="300">
</p>
<p>
<a href="https://badge.fury.io/py/quantium">
<img src="https://badge.fury.io/py/quantium.svg" alt="PyPI version">
</a>
<a href="https://opensource.org/licenses/MIT">
<img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT">
</a>
<a href="https://img.shields.io/pypi/pyversions/quantium">
<img src="https://img.shields.io/pypi/pyversions/quantium" alt="Python Version">
</a>
<a href="https://quantium.readthedocs.io/en/latest/">
<img src="https://readthedocs.org/projects/quantium/badge/?version=latest" alt="Documentation Status">
</a>
<a href="https://github.com/YOUR_USERNAME/YOUR_REPONAME/actions">
<img src="https://github.com/parneetsingh022/quantium/actions/workflows/ci.yml/badge.svg" alt="Build Status">
</a>
<a href="http://mypy-lang.org/">
<img src="https://www.mypy-lang.org/static/mypy_badge.svg" alt="Checked with mypy">
</a>
<a href="https://github.com/astral-sh/ruff">
<img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
</a>
<a href="https://codecov.io/gh/parneetsingh022/quantium">
<img src="https://codecov.io/gh/parneetsingh022/quantium/graph/badge.svg" alt="Test Coverage">
</a>
<a href="https://opensource.org/licenses/MIT">
<img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT">
</a>
<a href="https://pepy.tech/project/quantium">
<img src="https://static.pepy.tech/personalized-badge/quantium?period=total&units=international_system&left_color=black&right_color=blue&left_text=downloads" alt="PyPI Downloads">
</a>
<a href="https://github.com/parneetsingh022/quantium/commits/main">
<img src="https://img.shields.io/github/last-commit/parneetsingh022/quantium" alt="GitHub last commit">
</a>
</p>
### Readable units. Reliable math.
Quantium is a lightweight Python library for unit-safe scientific and mathematical computation.
It combines a clean, dependency-minimal architecture with a powerful system for dimensional analysis — ensuring that every calculation you perform respects physical consistency.
Beyond correctness, Quantium emphasizes clarity.
Its advanced formatting engine automatically simplifies, normalizes, and beautifully renders units using Unicode superscripts, SI prefixes, and canonical symbols.
## Key Features
- Dimensional Analysis: Guarantees physical consistency in all calculations.
- Unit Simplification: Automatically recognizes and simplifies composite units to their standard named forms (e.g., `kg*m/s**2` is displayed as `N`).
- Beautiful Formatting: Renders all units into a clean, human-readable format using Unicode dots for multiplication and superscripts for exponents (e.g., `kg*m**2` becomes `kg·m²`).
- SI Prefix Support: Easily convert between base units and their prefixed forms (e.g., a Quantity of `1000 m` can be converted to `1 km`).
- Extensible: Easily define your own custom units and dimensions.
## Documentation
View the [**official Quantium documentation**](https://quantium.readthedocs.io/) for installation guides, tutorials, and the complete API reference.
## Installation & Setup
Quantium can be installed from the Python Package Index (PyPI):
```bash
pip install quantium
```
After installation, verify that Quantium is correctly installed by checking its version:
```python
import quantium
print("Quantium version:", quantium.__version__)
```
To make sure Quantium is ready to use, open a Python shell and run:
```python
>>> from quantium import u
>>> (10 * u.kg) * (5 * u.m) / (2 * u.s**2)
25 N
```
## Requirements
Quantium is built to work seamlessly in modern environments and is compatible with current development tools and workflows.
Quantium currently supports **Python 3.10 and above**.
## Contributing
Contributions are welcome! If you'd like to fix a bug, add a feature, or improve the documentation, please feel free to open an issue or submit a pull request.
Raw data
{
"_id": null,
"home_page": null,
"name": "quantium",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "Python, open-source, physics, numpy, unit-conversion, dimensional-analysis, units, scientific-computing, quantium",
"author": "Parneet Sidhu",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/17/3f/fb9e4e84d9b19fc73a401d9aeadf6b5533888e4f62acbd5b7d9ff06fa5e6/quantium-0.1.1.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">Quantium</h1>\n\n\n<p align=\"center\">\n <img src=\"https://github.com/user-attachments/assets/f2edd31b-5091-4432-a8c9-34c664aa2b2f\" \n alt=\"Quantium logo\" \n width=\"300\" \n height=\"300\">\n</p>\n\n<p>\n <a href=\"https://badge.fury.io/py/quantium\">\n <img src=\"https://badge.fury.io/py/quantium.svg\" alt=\"PyPI version\">\n </a>\n <a href=\"https://opensource.org/licenses/MIT\">\n <img src=\"https://img.shields.io/badge/License-MIT-blue.svg\" alt=\"License: MIT\">\n </a>\n <a href=\"https://img.shields.io/pypi/pyversions/quantium\">\n <img src=\"https://img.shields.io/pypi/pyversions/quantium\" alt=\"Python Version\">\n </a>\n <a href=\"https://quantium.readthedocs.io/en/latest/\">\n <img src=\"https://readthedocs.org/projects/quantium/badge/?version=latest\" alt=\"Documentation Status\">\n </a>\n <a href=\"https://github.com/YOUR_USERNAME/YOUR_REPONAME/actions\">\n <img src=\"https://github.com/parneetsingh022/quantium/actions/workflows/ci.yml/badge.svg\" alt=\"Build Status\">\n </a>\n <a href=\"http://mypy-lang.org/\">\n <img src=\"https://www.mypy-lang.org/static/mypy_badge.svg\" alt=\"Checked with mypy\">\n </a>\n <a href=\"https://github.com/astral-sh/ruff\">\n <img src=\"https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json\" alt=\"Ruff\">\n </a>\n <a href=\"https://codecov.io/gh/parneetsingh022/quantium\">\n <img src=\"https://codecov.io/gh/parneetsingh022/quantium/graph/badge.svg\" alt=\"Test Coverage\">\n </a>\n <a href=\"https://opensource.org/licenses/MIT\">\n <img src=\"https://img.shields.io/badge/License-MIT-blue.svg\" alt=\"License: MIT\">\n </a>\n <a href=\"https://pepy.tech/project/quantium\">\n <img src=\"https://static.pepy.tech/personalized-badge/quantium?period=total&units=international_system&left_color=black&right_color=blue&left_text=downloads\" alt=\"PyPI Downloads\">\n </a>\n <a href=\"https://github.com/parneetsingh022/quantium/commits/main\">\n <img src=\"https://img.shields.io/github/last-commit/parneetsingh022/quantium\" alt=\"GitHub last commit\">\n </a>\n</p>\n\n### Readable units. Reliable math.\n\n\n\nQuantium is a lightweight Python library for unit-safe scientific and mathematical computation.\n\nIt combines a clean, dependency-minimal architecture with a powerful system for dimensional analysis \u2014 ensuring that every calculation you perform respects physical consistency.\n\n\n\nBeyond correctness, Quantium emphasizes clarity.\n\nIts advanced formatting engine automatically simplifies, normalizes, and beautifully renders units using Unicode superscripts, SI prefixes, and canonical symbols.\n\n\n\n## Key Features\n\n- Dimensional Analysis: Guarantees physical consistency in all calculations.\n\n\n\n- Unit Simplification: Automatically recognizes and simplifies composite units to their standard named forms (e.g., `kg*m/s**2` is displayed as `N`).\n\n\n\n- Beautiful Formatting: Renders all units into a clean, human-readable format using Unicode dots for multiplication and superscripts for exponents (e.g., `kg*m**2` becomes `kg\u00b7m\u00b2`).\n\n\n\n- SI Prefix Support: Easily convert between base units and their prefixed forms (e.g., a Quantity of `1000 m` can be converted to `1 km`).\n\n\n\n- Extensible: Easily define your own custom units and dimensions.\n\n\n\n## Documentation\n\nView the [**official Quantium documentation**](https://quantium.readthedocs.io/) for installation guides, tutorials, and the complete API reference.\n\n\n\n## Installation & Setup\n\nQuantium can be installed from the Python Package Index (PyPI):\n\n\n\n```bash\n\npip install quantium\n\n```\n\n\n\nAfter installation, verify that Quantium is correctly installed by checking its version:\n\n\n\n```python\n\nimport quantium\n\nprint(\"Quantium version:\", quantium.__version__)\n\n```\n\n\n\nTo make sure Quantium is ready to use, open a Python shell and run:\n\n```python\n\n>>> from quantium import u\n\n>>> (10 * u.kg) * (5 * u.m) / (2 * u.s**2)\n\n25 N\n\n```\n\n\n\n## Requirements\n\nQuantium is built to work seamlessly in modern environments and is compatible with current development tools and workflows.\n\n\n\nQuantium currently supports **Python 3.10 and above**.\n\n\n## Contributing\n\nContributions are welcome! If you'd like to fix a bug, add a feature, or improve the documentation, please feel free to open an issue or submit a pull request.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A modern Python library for dimensional analysis and unit-safe scientific computation.",
"version": "0.1.1",
"project_urls": null,
"split_keywords": [
"python",
" open-source",
" physics",
" numpy",
" unit-conversion",
" dimensional-analysis",
" units",
" scientific-computing",
" quantium"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "bcca4c36a757b7c80dca3fb67e4821a4502af5a0e5a11e8b58969bb5150122bc",
"md5": "585acad32308a1df2584dff88c5a0d32",
"sha256": "ff5c094126b3d6b3176df8be21096d77cf76bd090535be89087103ea28ab48dc"
},
"downloads": -1,
"filename": "quantium-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "585acad32308a1df2584dff88c5a0d32",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 26230,
"upload_time": "2025-10-25T17:03:17",
"upload_time_iso_8601": "2025-10-25T17:03:17.751845Z",
"url": "https://files.pythonhosted.org/packages/bc/ca/4c36a757b7c80dca3fb67e4821a4502af5a0e5a11e8b58969bb5150122bc/quantium-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "173ffb9e4e84d9b19fc73a401d9aeadf6b5533888e4f62acbd5b7d9ff06fa5e6",
"md5": "edbbcb08954ef69356633dc06f98b2f6",
"sha256": "2cf3db382676db4d5dea6065b322ea2949335cab54889cfd272501665c535d86"
},
"downloads": -1,
"filename": "quantium-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "edbbcb08954ef69356633dc06f98b2f6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 1433791,
"upload_time": "2025-10-25T17:03:18",
"upload_time_iso_8601": "2025-10-25T17:03:18.873230Z",
"url": "https://files.pythonhosted.org/packages/17/3f/fb9e4e84d9b19fc73a401d9aeadf6b5533888e4f62acbd5b7d9ff06fa5e6/quantium-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-25 17:03:18",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "quantium"
}
JSON