Skip to main content

Library for estimating state of charge from battery cell voltage

Project description

batsoc - State of Charge (Battery)

Got a cell voltage and would like to know how much charge is left? batsoc to the rescue!

Installation

pip install batsoc

Accuracy

Measuring state of charge based on voltage alone is not terribly accurate. The measured voltage depends on multiple factors besides the state of charge: temperature and load affect matters as well.

Usage

from batsoc import soc, BatteryType
soc(BatteryType.ALKALINE, 1.3)

will output 0.633 indicating 63.3% state of charge.

Supported batteries

ALKALINE

Any generic 1.5V alkaline battery under low load. The curve is defined for 0.8 - 1.6 volts.

LI_ION

Any generic lithium-ion battery with a nominal voltage of 3.7 or 3.8. The curve is defined for 3.0 - 4.2 volts.

CR2032

A 3V lithium coin cell battery under very low load. The curve is defined for 2.0 - 3.0 volts.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

batsoc-0.9.3.tar.gz (6.2 kB view details)

Uploaded Source

Built Distribution

batsoc-0.9.3-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file batsoc-0.9.3.tar.gz.

File metadata

  • Download URL: batsoc-0.9.3.tar.gz
  • Upload date:
  • Size: 6.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for batsoc-0.9.3.tar.gz
Algorithm Hash digest
SHA256 b6a210165654843d6278afe44da3d6ee58edc1773fa4968beffa6c8e665ab484
MD5 c7f244cdedaa66084acd69321273e4f5
BLAKE2b-256 fa00c5a9e48da35d882f3c504c462bd95e16e7dfac64d724dbed4e5377369bcf

See more details on using hashes here.

File details

Details for the file batsoc-0.9.3-py3-none-any.whl.

File metadata

  • Download URL: batsoc-0.9.3-py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for batsoc-0.9.3-py3-none-any.whl
Algorithm Hash digest
SHA256 f7ab6a2b749a52e4fe6d7ad884b3da7cf825c01bd0c876053eb2517753816cc7
MD5 1eaba460ad485df81ab8c5b9d92896a2
BLAKE2b-256 888da46be871a7e4877abd7bf68cf44aa923e6b63ba05891bcfa12e085a97681

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page