https://github.com/sinagilassi/pycuc
Python Custom Unit Converter
https://github.com/sinagilassi/pycuc
chemical-engineering custom-unit-converter pycuc unit-converter
Last synced: 8 months ago
JSON representation
Python Custom Unit Converter
- Host: GitHub
- URL: https://github.com/sinagilassi/pycuc
- Owner: sinagilassi
- License: mit
- Created: 2024-09-18T03:30:16.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-18T07:14:50.000Z (about 1 year ago)
- Last Synced: 2024-09-18T10:56:32.447Z (about 1 year ago)
- Topics: chemical-engineering, custom-unit-converter, pycuc, unit-converter
- Language: Python
- Homepage: https://pycuc.readthedocs.io/en/latest/
- Size: 13.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Python Custom Unit Converter (PyCUC)
    
Python Custom Unit Converter (PyCUC) is an open-source package designed to simplify unit conversions in Python. With PyCUC, you can effortlessly create custom conversion factors, convert between units, and streamline calculations in various fields, such as physics, engineering, and scientific computing.
**Key Features:**
* Custom Conversion Factors: Define your own conversion factors for unique units.
* Flexible Unit Conversions: Convert between units with ease, using a simple and intuitive methods.
* Lightweight: Minimal dependencies and optimized for performance.
* Easy to Use: Simple installation and straightforward usage.
## Google Colab
You can use the following code to run `PyCUC` in Google Colab:
[](https://colab.research.google.com/drive/1AbTCZxz9xH0VxKCh-Qhb66X0GAGo9_0y?usp=sharing)
## Installation
Install PyCUC with pip
```python
import pycuc
# check version
print(pycuc.__version__)
```
## Usage Example 1
* CHECK REFERENCES
```python
print(pycuc.check_reference('pressure'))
```
* CREATE A CUSTOM UNIT CONVERTER
```python
# ! pressure
my_cuc_1 = pycuc.create_cuc(1, 'MPa')
# convert to Pa
print(my_cuc_1.convert('Pa'))
print(my_cuc_1.convert('bar'))
print(my_cuc_1.convert('kPa'))
# ! temperature
my_cuc_2 = pycuc.create_cuc(358, 'K')
# convert to K
print(my_cuc_2.convert('C'))
print(my_cuc_2.convert('F'))
print(my_cuc_2.convert('R'))
```
* CONVERT FROM TO
```python
# ! pressure
print(pycuc.convert_from_to(1, 'MPa', 'Pa'))
# ! temperature
print(pycuc.convert_from_to(358, 'K', 'C'))
print(pycuc.convert_from_to(25, 'C', 'K'))
```
* CONVERT FROM TO (short format)
```python
# ! pressure
print(pycuc.to(125, 'MPa => Pa'))
# ! temperature
print(pycuc.to(360, 'K => C'))
print(pycuc.to(250, 'C => K'))
```
* DEFINE A NEW UNIT
```python
# ! heat capacity unit: J/mol.K
my_cuc_3 = pycuc.create_cuc(25, 'J/mol.K')
# add custom
my_cuc_3.add_custom_unit('J/mol.K', 1)
my_cuc_3.add_custom_unit('kJ/mol.K', 1000)
# conversion
print(my_cuc_3.convert('J/mol.K'))
print(my_cuc_3.convert('kJ/mol.K'))
```
* CHECK REFERENCE
```python
# ! pressure
print(my_cuc_3.check_reference('pressure'))
# ! temperature
print(my_cuc_3.check_reference('temperature'))
# ! custom
print(my_cuc_3.check_reference('custom'))
```
## Usage Examples 2
* LOAD `CUSTOM UNIT` FROM `YML FILES`
```python
# load unit yml file
unit_file = os.path.join(os.getcwd(), 'test', 'custom-unit.yml')
my_cuc = pycuc.go(reference_file=unit_file)
```
* `from_to` METHOD AS:
```python
# ! pressure
print(my_cuc.from_to(1, 'MPa', 'Pa'))
```
* `to` METHOD AS:
```python
# ! pressure
print(my_cuc.to(125, 'MPa => Pa'))
```
* CHECK REFERENCES:
```python
# ! from yml file
print(my_cuc.check_reference('custom::CUSTOM'))
print(my_cuc.check_reference('custom::HEAT-CAPACITY'))
print(my_cuc.check_reference('custom::ENERGY'))
```
## FAQ
For any question, contact me on [LinkedIn](https://www.linkedin.com/in/sina-gilassi/)
## Authors
- [@sinagilassi](https://www.github.com/sinagilassi)