Metadata-Version: 2.4
Name: litrue-battery-calc
Version: 0.1.0
Summary: A professional Python library for lithium battery capacity, SOH, and PACK calculations.
Home-page: https://www.litruebattery.com/
Author: LiTrue Battery
Author-email: info@litruebattery.com
Project-URL: Homepage, https://www.litruebattery.com/
Project-URL: Battery Guide, https://www.litruebattery.com/blog/
Project-URL: LiTrue Products, https://www.litruebattery.com/products/
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-python
Dynamic: summary

# LiTrue Battery Calculator

[![PyPI Version](https://img.shields.io/pypi/v/litrue-battery-calc.svg)](https://pypi.org/project/litrue-battery-calc/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

`litrue-battery-calc` is a professional, open-source Python library designed for engineers, system integrators, and hobbyists to calculate custom lithium-ion battery pack configurations, state of health (SOH), and gravimetric energy densities.

Whether you are designing a solar energy storage system, an electric vehicle battery pack, or custom industrial power solutions, this library provides precise mathematical models to streamline your engineering workflow.

For professional custom hardware solutions and industrial-grade manufacturing, please visit the [LiTrue Battery Official Website](https://www.litruebattery.com/).

---

## Features

- **PACK Configuration Calculator**: Quickly determine the required series (S) and parallel (P) structure, cell count, and total energy capacity (Wh) based on target voltage and capacity.
- **Energy Density Calculator**: Compute the exact gravimetric energy density ($Wh/kg$) of your custom battery designs.
- **Extensible Architecture**: Clean, object-oriented code structured to easily integrate into larger renewable energy modeling systems.

---

## Installation

You can install the stable release of `litrue-battery-calc` directly from PyPI:

```bash
pip install litrue-battery-calc
