name	fluid-property-calculator
description	Quick fluid property calculations using empirical formulas without database queries
category	helpers
domain	fluids
complexity	basic
dependencies	[]

Fluid Property Calculator

Quick fluid property calculations using empirical correlations and analytical formulas. Provides instant property estimates without requiring external databases or data files.

Overview

This helper provides fast, practical calculations for common fluids using well-established empirical correlations. All formulas include validity ranges and are verified against reference data.

Available Calculations

Water Properties (0-100°C)

Calculate temperature-dependent properties of liquid water:

Density (kg/m³) - Polynomial correlation
Dynamic viscosity (Pa·s) - Vogel equation
Kinematic viscosity (m²/s) - Derived from dynamic viscosity
Thermal conductivity (W/m·K) - Polynomial correlation
Specific heat capacity (J/kg·K) - Polynomial correlation
Vapor pressure (Pa) - Antoine equation
Prandtl number - Dimensionless heat transfer parameter

Validity Range: 0-100°C at atmospheric pressure Typical Accuracy: ±1-2% for most properties

Air Properties (Standard Atmosphere)

Calculate temperature-dependent properties of air at atmospheric pressure:

Density (kg/m³) - Ideal gas law
Dynamic viscosity (Pa·s) - Sutherland's formula
Kinematic viscosity (m²/s) - Derived from dynamic viscosity
Thermal conductivity (W/m·K) - Polynomial correlation
Specific heat capacity (J/kg·K) - Temperature-dependent correlation
Prandtl number - Dimensionless heat transfer parameter

Validity Range: -50 to 200°C at 101.325 kPa Typical Accuracy: ±1-3% for most properties

Viscosity Correlations

Sutherland's Formula (Gases)

Temperature-dependent viscosity for gases:

μ = μ₀ × (T/T₀)^(3/2) × (T₀ + S)/(T + S)

Available for:

Air (S = 110.4 K)
Nitrogen (S = 111 K)
Oxygen (S = 127 K)
Carbon dioxide (S = 240 K)

Andrade Equation (Liquids)

Temperature-dependent viscosity for liquids:

μ = A × exp(B/T)

Provides empirical correlation for various liquids with custom parameters.

Vapor Pressure (Antoine Equation)

Calculate saturation vapor pressure:

log₁₀(P) = A - B/(C + T)

Available for:

Water
Ethanol
Methanol
Acetone
Benzene
Toluene

Units: Temperature in °C, Pressure in mmHg or Pa (depending on constants)

Dimensionless Numbers

Reynolds Number

Calculate flow regime indicator:

Re = ρ × V × L / μ = V × L / ν

Where:

ρ = density (kg/m³)
V = velocity (m/s)
L = characteristic length (m)
μ = dynamic viscosity (Pa·s)
ν = kinematic viscosity (m²/s)

Interpretation:

Re < 2300: Laminar flow (pipe)
2300 < Re < 4000: Transition
Re > 4000: Turbulent flow (pipe)

Friction Factor Calculator

Laminar Flow (Re < 2300):

f = 64 / Re

Turbulent Flow - Smooth Pipes (Blasius): Valid for Re < 100,000:

f = 0.316 / Re^0.25

Turbulent Flow - Rough Pipes (Colebrook-White): Iterative solution for:

1/√f = -2 log₁₀(ε/3.7D + 2.51/(Re√f))

Where:

ε = absolute roughness (m)
D = pipe diameter (m)

Swamee-Jain Approximation (non-iterative):

f = 0.25 / [log₁₀(ε/3.7D + 5.74/Re^0.9)]²

Ideal Gas Properties

Calculate properties using ideal gas law and kinetic theory:

Density: ρ = P/(R×T)
Specific heat ratio: γ (for common gases)
Speed of sound: a = √(γ×R×T)
Molar mass: M (for common gases)

Usage Examples

Example 1: Water Properties at 20°C

from calc import water_properties

props = water_properties(20)
print(f"Density: {props['density']:.2f} kg/m³")
print(f"Viscosity: {props['dynamic_viscosity']:.6f} Pa·s")
print(f"Thermal conductivity: {props['thermal_conductivity']:.4f} W/m·K")

Example 2: Reynolds Number for Pipe Flow

from calc import reynolds_number, water_properties

T = 25  # °C
V = 1.5  # m/s
D = 0.05  # m

props = water_properties(T)
Re = reynolds_number(V, D, props['kinematic_viscosity'])
print(f"Reynolds number: {Re:.0f}")

Example 3: Friction Factor Calculation

from calc import friction_factor

Re = 50000
roughness = 0.045e-3  # 0.045 mm for commercial steel
diameter = 0.1  # m

f = friction_factor(Re, roughness, diameter)
print(f"Friction factor: {f:.5f}")

Example 4: Vapor Pressure of Water

from calc import antoine_vapor_pressure

T = 80  # °C
P_vap = antoine_vapor_pressure('water', T)
print(f"Vapor pressure at {T}°C: {P_vap/1000:.2f} kPa")

Example 5: Air Viscosity using Sutherland's Formula

from calc import sutherland_viscosity

T = 100  # °C
mu = sutherland_viscosity('air', T + 273.15)  # Convert to Kelvin
print(f"Air viscosity at {T}°C: {mu:.6f} Pa·s")

Quick Reference

Common Water Properties

T (°C)	ρ (kg/m³)	μ (mPa·s)	ν (mm²/s)	k (W/m·K)	Pr
0	999.8	1.787	1.787	0.561	13.5
20	998.2	1.002	1.004	0.598	7.0
40	992.2	0.653	0.658	0.631	4.3
60	983.2	0.467	0.475	0.654	3.0
80	971.8	0.355	0.365	0.670	2.2
100	958.4	0.282	0.294	0.680	1.8

Common Air Properties (at 101.325 kPa)

T (°C)	ρ (kg/m³)	μ (μPa·s)	ν (mm²/s)	k (W/m·K)	Pr
0	1.293	17.16	13.27	0.0243	0.71
20	1.205	18.24	15.14	0.0257	0.71
50	1.093	19.57	17.90	0.0279	0.71
100	0.946	21.67	22.90	0.0314	0.71

Limitations

Temperature Ranges: Correlations are only valid within specified ranges
Pressure Effects: Most correlations assume atmospheric pressure
Pure Substances: Mixtures require different approaches
Accuracy: Empirical formulas provide estimates (±1-5% typical)
Phase Changes: Properties near phase transitions may be less accurate

When to Use This Helper

Good for:

Quick engineering calculations
Preliminary design work
Educational purposes
When databases are unavailable
Rapid prototyping

Not suitable for:

High-precision scientific work
Properties outside validity ranges
Non-standard conditions (high pressure, etc.)
Complex mixtures
When accuracy better than ±1% is required

Best Practices

Check validity ranges before using any correlation
Verify units - most functions use SI units (K for temperature in Sutherland, °C elsewhere)
Compare results with reference data when possible
Use appropriate significant figures based on correlation accuracy
Document assumptions in your calculations

Additional Resources

See reference.md for:

Complete correlation equations
Literature sources
Validation data
Accuracy comparisons
Alternative formulations