eeslib 0.0.1

A Python library for heat transfer and thermodynamics calculations, derived from EES

EESLib

EESLib is a Python library for heat transfer and thermodynamics calculations, derived from Engineering Equation Solver (EES) functions. It is designed for educational use in the ME564 Heat Transfer course at the University of Wisconsin-Madison.

Features

EESLib provides implementations for various engineering calculations including:

Fluid Properties

• Thermodynamic properties (enthalpy, entropy, density, etc.) using CoolProp
• Functions for common fluids with temperature, pressure, and quality inputs
• NOTE: The CoolProp fluid property implementation approach differs from the fluid properties in EES! Do not expect perfect correspondence between properties obtained using either method. CoolProp is generally less robust and slower than the native EES implementation.

Heat Transfer Functions

• Internal Flow: Nusselt number and friction factor calculations for pipe and duct flow (laminar, turbulent, transitional)
• External Flow: Heat transfer and friction for flow over plates, cylinders, and other geometries
• Heat Exchangers: NTU and LMTD calculations for various flow configurations
• Fin Efficiency: Efficiency calculations for fins with various profiles and tip boundary conditions
• Radiation: Blackbody radiation, view factors, and radiative heat transfer functions. Note that a catalog of view factors with number ID assignments is provided in a PDF distributed in the source code folder.

Utilities

• Unit conversions
• Lookup tables for various properties
• Talbot inversion for Laplace transforms
• Result printing and PDF generation utilities

Installation

Prerequisites

• Python 3.11 or higher
• Packages listed in requirements.txt

Install from PyPi

Quick Setup

Open a command window with the same privileges used to install Python.

conda activate me564 
pip install eeslib

Full Setup

1. Download miniconda executable from (https://www.anaconda.com/download/success#miniconda)
2. Run installer:
   • Choose "Just for me" option
   • Check 'yes' for Add Miniconda3 to PATH, and 'yes' for registering as the default Python
3. Download code resources from Canvas: Files/Lectures/examples_<version#>.zip. This folder contains a number of examples that we’ll use in both lecture and homework codes.
4. Create the me564 environment in conda. In the command window, type:

   conda create -n me564 python=3.<latest>
   

5. Open command window (shell). Navigate your command window to the folder you downloaded. For example, type:

   cd C:/path/to/my/folder/examples
   

6. Activate your conda environment. In the command window, type:

   conda activate me564
   

7. Install the EESLib package from PyPi

   pip install eeslib
   

8. Automatic PDF reports are created from EESLib using LaTeX. This requires two tools to be installed on your computer that generate the reports.
   • Download and install the miktex compiler from https://miktex.org/download
   • Miktex uses Perl to run. Download and install Perl from https://www.perl.org/get.html The ‘Strawberry Perl’ version is recommended for Windows.

Install from source

Use this option if you are going to make local changes to the EESLib package source code.

git clone https://github.com/uw-esolab/eeslib.git
cd eeslib
pip install -e .

Usage

Import the library modules as needed:

from eeslib import fluid_properties as fp
from eeslib import internal_flow as iflow
from eeslib import functions as fn

# Get water properties at 100°C and 1 atm
rho = fp.density('Water', T=373.15, P=101325)
print(f"Density: {rho} kg/m³")

# Calculate Nusselt number for pipe flow
Nu, f = iflow.pipeflow_nd(Re=10000, Pr=7, LoverD=50, relRough=0.001)
print(f"Nusselt number: {Nu}, Friction factor: {f}")

# Convert units
temp_c = fn.converttemp('F', 'C', 212)
print(f"212°F = {temp_c}°C")

Modules

Module	Description
fluid_properties.py	Thermodynamic property calculations
internal_flow.py	Heat transfer in pipes and ducts
external_flow.py	External convection heat transfer
heat_exchangers.py	Heat exchanger analysis
fin_efficiency.py	Extended surface heat transfer
radiation.py	Radiative heat transfer and view factors
functions.py	Utility functions, unit conversions
lookup_data.py	Interpolation and lookup tables
talbot_inversion.py	Numerical Laplace transform inversion

License

Portions of this code are derived from Engineering Equation Solver (EES) under license restrictions and is intended for educational use at the University of Wisconsin-Madison.

Contributing

This library is maintained for educational purposes. Please contact the instructor for contributions or modifications.

Testing

EESLib includes a comprehensive test suite to ensure functionality and catch regressions.

Running Tests

Install test dependencies:

pip install -e ".[dev]"

Run all tests:

python run_tests.py

Run specific test file:

python run_tests.py tests/test_fluid_properties.py

Run with coverage:

pip install pytest-cov
python -m pytest --cov=eeslib --cov-report=html

Test Coverage

The test suite covers:

• Fluid Properties: Thermodynamic property calculations using CoolProp
• Unit Conversions: Temperature, length, mass, energy, and other unit conversions
• Internal Flow: Heat transfer and friction factor calculations for pipe flow
• Heat Exchangers: LMTD correction factors and NTU calculations

References

• Engineering Equation Solver (EES)
• CoolProp library for fluid properties
• Heat Transfer by Nellis & Klein, 2007