|
11 | 11 | - Useful for thermodynamics, refrigeration, and heating applications. |
12 | 12 | - Simplifies accessing and calculating fluid properties programmatically. |
13 | 13 |
|
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 | + |
15 | 20 | ```bash |
16 | 21 | pip install proptables |
17 | 22 | ``` |
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 |
21 | 31 | ``` |
22 | | -## Usage |
23 | 32 |
|
24 | | -### Basic Usage |
25 | | -Import the library |
| 33 | +--- |
| 34 | + |
| 35 | +## Importing Components |
| 36 | + |
| 37 | +To use the library, import the required components as follows: |
26 | 38 |
|
27 | 39 | ```python |
28 | 40 | 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 | +``` |
29 | 68 |
|
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 | +--- |
33 | 75 |
|
| 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 | +``` |
34 | 84 |
|
| 85 | +### By Temperature and Enthalpy |
| 86 | +```python |
| 87 | +R134a(Temperature=34, Enthalpy=112) |
| 88 | +``` |
35 | 89 |
|
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) |
39 | 93 | ``` |
40 | 94 |
|
| 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