# AutoCal
**__Work in progress. Currently under testing.__**
This Python library provides a comprehensive toolbox of mathematical formulas commonly encountered in the automotive industry, with a particular focus on electric vehicles (EVs) and Brushless DC (BLDC) motors. The library offers a valuable resource for engineers and researchers working on EV components, motor control systems, and related applications.
Developed by [Gladson Thomas](https://www.linkedin.com/in/gladson-thomas/) and [Sumati Ladane](https://www.linkedin.com/in/sumati-ladane-802b511a2/).
This repository provides a collection of mathematical formulas commonly used in the automotive industry, with a particular focus on Brushless DC (BLDC) motors.
## Installation
Binary installers are available at Python [Python Package Index (PyPi)](https://pypi.org/project/autoCal/).
```
pip install autoCal
```
The source code is hosted on github at https://github.com/GladsonOfficial/AutoCal
## Usage
The formulas are categorized into 2 parts. Speed calculations and motor calculations.
**Speed Calculation**: This contains the formulas related to general speed conversions.
List of functions:
```python
wheel_rpm_to_kmph(wheel_rpm: float, tyre_size: float) -> float:
wheel_rpm_to_mph(wheel_rpm: float, tyre_size: float) -> float:
kmph_to_wheel_rpm(kmph: float, tyre_size: float) -> float:
mph_to_wheel_rpm(mph: float, tyre_size: float) -> float:
wheel_rpm_to_time_required_for_one_wheel_rotation(rpm: float) -> float:
kmph_to_time_required_for_one_wheel_rotation(kmph: float, tyre_size: float) -> float:
mph_to_time_required_for_one_wheel_rotation(mph: float, tyre_size: float) -> float:
```
<br><br>
**Motor Calculations**: This contains the formulas related to BLDC motors.
List of functions:
```python
motor_rpm_to_kmph(motor_rpm: float, tyre_size: float, drivetrain_ratio: float) -> float:
motor_rpm_to_mph(motor_rpm: float, tyre_size: float, drivetrain_ratio: float) -> float:
kmph_to_motor_rpm(kmph: float, tyre_size: float, drivetrain_ratio: float) -> float:
mph_to_motor_rpm(mph: float, tyre_size: float, drivetrain_ratio: float) -> float:
wheel_rpm_to_motor_rpm(wheel_rpm: float, drivetrain_ratio: float) -> float:
motor_rpm_to_wheel_rpm(motor_rpm: float, drivetrain_ratio: float) -> float:
motor_rpm_to_one_motor_rotation_time(motor_rpm: float) -> float:
wheel_rpm_to_one_motor_rotation_time(wheel_rpm: float, drivetrain_ratio: float) -> float:
get_hall_events_per_motor_rotation(pole_pairs: int) -> float:
get_hall_events_per_wheel_rotation(pole_pairs: int, drivetrain_ratio: float) -> float:
get_hall_event_interval(motor_rpm: float, pole_pairs: int) -> float:
get_hall_events_per_second(motor_rpm: float, pole_pairs: int) -> float:
get_hall_events_per_minute(motor_rpm: float, pole_pairs: float) -> float:
```
## Examples
Finding time required for wheel to complete one full rotation using km/h
```python
from autoCal import speedCalculations as sc
print(sc.kmph_to_time_required_for_one_wheel_rotation(25, uc.inch_to_m(26)))
```
Raw data
{
"_id": null,
"home_page": null,
"name": "autoCal",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "python, calculations, automotive, EV, BLDC",
"author": "GladsonThomas",
"author_email": "<gladson.thomas.official@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/99/3a/caa5b1fa49fcf8a51468cbf9ca26926a95d72f4abdd6d3a6bb501b7b5e06/autocal-0.0.6.tar.gz",
"platform": null,
"description": "# AutoCal\r\n**__Work in progress. Currently under testing.__**\r\n\r\nThis Python library provides a comprehensive toolbox of mathematical formulas commonly encountered in the automotive industry, with a particular focus on electric vehicles (EVs) and Brushless DC (BLDC) motors. The library offers a valuable resource for engineers and researchers working on EV components, motor control systems, and related applications.\r\n\r\nDeveloped by [Gladson Thomas](https://www.linkedin.com/in/gladson-thomas/) and [Sumati Ladane](https://www.linkedin.com/in/sumati-ladane-802b511a2/).\r\n\r\n\r\nThis repository provides a collection of mathematical formulas commonly used in the automotive industry, with a particular focus on Brushless DC (BLDC) motors.\r\n\r\n## Installation\r\nBinary installers are available at Python [Python Package Index (PyPi)](https://pypi.org/project/autoCal/).\r\n```\r\npip install autoCal\r\n```\r\nThe source code is hosted on github at https://github.com/GladsonOfficial/AutoCal\r\n\r\n## Usage\r\nThe formulas are categorized into 2 parts. Speed calculations and motor calculations.\r\n\r\n**Speed Calculation**: This contains the formulas related to general speed conversions.\r\n\r\nList of functions:\r\n```python\r\nwheel_rpm_to_kmph(wheel_rpm: float, tyre_size: float) -> float:\r\nwheel_rpm_to_mph(wheel_rpm: float, tyre_size: float) -> float:\r\nkmph_to_wheel_rpm(kmph: float, tyre_size: float) -> float:\r\nmph_to_wheel_rpm(mph: float, tyre_size: float) -> float:\r\nwheel_rpm_to_time_required_for_one_wheel_rotation(rpm: float) -> float:\r\nkmph_to_time_required_for_one_wheel_rotation(kmph: float, tyre_size: float) -> float:\r\nmph_to_time_required_for_one_wheel_rotation(mph: float, tyre_size: float) -> float:\r\n```\r\n<br><br>\r\n**Motor Calculations**: This contains the formulas related to BLDC motors.\r\n\r\nList of functions:\r\n```python\r\nmotor_rpm_to_kmph(motor_rpm: float, tyre_size: float, drivetrain_ratio: float) -> float:\r\nmotor_rpm_to_mph(motor_rpm: float, tyre_size: float, drivetrain_ratio: float) -> float:\r\nkmph_to_motor_rpm(kmph: float, tyre_size: float, drivetrain_ratio: float) -> float:\r\nmph_to_motor_rpm(mph: float, tyre_size: float, drivetrain_ratio: float) -> float:\r\nwheel_rpm_to_motor_rpm(wheel_rpm: float, drivetrain_ratio: float) -> float:\r\nmotor_rpm_to_wheel_rpm(motor_rpm: float, drivetrain_ratio: float) -> float:\r\nmotor_rpm_to_one_motor_rotation_time(motor_rpm: float) -> float:\r\nwheel_rpm_to_one_motor_rotation_time(wheel_rpm: float, drivetrain_ratio: float) -> float:\r\nget_hall_events_per_motor_rotation(pole_pairs: int) -> float:\r\nget_hall_events_per_wheel_rotation(pole_pairs: int, drivetrain_ratio: float) -> float:\r\nget_hall_event_interval(motor_rpm: float, pole_pairs: int) -> float:\r\nget_hall_events_per_second(motor_rpm: float, pole_pairs: int) -> float:\r\nget_hall_events_per_minute(motor_rpm: float, pole_pairs: float) -> float:\r\n```\r\n\r\n## Examples\r\nFinding time required for wheel to complete one full rotation using km/h\r\n```python\r\nfrom autoCal import speedCalculations as sc\r\nprint(sc.kmph_to_time_required_for_one_wheel_rotation(25, uc.inch_to_m(26)))\r\n```\r\n",
"bugtrack_url": null,
"license": null,
"summary": "Collection of automotive calculations",
"version": "0.0.6",
"project_urls": null,
"split_keywords": [
"python",
" calculations",
" automotive",
" ev",
" bldc"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5511bba657f33fedb78204486bd191382b033a470015ccdd89e2a5789961208f",
"md5": "8f0b8772ed115d37841196e98c46f21d",
"sha256": "d58cbc8c1c228ca8003d9d1b2ce546ab94cff0f8e9d8bedd8edece6a0683478c"
},
"downloads": -1,
"filename": "autoCal-0.0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8f0b8772ed115d37841196e98c46f21d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 5554,
"upload_time": "2024-06-02T12:42:47",
"upload_time_iso_8601": "2024-06-02T12:42:47.227710Z",
"url": "https://files.pythonhosted.org/packages/55/11/bba657f33fedb78204486bd191382b033a470015ccdd89e2a5789961208f/autoCal-0.0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "993acaa5b1fa49fcf8a51468cbf9ca26926a95d72f4abdd6d3a6bb501b7b5e06",
"md5": "7748214468a60630055c3dc64fde60bd",
"sha256": "068e4fc6caa62ff878f415ad8735a943bf6f87818c284413e18d79a04f745300"
},
"downloads": -1,
"filename": "autocal-0.0.6.tar.gz",
"has_sig": false,
"md5_digest": "7748214468a60630055c3dc64fde60bd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4478,
"upload_time": "2024-06-02T12:43:10",
"upload_time_iso_8601": "2024-06-02T12:43:10.022270Z",
"url": "https://files.pythonhosted.org/packages/99/3a/caa5b1fa49fcf8a51468cbf9ca26926a95d72f4abdd6d3a6bb501b7b5e06/autocal-0.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-02 12:43:10",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "autocal"
}
JSON