Skip to content

Commit a0b82b7

Browse files
authored
Merge pull request #6 from Buddhi19/Buddhi19-patch-2
Update README.md
2 parents a49e29c + e48fb29 commit a0b82b7

File tree

1 file changed

+98
-13
lines changed

1 file changed

+98
-13
lines changed

README.md

Lines changed: 98 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -11,30 +11,115 @@
1111
- Useful for thermodynamics, refrigeration, and heating applications.
1212
- Simplifies accessing and calculating fluid properties programmatically.
1313

14-
# To Install
14+
# proptables: User Manual
15+
16+
## Installation
17+
18+
To install the `proptables` library, run the following command in your terminal or command prompt:
19+
1520
```bash
1621
pip install proptables
1722
```
18-
## How to use
19-
```python
20-
from proptables import R134a,water
23+
24+
### Example Output (Google Colab):
25+
```plaintext
26+
Looking in indexes: https://pypi.org/simple, https://us-python.pkg.dev/colab-wheels/public/simple/
27+
Collecting proptables
28+
Downloading proptables-0.0.7-py3-none-any.whl (32 kB)
29+
Installing collected packages: proptables
30+
Successfully installed proptables-0.0.7
2131
```
22-
## Usage
2332

24-
### Basic Usage
25-
Import the library
33+
---
34+
35+
## Importing Components
36+
37+
To use the library, import the required components as follows:
2638

2739
```python
2840
from proptables import R134a, water
41+
```
42+
43+
---
44+
45+
## Using Water Tables
46+
47+
The `water` function can be used for various thermodynamic properties. Example usages:
48+
49+
### By Pressure
50+
```python
51+
water(Pressure=200)
52+
```
53+
54+
### By Pressure and Enthalpy
55+
```python
56+
water(Pressure=200, Enthalpy=1500)
57+
```
58+
59+
### By Temperature
60+
```python
61+
water(Temperature=54)
62+
```
63+
64+
### By Temperature and Entropy
65+
```python
66+
water(Temperature=54, Entropy=5)
67+
```
2968

30-
data = r134a.temperature(Temperature=None,Pressure=None,
31-
Enthalpy=None,Entropy=None,
32-
specificvolume=None,Superheated=None,Compressed=None) # Mention the values as needed to obtain the dataframe with all details
69+
### Example with Superheated Property
70+
```python
71+
water(Pressure=4000, Superheated=True)
72+
```
73+
74+
---
3375

76+
## Using R134a Tables
77+
78+
The `R134a` function supports similar property queries. Example usages:
79+
80+
### By Temperature
81+
```python
82+
R134a(Temperature=36)
83+
```
3484

85+
### By Temperature and Enthalpy
86+
```python
87+
R134a(Temperature=34, Enthalpy=112)
88+
```
3589

36-
data = water.enthalpy(Temperature=None,Pressure=None,
37-
Enthalpy=None,Entropy=None,
38-
specificvolume=None,Superheated=None,Compressed=None)
90+
### By Pressure
91+
```python
92+
R134a(Pressure=600)
3993
```
4094

95+
### Example with Superheated Property
96+
```python
97+
R134a(Pressure=1200, Superheated=True)
98+
```
99+
100+
---
101+
102+
## Data Tables
103+
104+
The library provides detailed thermodynamic tables for water and R134a. Below are some examples:
105+
106+
### Water Table (Pressure-based)
107+
| MPa | degC | vf | vg | uf | ug | hf | hfg | hg | sf | sfg | sg |
108+
|-----|-------|--------|--------|-------|-------|-------|--------|-------|--------|--------|--------|
109+
| 25 | 0.2 | 0.001061 | 0.8857 | 504.5 | 2529.1 | 504.7 | 2201.5 | 2706.2 | 1.5302 | 5.5967 | 7.1269 |
110+
111+
### R134a Table (Temperature-based)
112+
| degC | kPa | vf | vg | uf | ug | hf | hfg | hg | sf | sfg | sg |
113+
|------|-------|--------|--------|-------|-------|-------|--------|-------|--------|--------|--------|
114+
| 31 | 36.0 | 0.00086 | 0.0224 | 101.55 | 249.1 | 102.33 | 167.17 | 269.5 | 0.3761 | 0.5407 | 0.9168 |
115+
116+
---
117+
118+
## Reporting Issues
119+
120+
If you encounter any errors or issues, please report them on the library's [GitHub page](https://github.com/Buddhi19/PythonLibrary-proptables).
121+
122+
---
123+
124+
# Thank you for using `proptables`!
125+

0 commit comments

Comments
 (0)