Anda di halaman 1dari 246

Users Guide

for
Property Library LibHuAirProp
for Real Humid Air, Steam, Water, and Ice

FluidEXL for Excel


FluidLAB for MATLAB
FluidMAT for Mathcad
FluidEES for EES
Version 2.0
I-P and SI units

Add-in functions for use with

ASHRAE Humid Air Properties

Library of Psychrometric, Thermodynamic, and Transport Properties


for Real Humid Air, Steam, Water, and Ice
Based on ASHRAE Research Project RP-1485 and
Physikalisch-Technische Bundesanstalt Report PTB-CP-3

Hans-Joachim Kretzschmar
Sebastian Herrmann
Prepared by

KRETZSCHMAR
CONSULTING
ENGINEERS
www.thermofluidprop.com

Ines Stoecker
Matthias Kunick
Mariana Nicke
Donald P. Gatley

2010 American Society of Heating, Refrigerating and Air-Conditioning


Engineers, Inc. All rights reserved.
DISCLAIMER
ASHRAE has compiled this publication with care, but ASHRAE has not investigated,
and ASHRAE expressly disclaims any duty to investigate, any product, service,
process, procedure, design, or the like that may be described herein. The appearance
of any technical data or editorial material in this publication does not constitute
endorsement, warranty, or guaranty by ASHRAE of any product, service, process,
procedure, design, or the like. ASHRAE does not warrant that the information in the
publication is free of errors, and ASHRAE does not necessarily agree with any
statement or opinion in this publication. The entire risk of the use of any information in
this publication is assumed by the user.
LICENSING AGREEMENT
Using this product indicates your acceptance of the terms and conditions of this
agreement. The title and all copyrights and ownership rights of the product are retained
by ASHRAE. You assume responsibility for the selection of the product to achieve your
results and for the installation, use, and results obtained from the product.
This product is for use by one individual, with permission to install it on up to two
computers (such as a desktop and a laptop) at the same time. You may also copy the
product into any computer-readable form for backup purposes. You may not copy or
transfer the product except as expressly provided for in this license. Specifically, you
may not copy or transfer the product onto a computer other than your own unless the
person to whom you are copying or transferring the product also has a license to use it.
Doing so will result in the automatic termination of your license. Distribution to third
parties is expressly forbidden.
The program and data contained in the product are for your personal use only.
Personal use includes showing the information at a meeting or group setting and
allowing other individuals to view the content. Personal use does not include making
copies, in whole or in part, of the content for the purposes of distribution, reusing the
information contained in the product in your own presentation, or posting any of the
files on a server for access by others. You shall not merge, adapt, translate, modify,
rent, lease, sell, sublicense, assign, or otherwise transfer any of the content. To obtain
permission to copy and paste this publications content for other than only personal
use, go to www.ashrae.org/permissions.

ISBN 978-1-933742-74-8

LibHuAirProp Product Information


Do you need property values for moist air in I-P or SI units in your daily work?
Use the property library LibHuAirProp

Do you need these properties in Excel, MATLAB, Mathcad, or EES?


Use the add-ins FluidEXL, FluidLAB, FluidMAT, or FluidEES

What properties can be calculated using this software?


thermodynamic properties
transport properties

psychrometric functions
backward functions

What range of state is covered by this property library?


unsaturated and saturated moist air
supersaturated moist air (liquid fog and ice fog)
temperatures from 143.15C (225.67F) to 350C (662F)
pressures from 0.01 kPa (0.00145 psi) to 10,000 kPa (1450.4 psi)

What are the references of LibHuAirProp?


Tables for moist air properties in the 2009 ASHRAE Handbook of Fundamentals were calculated
using LibHuAirProp

Thermodynamic and psychrometric property algorithms from ASHRAE Research Project 1485

Transport properties of moist air from the PTB Report PTB-CP-3 and the related paper in the
Journal of Engineering for Gas Turbines and Power

Properties of dry air from the NIST Reference Equation of Lemmon et al. and properties of steam,
water, and ice from the Industrial Formulation IAPWS-IF97, the Scientific Formulation IAPWS-95,
and other current IAPWS formulations

Who are the authors of LibHuAirProp?


Dr. Hans-Joachim Kretzschmar
Professor for Technical Thermodynamics
Sebastian Herrmann
External scientific co-worker
Dr. Ines Stoecker
Matthias Kunick
Mariana Nicke
Scientific co-workers
Zittau/Goerlitz University of Applied Sciences, Germany
Donald P. Gatley
ASHRAE Fellow
Gatley & Associates, Inc., Atlanta, GA

Property Library for Real Humid Air,


Steam, Water, and Ice
ASHRAE-LibHuAirProp

Contents
Package Contents ...................................................................................................................... 0/1

ZIP file "CD_FluidEXL_ASHRAE_LibHuAirProp.zip" for Excel " .......................................... 0/1

ZIP file "CD_FluidLAB_ASHRAE_LibHuAirProp.zip" for MATLAB " .................................... 0/1

ZIP file "CD_FluidMAT_ASHRAE_LibHuAirProp.zip" for Mathcad " .................................... 0/1

ZIP file "CD_FluidEES_ASHRAE_LibHuAirProp.zip" for Engineering Equation Solver " ..... 0/1
Part I-P Units ..................................................................................................................... I-P - 1/1
1 Property Library ASHRAE-LibHuAirProp-IP ................................................................. I-P - 1/2
1.1 Function Overview .................................................................................................. I-P - 1/2
1.1.1
1.1.2
1.1.3

Function Overview for Real Moist Air ......................................................... I-P - 1/2


Function Overview for Steam and Water for Temperatures t 32F .......... I-P - 1/6
Function Overview for Steam and Ice for Temperatures t 32F............... I-P - 1/8

1.2 Conversion of SI and I-P Units ............................................................................. I-P - 1/10


1.3 Calculation Algorithms .......................................................................................... I-P - 1/13
1.3.1
1.3.2
1.3.3
1.3.4

Algorithms for Real Moist Air .................................................................... I-P - 1/13


Algorithms for Steam and Water for Temperatures t 32F..................... I-P - 1/14
Algorithms for Steam and Ice for Temperatures t 32F ......................... I-P - 1/14
Overview of the Applied Formulations for Steam, Water, and Ice ............ I-P - 1/14

2 Add-Ins for ASHRAE-LibHuAirProp-IP ......................................................................... I-P - 2/1


2.1 Add-In FluidEXL

Graphics

for Excel .......................................................................... I-P - 2/1


Graphics

2.1.1
2.1.2

Installing FluidEXL
including LibHuAirProp ...................................... I-P - 2/1
Example: Calculation of h = f(p,t,W) ........................................................... I-P - 2/9

2.1.3

Removing FluidEXL

Graphics

including LibHuAirProp .................................. I-P - 2/13

2.2 Add-In FluidLAB for MATLAB ............................................................................. I-P - 2/17


2.2.1
2.2.2
2.2.3
2.2.4

Installing FluidLAB including LibHuAirProp .............................................. I-P - 2/17


Example: Calculation of h = f(p,t,W) in an M-File ..................................... I-P - 2/22
Example: Calculation of h = f(p,t,W) in the Command Window ................ I-P - 2/26
Removing FluidLAB including LibHuAirProp ............................................ I-P - 2/31
H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

2.3 Add-In FluidMAT for Mathcad ............................................................................ I-P - 2/32


2.3.1
2.3.2
2.3.3

Installing FluidMAT including LibHuAirProp ............................................. I-P - 2/32


Example: Calculation of h = f(p,t,W) ......................................................... I-P - 2/36
Removing FluidMAT including LibHuAirProp ........................................... I-P - 2/39

2.4 Add-In FluidEES for Engineering Equation Solver ............................................. I-P - 2/40
2.4.1
2.4.2
2.4.3

Installing FluidEES including LibHuAirProp .............................................. I-P - 2/40


Example: Calculation of h = f(p,t,W) ......................................................... I-P - 2/43
Removing FluidEES including LibHuAirProp ............................................ I-P - 2/46

3 Description of the Property Functions of ASHRAE-LibHuAirProp-IP ........................... I-P - 3/1


3.1 Functions for Real Moist Air ................................................................................... I-P - 3/1
3.2 Functions for Steam and Water for Temperatures t 32F ................................. I-P - 3/42
3.3 Functions for Steam and Ice for Temperatures t 32F ...................................... I-P - 3/54
4 Property Libraries for Calculating Heat Cycles, Boilers, Turbines, and Refrigerators . I-P - 4/1
5 References ................................................................................................................... I-P - 5/1
Part SI Units....................................................................................................................... SI - 1/1
1 Property Library ASHRAE-LibHuAirProp-SI.................................................................. SI - 1/2
1.1 Function Overview................................................................................................... SI - 1/2
1.1.1
1.1.2
1.1.3

Function Overview for Real Moist Air .......................................................... SI - 1/2


Function Overview for Steam and Water for Temperatures t 0C ............ SI - 1/6
Function Overview for Steam and Ice for Temperatures t 0C ................. SI - 1/8

1.2 Conversion of SI and I-P Units .............................................................................. SI - 1/10


1.3 Calculation Algorithms........................................................................................... SI - 1/13
1.3.1
1.3.2
1.3.3
1.3.4

Algorithms for Real Moist Air ..................................................................... SI - 1/13


Algorithms for Steam and Water for Temperatures t 0C ....................... SI - 1/14
Algorithms for Steam and Ice for Temperatures t 0C ........................... SI - 1/14
Overview of the Applied Formulations for Steam, Water, and Ice ............. SI - 1/14

2 Add-Ins for ASHRAE-LibHuAirProp-SI.......................................................................... SI - 2/1


2.1 Add-In FluidEXL

Graphics

for Excel .......................................................................... SI - 2/1


Graphics

2.1.1
2.1.2

Installing FluidEXL
including LibHuAirProp....................................... SI - 2/1
Example: Calculation of h = f(p,t,W) ............................................................ SI - 2/2

2.1.3

Removing FluidEXL

Graphics

including LibHuAirProp..................................... SI - 2/5

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

2.2 Add-In FluidLAB for MATLAB ................................................................................ SI - 2/6


2.2.1
2.2.2
2.2.3
2.2.4

Installing FluidLAB including LibHuAirProp ................................................. SI - 2/6


Example: Calculation of h = f(p,t,W) in an M-File ........................................ SI - 2/7
Example: Calculation of h = f(p,t,W) in the Command Window ................. SI - 2/14
Removing FluidLAB including LibHuAirProp ............................................. SI - 2/16

2.3 Add-In FluidMAT for Mathcad ............................................................................. SI - 2/17


2.3.1
2.3.2
2.3.3

Installing FluidMAT including LibHuAirProp ............................................... SI - 2/17


Example: Calculation of h = f(p,t,W) .......................................................... SI - 2/18
Removing FluidMAT including LibHuAirProp ............................................. SI - 2/21

2.4 Add-In FluidEES for Engineering Equation Solver .............................................. SI - 2/22


2.4.1
2.4.2
2.4.3

Installing FluidEES including LibHuAirProp ............................................... SI - 2/22


Example: Calculation of h = f(p,t,W) .......................................................... SI - 2/23
Removing FluidEES including LibHuAirProp ............................................. SI - 2/26

3 Description of the Property Functions of ASHRAE-LibHuAirProp-SI ............................ SI - 3/1


3.1 Functions for Real Moist Air..................................................................................... SI - 3/1
3.2 Functions for Steam and Water for Temperatures t 0C .................................... SI - 3/42
3.3 Functions for Steam and Ice for Temperatures t 0C ......................................... SI - 3/54
4 Property Libraries for Calculating Heat Cycles, Boilers, Turbines, and Refrigerators ... SI - 4/1
5 References .................................................................................................................... SI - 5/1

________________________________________________________________________

Kretzschmar
Consulting Engineers
Rathener Str. 6
01259 Dresden, Germany
Phone: +49-3583-61-1846
Fax: +49-3583-61-1846
E-mail: info@thermofluidprop.com
Internet: www.thermofluidprop.com

Prof. Hans-Joachim Kretzschmar


Sebastian Herrmann
Dr. Ines Stoecker
Matthias Kunick
Mariana Nicke
Donald P. Gatley

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

0/1

Package Contents
The following ZIP files are delivered depending on which Add-In(s) you have purchased.

ZIP file "CD_FluidEXL_ASHRAE_LibHuAirProp.zip" for Excel "


The ZIP file contains the following files:
FluidEXL_Graphics_LibHuAirProp_Eng_Setup.exe

Installation program for the FluidEXL

Add-In for use in Excel

ASHRAE_LibHuAirProp_Users_Guide.pdf

Users Guide

Graphics

ZIP file "CD_FluidLAB_ASHRAE_LibHuAirProp.zip" for MATLAB "


The ZIP file contains the following files:
FluidLAB_LibHuAirProp_Setup.exe

Installation program for the FluidLAB Add-In

for use in MATLAB

ASHRAE_LibHuAirProp_Users_Guide.pdf

Users Guide

ZIP file "CD_FluidMAT_ASHRAE_LibHuAirProp.zip" for Mathcad "


The ZIP file contains the following files:
FluidMAT_LibHuAirProp_Setup.exe

Installation program for the FluidMAT Add-In

for use in Mathcad

ASHRAE_LibHuAirProp_Users_Guide.pdf

Users Guide

ZIP file "CD_FluidEES_ASHRAE_LibHuAirProp.zip" for Engineering Equation Solver "


The ZIP file contains the following files:
FluidEES_LibHuAirProp_Setup.exe

Installation program for the FluidEES Add-In

for use in Engineering Equation Solver

ASHRAE_LibHuAirProp_Users_Guide.pdf

Users Guide

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

Part I-P Units

I-P 1/2

1 Property Library ASHRAE-LibHuAirProp-IP


1.1 Function Overview
1.1.1 Function Overview for Real Moist Air
Functional
Dependence

Function Name

Property or Function

Unit of the
Result

a = f( p, t ,W )

a_ptW_HAP_IP

Thermal diffusivity

ft/s

3/2

p = f( p, t ,W )

alphap_ptW_HAP_IP

Relative pressure coefficient

1/R

3/3

p = f( p, t ,W )

betap_ptW_HAP_IP

Isothermal stress coefficient

lb/ft

3/4

c = f( p, t ,W )

c_ptW_HAP_IP

Speed of sound

ft/s

3/5

c p = f( p, t ,W )

cp_ptW_HAP_IP

Specific isobaric heat capacity

Btu/(lbR)

3/6

cv = f( p, t ,W )

cv_ptW_HAP_IP

Specific isochoric heat capacity

Btu/(lbR)

3/7

f = f( p, t )

f_pt_HAP_IP

Enhancement factor (decimal ratio)

3/8

h = f( p, t ,W )

h_ptW_HAP_IP

Air-specific enthalpy

Btu/lba

3/9

= f( p, t ,W )

Eta_ptW_HAP_IP

Dynamic viscosity

lbs/ft

3/10

= f( p, t ,W )

Kappa_ptW_HAP_IP

Isentropic exponent

3/11

= f( p, t ,W )

Lambda_ptW_HAP_IP

Thermal conductivity

Btu/(hftR)

3/12

= f( p, t ,W )

Ny_ptW_HAP_IP

Kinematic viscosity

ft/s

3/13

p = f(t , s,W )

p_tsW_HAP_IP

Pressure of humid air

psi

3/14

p = f( zele )

p_zele_HAP_IP

Pressure of humid air from elevation

psi

3/15

pAir = f( p, t ,W )

pAIR_ptW_HAP_IP

Partial pressure of dry air in moist air

psi

3/16

pH2O = f( p, t ,W )

pH2O_ptW_HAP_IP

Partial pressure of water vapor in moist air

psi

3/17

pH2Os = f( p, t )

pH2Os_pt_HAP_IP

Partial saturation pressure of water vapour in moist air

psi

3/18

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

Page

I-P 1/3
Functional
Dependence

Function Name

Property or Function

Unit of the
Result

Page

= f( p, t ,W )

phi_ptW_HAP_IP

Relative humidity (decimal ratio)

3/19

Pr = f( p, t ,W )

Pr_ptW_HAP_IP

PRANDTL number

3/20

Air = f(W )

PsiAir_W_HAP_IP

Mole fraction of dry air in moist air

mola/mol

3/21

H2O = f(W )

PsiH2O_W_HAP_IP

Mole fraction of water vapor in moist air

molw/mol

3/22

= f( p, t ,W )

Rho_ptW_HAP_IP

Density

lb/ft

3/23

s = f( p, t ,W )

s_ptW_HAP_IP

Air-specific entropy

Btu/(lbR)

3/24

t = f( p, h, )

t_phphi_HAP_IP

Backward function: temperature from total pressure, air-specific


enthalpy and relative humidity

3/25

t = f( p, h,W )

t_phW_HAP_IP

Backward function: temperature from total pressure, enthalpy and


humidity ratio

3/26

t = f( p, s,W )

t_psW_HAP_IP

Backward function: temperature from total pressure, entropy and


humidity ratio

3/27

t = f( p, t wb ,W )

t_ptwbW_HAP_IP

Backward function: temperature from total pressure, wet-bulb


temperature and humidity ratio

3/28

t d = f( p,W )

td_pW_HAP_IP

Dew-point/frost-point temperature

3/29

t s = f( p, pH2O )

ts_ppH2O_HAP_IP

Backward function: saturation temperature of water from total pressure F


and partial pressure of water vapor

3/30

t wb = f( p, t ,W )

twb_ptW_HAP_IP

Wet-bulb/ice-bulb temperature

3/31

u = f( p, t ,W )

u_ptW_HAP_IP

Air-specific internal energy

Btu/lba

3/32

v = f( p, t ,W )

v_ptW_HAP_IP

Air-specific volume

ft/lba

3/33

W = f( p, t, pH2O )

W_ptpH2O_HAP_IP

Humidity ratio from total pressure, temperature, and partial pressure of lbw/lba
water vapor

3/34

W = f( p, t , )

W_ptphi_HAP_IP

Humidity ratio from total pressure, temperature, and relative humidity

lbw/lba

3/35

W = f( p, td )

W_ptd_HAP_IP

Humidity ratio from total pressure and dew-point temperature

lbw/lba

3/36

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 1/4
Functional
Dependence

Function Name

Property or Function

Unit of the
Result

Page

W = f( p, t , t wb )

W_pttwb_HAP_IP

Humidity ratio from total pressure, (dry bulb) temperature, and wetbulb temperature

lbw/lba

3/37

Ws = f( p, t )

Ws_pt_HAP_IP

Saturation humidity ratio

lbw/lba

3/38

Air = f(W )

XiAir_W_HAP_IP

Mass fraction of dry air in moist air

lba/lb

3/39

H2O = f(W )

XiH2O_W_HAP_IP

Mass fraction of water vapor in moist air

lbw/lb

3/40

Z = f( p, t ,W )

Z_ptW_HAP_IP

Compression factor (decimal ratio)

3/41

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 1/5

Range of Validity of Thermodynamic Properties


Property

Units

Range of Validity

Symbol

Quantity

Unit

Pressure:

0.00145

1450.4

psi

Pressure

psi

Temperature:

225.67

662

Temperature

Humidity ratio:

10

lbw/lba

Humidity ratio

lbw/lba (lb water / lb dry air)

Relative humidity:

(decimal ratio)

Relative humidity

(decimal ratio)

Dew-point temperature: 225.67

td

662

td

Dew point temperature

Wet-bulb temperature:

t wb

662

twb

Wet bulb temperature

225.67

Range of Validity of Transport Properties


Property

Range of Validity
p 1450.4 psi

0.00145

99.67

662

Humidity ratio:

10

lbw/lba

Relative humidity:

(decimal ratio)

Pressure:
Temperature:

Molar Masses
Molar Mass

Reference

Dry Air

63.859 lb/kmol

[17]

Water

39.7168998 lb/kmol

[5], [6]

Component

Reference States
Property

Dry Air
14.6959 psi

Steam, Water, and Ice


ps(32.018F) = 0.088714 psi

32F

32.018F

Enthalpy

0 Btu/lb

0.00026301926 Btu/lb

Entropy

0 Btu/(lb*R)

0 Btu/(lb*R)

Pressure
Temperature

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 1/6

1.1.2 Function Overview for Steam and Water for Temperatures t 32F
Functional
Dependence

Function Name

Property or Function

Unit of the
Result

Page

hliq = f( p, t )

hliq_pt_97_IP

Specific enthalpy of liquid water

Btu/lb

3/43

hliq,s = f(t )

hliqs_t_97_IP

Specific enthalpy of saturated liquid water

Btu/lb

3/44

hvap,s = f(t )

hvaps_t_97_IP

Specific enthalpy of saturated water vapor

Btu/lb

3/45

ps = f(t )

ps_t_97_IP

Saturation pressure of water

psi

3/46

sliq = f( p, t )

sliq_pt_97_IP

Specific entropy of liquid water

Btu/(lbR)

3/47

sliq,s = f(t )

sliqs_t_97_IP

Specific entropy of saturated liquid water

Btu/(lbR)

3/48

svap,s = f(t )

svaps_t_97_IP

Specific entropy of saturated water vapor

Btu/(lbR)

3/49

ts = f( p )

ts_p_97_IP

Saturation temperature of water

3/50

v liq = f( p, t )

vliq_pt_97_IP

Specific volume of liquid water

ft/lb

3/51

v liq,s = f(t )

vliqs_t_97_IP

Specific volume of saturated liquid water

ft/lb

3/52

v vap,s = f(t )

vvaps_t_97_IP

Specific volume of saturated water vapor

ft/lb

3/53

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 1/7

Range of Validity
Property
Pressure:
Temperature:

Units

Range of Validity
0.00145 p
1450.4 psi
F
32 t
662

Symbol

Quantity

Unit

Pressure

psi

Temperature

Reference State
Property
Pressure
Temperature

Water Vapor and Liquid Water


ps(32.018F) = 0.088714 psi
32.018F

Enthalpy

0.00026301926 Btu/lb

Entropy

0 Btu/(lb*R)

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 1/8

1.1.3 Function Overview for Steam and Ice for Temperatures t 32F
Functional
Dependence

Function Name

Property

Unit of the
Result

Page

hice,sub = f(t )

hicesub_t_06_IP

Specific enthalpy of saturated ice

Btu/lb

3/55

hvap,sub = f(t )

hvapsub_t_95_IP

Specific enthalpy of saturated water vapor

Btu/lb

3/56

pmel = f(t )

pmel_t_08_IP

Melting pressure of ice

psi

3/57

psub = f(t )

psub_t_08_IP

Sublimation pressure of ice

psi

3/58

sice,sub = f(t )

sicesub_t_06_IP

Specific entropy of saturated ice

Btu/(lbR)

3/59

svap,sub = f(t )

svapsub_t_95_IP

Specific entropy of saturated water vapor

Btu/(lbR)

3/60

tmel = f( p )

tmel_p_08_IP

Melting temperature of ice

3/61

tsub = f( p )

tsub_p_08_IP

Sublimation temperature of ice

3/62

v ice,sub = f(t )

vicesub_t_06_IP

Specific volume of saturated ice

ft/lb

3/63

v vap,sub = f(t )

vvapsub_t_95_IP

Specific volume of saturated water vapor

ft/lb

3/64

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 1/9

Range of Validity
Property
Pressure:
Temperature:

Units

Range of Validity
psub(225.67F) = 1.7407E-12 p
225.67 t

1450.4 psi
F
32

Symbol

Quantity

Unit

Pressure

psi

Temperature

Reference State
Property

Pressure
Temperature

Water Vapor and Ice


ps(32.018F) = 0.088714 psi

32.018F

Enthalpy

0.00026301926 Btu/lb

Entropy

0 Btu/(lb*R)

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 1/10

1.2 Conversion of SI and I-P Units


Property

Conversion: SI Units I-P Units

Thermal diffusivity

Relative pressure

coefficient
Isothermal stress

coefficient

Speed of sound

Specific isobaric

cp

heat capacity

Specific isochoric
heat capacity

Dynamic viscosity

Enhancement
factor

Conversion: I-P Units SI Units

aIP aSI
=
10.76391042
ft
m
s
s

aSI aIP
=
0.0929304
m
ft
s
s

p,IP

p,SI

1
R
p,IP
lb
ft

p,SI
1
K
p,SI
kg
m

9
5

0.062428

1
K
p,SI
kg
m

p,IP
1
R
p,IP
lb
ft

5
9

16.018463

cIP cSI
=
3.2808399
ft
m
s
s

cSI cIP
=
0.3048
m
ft
s
s

c p,IP

c p,SI

Btu
lb R

c p,SI
kJ
kg K

0.2388459

kJ
kg K

c p,IP
Btu
lb R

4.1868

Units SI

Units I-P

m/s

ft/s

1/K

1/R

kg/m

lb/ft

m/s

ft/s

kJ/(kgK)

Btu/(lbR)

cv

cv ,IP
cv ,SI
=
0.2388459
Btu
kJ
lb R kg K

cv ,SI
cv ,IP
=
4.1868
kJ
Btu
kg K lb R

kJ/(kgK)

Btu/(lbR)

IP
= SI 0.02088543
lb s Pa
ft
s

SI

= IP 47.880259
Pa lb s
s
ft

Pas

lbs/ft

fIP = fSI

fSI = fIP

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 1/11

Property

Conversion: SI Units I-P Units

Air-specific
enthalpy

(moist air)
Specific enthalpy
(water, water

exponent
Thermal
conductivity
Kinematic
viscosity

hSI
kJ
kga

Units SI

Units I-P

= IP 7.68565365666 2.326
Btu

lb

kJ/kga

Btu/lba

kJ/kg

Btu/lb

W/(mK)

Btu/(hftR)

m/s

ft/s

kPa

psi

hw

hIP hSI
=
0.4299226
Btu kJ
lb
kg

hSI hIP
=
2.326
kJ Btu
kg
lb

IP = SI

SI = IP

Btu
h ft R

vapor, ice)
Isentropic

h
hIP
= SI 0.4299226 + 7.68565365666
Btu
kJ
lba
kga

Conversion: I-P Units SI Units

IP

SI

W
mK

SI

0.57778932

W
mK

= SI 10.763910417
ft m
s
s
p
pIP
= SI 0.14503774
psi kPa

SI

IP

IP

Btu
h ft R

1.73073467

= IP 0.092903040
m ft
s
s
pSI pIP
=
6.894757
kPa psi

Pressure

Relative humidity

IP = SI

SI = IP

Prandtl number

Pr

PrIP = PrIP

PrSI = PrIP

Mole fraction

IP = SI

SI = IP

mol/mol

mol/mol

Density

kg/m

lb/ft

kJ/(kgaK)

Btu/(lbaR)

Air-specific
entropy
(moist air)

IP
lb
ft

sIP

Btu
lba R

SI
kg
m
=

SI

0.062428

sSI
kJ
kga K

kg
m

0.2388459 + 0.01616365106

IP
lb
ft

16.018463

sSI
s
= IP 0.01616365106 4.1868
kJ
Btu

kga K lba R

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 1/12

Property

Conversion: SI Units I-P Units

Specific entropy
(water, water

sw

vapor, ice)
Temperature

Air-specific
internal energy

(moist air)

volume

sSI
sIP
=
4.1868
kJ
Btu
kga K lba R

tIP tSI 9
=
+ 32
F C 5

tSI tIP
5
=
32
C F
9

(u = h pv )

(u = h pv )

uIP
=
Btu
lba

IP

(moist air)
Specific volume
(water, water

sSI
sIP
=
0.23884589
Btu
kJ
lba R kga K

hSI
0.4299226 + 7.68565365666
kJ
kga

p
SI 0.145037738 SI 16.018453
m
kPa
kga

Air-specific

vw

vapor, ice)

Conversion: I-P Units SI Units

ft
lba

IP
ft
lb

SI
m
kga

16.018453

= SI 16.018453
m
kg

uSI
h

= IP 7.68565365666 2.236
kJ
Btu

kga
lba

p
IP 6.894757293 SIP 0.062428
ft
psi
lba

SI
m
kga

SI
m
kg

= IP 0.062428
ft
lba

= IP 0.062428
ft
lb

Units SI

Units I-P

kJ/(kgaK)

Btu/(lbaR)

kJ/kga

Btu/lb

m/kga

ft/lba

m/kg

ft/lb

Humidity ratio

WIP = WSI

WSI = WIP

kgw/kga

lbw/lba

Mass fraction

IP = SI

SI = IP

kgw/kg

lbw/lb

ZIP = ZSI

ZSI = ZIP

Compression
factor

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 1/13

1.3 Calculation Algorithms


1.3.1 Algorithms for Real Moist Air
The properties of moist air are calculated from the modified Hyland-Wexler model given in Herrmann,
Kretzschmar, and Gatley (HKG) [1], [2]. The modifications incorporate:

the value for the universal molar gas constant from the CODATA standard by Mohr and Taylor
[22]
the value for the molar mass of dry air from Gatley et al. [17] and that of water from IAPWS-95
[5], [6]
the calculation of the ideal-gas parts of the heat capacity, enthalpy, and entropy for dry air from
the fundamental equation of Lemmon et al. [14]
the calculation of the ideal-gas parts of the heat capacity, enthalpy, and entropy for water
vapor from IAPWS-IF97 [7], [8], [9] for t 32F and from IAPWS-95 [5], [6] for t 32F

the calculation of the vapor-pressure enhancement factor from the equation given by the
models of Hyland and Wexler [21]
the calculation of the second and third molar virial coefficients Baa and Caaa for dry air from
the fundamental equation of Lemmon et al. [14]
the calculation of the second and third molar virial coefficients Bww and Cwww for water and
steam from IAPWS-95 [5], [6]
the calculation of the air-water second molar cross-virial coefficient Baw from Harvey and
Huang [15]
the calculation of the air-water third molar cross-virial coefficients Caaw and Caww from Nelson
and Sauer [12], [13]
the calculation of the saturation pressure of water from IAPWS-IF97 [7], [8], [9] for t 32F
and of the sublimation pressure of water from IAPWS-08 [11] for t 32F
the calculation of the isothermal compressibility of saturated liquid water from IAPWS-IF97 [7],
[8], [9] for t 32F and that of ice from IAPWS-06 [10] for t 32F in the determination of the
vapor-pressure enhancement factor
the calculation of Henry's constant from the IAPWS Guideline 2004 [16] in the determination of
the enhancement factor. The mole fractions for the three main components of dry air were
taken from Lemmon et al. [14]. Argon was not considered in the calculation of Henrys constant
in the former research projects, but it is now the third component of dry air.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 1/14

1.3.2 Algorithms for Steam and Water for Temperatures t 32F


The p-T diagram in Fig. 1 shows the formulations used for water and water vapor. The temperature
range above 32F is covered by IAPWS-IF97 [7], [8], [9]:

The saturation line is calculated from the IAPWS-IF97 saturation pressure equation ps97 (t )
and saturation temperature equation ts97 ( p ) .

The properties in the liquid region including saturated-liquid line are calculated from the
fundamental equation of the IAPWS-IF97 region 1.

The properties in the vapor region including saturated-vapor line are calculated from the
fundamental equation of the IAPWS-IF97 region 2.

1.3.3 Algorithms for Steam and Ice for Temperatures t 32F

08
The sublimation curve is covered by the IAPWS-08 sublimation pressure equation psubl
(t )
[11] (see Fig. 1).

The properties of ice including saturated ice are determined by the fundamental equation of
the IAPWS-06 [10].

The properties of vapor including saturated vapor are calculated from the fundamental
equation of IAPWS-95 [5], [6].

1.3.4 Overview of the Applied Formulations for Steam, Water, and Ice
The following p-T diagram shows the used IAPWS Formulations and the ranges where they are
applied.
p / 1E+6
kPa
1E+5
10

10

1E+2

Ice
IAPWS-06

1E+1
10
1E+0
10

tc = 705.103 F

Liquid
IAPWS-IF97
Region 1

1E+3
10

ps97 ( t )

p = 0.08865 psi

10

1E-5
10

t = 662 F

1E-4
10

t = 32 F

1E-3
10

t = -225.67 F

1E-1

1E-2
10

Vapor
IAPWS-IF97
Region 2

08
psubl
(t )

10

1E-6

1E-7
10

pc = 3278.4 psi

p = 1450.4 psi

1E+4
10

Vapor
IAPWS-95

1E-8
10
1E-9
10
1E-10
10

p = 741 x 10 12 psi

1E-11
10
1E-12
10

-200

-150

-100

-50

50

100

150

200

250

300

Figure 1: p-T diagram with used IAPWS formulations for steam, water, and ice.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

350

400
t / C

I-P 2/1

Add-Ins for ASHRAE-LibHuAirProp-IP

2.1

Graphics

Add-In FluidEXL

for Excel

The FluidEXLGraphics Add-In has been developed to calculate thermophysical properties in Excel

more conveniently. Within Excel , it enables the direct call of functions relating to real moist air,
steam, water, and ice from the ASHRAE-LibHuAirProp-IP property library.

2.1.1 Installing FluidEXL

Graphics

including LibHuAirProp

In this section, the installation of FluidEXLGraphics and both LibHuAirProp_IP and LibHuAirProp_SI
is described.

Before you begin, it is best to close any Windows applications, since Windows may need to be
rebooted during the installation process.
After you have downloaded and extracted the zip-file "CD_FluidEXL_ASHRAE_LibHuAirProp.zip",
you will see the folder
CD_FluidEXL_ASHRAE_LibHuAirProp

in your Windows Explorer , Norton Commander or any other similar program you may be using.
Now, open this folder by double-clicking on it.
Within this folder you will see the following files:
ASHRAE_LibHuAirProp_Users_Guide.pdf
FluidEXL_Graphics_LibHuAirProp_Setup.exe.
In order to run the installation of FluidEXLGraphics including the ASHRAE-LibHuAirProp-IP property
library double-click the file
FluidEXL_Graphics_LibHuAirProp_Setup.exe.

Installation may start with a window noting that all Windows programs should be closed. When
this is the case, the installation can be continued. Click the "Next >" button.
In the following dialog box, "Choose Destination Location", the default path offered automatically for
the installation of FluidEXLGraphics is
C:\Program Files\FluidEXL_Graphics_Eng
By clicking the "Browse" button, you can change the installation directory before installation (see
figure below).

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/2

Figure 2.1.1: "Choose Destination Location"


Finally, click on "Next >" to continue installation; click "Next >" again in the "Start Installation"
window which follows in order to start the installation of FluidEXLGraphics.
After FluidEXLGraphics has been installed, the sentence "FluidEXL Graphics LibHuAirProp has
been successfully installed." will be shown. Confirm this by clicking the "Finish" button.
The installation of FluidEXLGraphics has been completed.
During the installation process the following files
advapi32.dll
Dformd.dll
Dforrt.dll
FluidEXL_Graphics_Eng.xla
FluidGraph.ocx
INSTALL_EXL.LOG
LC.dll
LCKCE.dll
LibHuAirProp_IP.dll
LibHuAirProp_IP.hlp
LibHuAirProp_SI.dll
LibHuAirProp_SI.hlp
msvcp60.dll
msvcrt.dll
UNWISE.EXE
have been copied into the chosen destination folder, in the standard case
C:\Program Files\FluidEXL_Graphics_Eng.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/3

Registering FluidEXLGraphics as an add-in in Excel versions 2003 and earlier

After installing FluidEXLGraphics, the program must be registered as an Add-In in Excel . In order

to do so, start Excel and carry out the following steps:

- Click "Tools" in the upper menu bar of Excel .


- Here, click the "Add-Ins..." menu item.
After a short delay the "Add-Ins" dialog box will appear.
- Click "Browse...."
- In the following dialog box, click your chosen destination folder (the standard being
C:\Program Files\FluidEXL_Graphics_Eng)
here click "FluidEXL_Graphics_Eng.xla" and afterwards click "OK."
- Now, the entry "FluidEXL Graphics Eng" appears in the Add-Ins list.
Note:
As long as the check box next to the file name "FluidEXL Graphics Eng" is ticked, this

Add-In will be loaded automatically every time you start Excel until you untick the box by clicking
on it again.
In order to register "FluidEXL Graphics Eng" as an Add-In click "OK" in the "Add-Ins" dialog box.

Now, the new FluidEXLGraphics menu bar will appear in the upper menu area of your Excel
screen, marked with a red circle in Figure 2.1.2:

Figure 2.1.2: Menu bar of FluidEXLGraphics


You can now select the "ASHRAE-LibHuAirProp-IP" DLL property functions for moist air out of

Excel via this menu bar (see part 2.1.2).

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/4

Registering FluidEXL

Graphics

as Add-In in Excel, version 2007 (or later)

After installation in Windows , FluidEXLGraphics must be registered in Excel as from version 2007

as an Add-In. For this, start Excel and carry out the following steps:

- Click the Windows Office button in the upper left corner of Excel

- Click on the "Excel Options" button in the menu which pops up (see figure below)

Figure 2.1.3: Registering FluidEXLGraphics as Add-In in Excel 2007

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/5

- Click on "Add-Ins" in the next menu

Figure 2.1.4: Dialog window "Add-Ins"


- Should it not be shown in the list automatically, choose and click on "Excel Add-ins" (found next
to "Manage:" in the lower area of the menu)
- Then click the "Go" button
- Click "Browse" in the following window and locate the destination folder, in the standard case
C:\Program Files\FluidEXL_Graphics_Eng, within that folder click on the file named
"FluidEXL_Graphics_Eng.xla" and then click the "OK" button.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/6

Figure 2.1.5: Dialog window "Add-Ins available"


- Now, "FluidEXL Graphics Eng" is shown in the Add-Ins list.
(If a check-mark is situated in the box next to the name "FluidEXL Graphics Eng", this Add-In will

automatically be loaded whenever Excel starts. This will continue to occur unless the checkmark is removed from the box by clicking on it again.)

Figure 2.1.6: Dialog window "Add-Ins"


- In order to register the Add-In click the "OK" button in the "Add-Ins" window.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/7

In order to use FluidEXLGraphics in the following example, click on the menu item "Add-Ins" which
is shown in the image.

Figure 2.1.7: Menu item "Add-Ins"

In the upper menu region of Excel , the FluidEXLGraphics menu bar will appear as marked with the
red circle in the next image.

Figure 2.1.8: FluidEXLGraphics menu bar

The installation of FluidEXLGraphics in Excel version 2007 (or later) is now finished.

FluidEXLGraphics can be used analogous to the description of Excel until version 2007.
The FluidEXL

Graphics

Help System

As mentioned earlier, FluidEXLGraphics also provides detailed online help functions. For general

information in Excel :
- Click on "?" and then "Help" in the FluidEXLGraphics menu bar.
Information on individual property functions may be accessed via the following steps:
- Click "Calculate" in the FluidEXLGraphics menu bar.
- Search and click the "ASHRAE-LibHuAirProp-IP" library under
"Or select a category:" in the "Insert Function" window which will appear.
- Click the "Help on this function" button in the lower left-hand edge of the "Insert Function"
window.
- If the "Office Assistant" is active, first double-click "Help on this feature" and in the next menu
click "Help on selected function".
If the "LibHuAirProp_IP.hlp" function help cannot be found, confirm the question whether you want
to look for it yourself with "Yes". Search and click on the "LibHuAirProp_IP.hlp" file in the
installation menu of FluidEXLGraphics in the window which is opened, in the standard case
C:\Program Files\FluidEXL_Graphics_Eng
and click "Yes" in order to complete the search.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/8

Licensing the LibHuAirProp Property Library

The licensing procedure must be carried out when Excel starts up and a FluidEXLGraphics prompt
message appears. In this case, you will see the "License Information" window for LibHuAirProp
(see figure below).

Figure 2.1.9: "License Information" window


Here you are asked to type in the license key which you have obtained from Kretzschmar
Consulting Engineers. If you do not have this, or have any questions, you will find contact
information on the "Content" page of this Users Guide or by clicking the yellow question mark in
the "License Information" window. Then the following window will appear:

Figure 2.1.10: "Help" window

If you do not enter a valid license it is still possible to start Excel by clicking "Cancel" twice. In this
case, the LibHuAirProp property library will display the result "11111111" for every calculation.

The "License Information" window will appear every time you start Excel unless you uninstall
FluidEXLGraphics according to the description in section 2.1.3 of this Users Guide.
Should you not wish to license the LibHuAirProp property library, you have to delete the files
LibHuAirProp_IP.dll
LibHuAirProp_IP.hlp

LibHuAirProp_SI.dll
LibHuAirProp_SI.hlp

in the installation folder of FluidEXLGraphics (the standard being


C:\Program Files\FluidEXL_Graphics_Eng)

using an appropriate program such as Explorer or Norton Commander .


With this procedure both the LibHuAirProp-SI and LibHuAirProp-IP property libraries have been
licensed.
H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/9

2.1.2 Example: Calculation of h = f(p,t,W)


We will now calculate, step by step, the air-specific enthalpy h of real moist air as a function of total
pressure p, temperature t and humidity ratio W, using FluidEXLGraphics. The following description

relates to Excel 2003. The procedure is analogous for Excel 97, 2000, XP, and 2007.
Please carry out the following steps:

Start Excel

Enter the value for p in psi into a cell


(Range of validity:
p = 0.00145 1450.4 psi
e.g.: Enter the value 14.6959 into cell A2

Enter the value for t in F into a cell


(Range of validity:
t = 226.67 ... 662 F)
e.g.: Enter the value 68 into cell B2

Enter the value for W in lbw/lba (lb water per lb dry air) into a cell
(Range of validity: W = 0 10 lbw/lba)
e.g.: Enter the value 0.01 into cell C2

Click the cell in which the air-specific enthalpy h in Btu/lba is to be displayed


e.g.: Click the cell D2

Click "Calculate" in the FluidEXLGraphics menu bar


The "Insert Function" window appears (see Figure 2.1.11.)

Figure 2.1.11: Choosing the library and function name

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/10

- Search and click the "ASHRAE-LibHuAirProp-IP" library under "Or select a category:" in
the upper part of the window
- Search and click the "h_ptW_HAP_IP" function under "Select a function:" right below
- Click the "OK button
The "Function Arguments" menu for the function "h_ptW_HAP_IP" in the next figure will now
appear.

Figure 2.1.12: Input menu for the function


- The cursor is now situated on the line next to "p in psi". You can now enter the value for the
mixture pressure p either by clicking the cell with the value for p, by entering the name of the
cell, or by entering the value for p directly into the line next to "p in psi".
e. g.: Click the cell A2
- Situate the cursor on the line next to "t in F" and enter the value for t either by clicking the
cell with the value for t, by entering the name of the cell, or by entering the value for t directly
into the line next to "t in F".
e. g.: Type B2 into the line next to "t in F"
- Situate the cursor on the line next to "W in lbw/lba" and enter the value for the humidity ratio
W either by clicking the cell with the value for W, by entering the name of the cell, or by
entering the value for W directly into the line next to "W in lbw/lba.
e. g.: Click the cell C2
- Here it is possible to get detailed information on the "h_ptW_HAP_IP" property function.
H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/11

- Click the blue "Help on this function" link in the lower left-hand edge of the "Function Arguments"
window.
You may be informed that the "LibHuAirProp_IP.hlp" function help cannot be found. In this case,
confirm the question whether you want to look for it yourself with "Yes". Search and click on the
"LibHuAirProp_IP.hlp" file in the installation menu of FluidEXLGraphics in the window which is
opened, in the standard case
C:\Program Files\FluidEXL_Graphics_Eng
and click "Yes" in order to complete the search.
- Now you should see the help page of the "h_ptW_HAP_IP" property function (see
Figure 2.1.13).

Figure 2.1.13: Help page for the "h_ptW_HAP_IP" function


- Click the "OK" button
The result for h in lb/lba appears in the cell selected above.
The cell D2 now contains the value 27.24138183.
The calculation of h = f(p,t,W) has thus been completed.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/12

You can now arbitrarily change the values for p, t or W in the appropriate cells. The specific

enthalpy h is recalculated and updated every time you change the data. This shows that the Excel
data flow and the DLL calculations are working together successfully

Note:
If the calculation results in -1000, this indicates that the values entered are located outside the
range of validity of real moist air. More detailed information on each function and its range of
validity is available in Chapter 3.
For further property functions calculable in FluidEXLGraphics see the function table in Chapter 1.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/13

2.1.3 Removing FluidEXL

Graphics

including LibHuAirProp

Should you wish to remove only the LibHuAirProp-IP library, delete the files
LibHuAirProp_IP.dll and LibHuAirProp_IP.hlp
in the directory selected for the installation of FluidEXLGraphics (in the standard case
C:\Program Files\FluidEXL_Graphics_Eng)

by using an appropriate program such as Windows Explorer , or Norton Commander .


Should you wish to remove only the LibHuAirProp-SI library, delete the files
LibHuAirProp_SI.dll and LibHuAirProp_SI.hlp
in the directory selected for the installation of FluidEXLGraphics (in the standard case
C:\Program Files\FluidEXL_Graphics_Eng)

by using an appropriate program such as Windows Explorer , or Norton Commander .


Unregistering FluidEXL

Graphics

as Add-In in Excel up to version 2003

To remove FluidEXLGraphics and both LibHuAirProp_IP and LibHuAirProp_SI completely, proceed

as follows: First the registration of FluidEXL_Graphics_Eng.xla has to be cancelled in Excel .

In order to do that, click "Tools" in the upper menu bar of Excel and here "Add-Ins". Untick the
box on the left-hand side of
"FluidEXL Graphics Eng"
in the window that appears and click the "OK" button. The additional FluidEXLGraphics menu bar

disappears from the upper menu of the Excel window. Afterwards, we recommend closing Excel .
Within the next step delete the files
LibHuAirProp_IP.dll, LibHuAirProp_IP.hlp,
LibHuAirProp_SI.dll, LibHuAirProp_SI.hlp
in the installation directory of FluidEXLGraphics, in the standard case
C:\Program Files\FluidEXL_Graphics_Eng,

using an appropriate program such as Explorer or Norton Commander .

In order to remove FluidEXLGraphics from Windows and the hard disk drive, click "Start" in the

Windows task bar, select "Settings" and click "Control Panel".


Now double-click on "Add or Remove Programs".
In the list box of the "Add or Remove Programs" window that appears select "FluidEXL Graphics
LibHuAirProp" by clicking on it and click the "Add/Remove" button.
In the following dialog box click "Automatic" and thereafter "Next >".
Click "Finish" in the "Perform Uninstall" window.
Answer the question whether all shared components shall be removed with "Yes to All". Finally,

close the "Add or Remove Programs" and "Control Panel" windows .


Now FluidEXLGraphics has been removed.
H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/14

Unregistering FluidEXL

Graphics

as Add-In in Excel, version 2007 (or later)

In order to unregister the FluidEXLGraphics Add-In in Excel 2007 start Excel and carry out the
following commands:

- Click the Windows Office button in the upper left corner of Excel

- Click on the "Excel Options" button in the menu which pops up

Figure 2.1.14: Unregistering FluidEXLGraphics as Add-In in Excel 2007

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/15

- Click on "Add-Ins" in the next menu

Figure 2.1.15: Dialog window "Add-Ins"


- If it is not shown in the list automatically, chose and click "Excel Add-ins" next to "Manage:" in
the lower area of the menu
- Afterwards click the "Go" button
- Remove the checkmark in front of "FluidEXL Graphics Eng" in the window which now appears.
Click the "OK" button to confirm your entry.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/16

Figure 2.1.16: Dialog window "Add-Ins"


In order to remove FluidEXLGraphics from Windows and the hard drive, click "Start" in the Windows
task bar, select "Settings" and click "Control Panel". Now, double click on "Add or Remove
Programs." In the list box of the "Add or Remove Programs" window that appears, select
"FluidEXL Graphics Eng" by clicking on it and then clicking the "Add/Remove" button. Click
"Automatic" in the following dialog box and then "Next >". Click "Finish" in the "Perform Uninstall"
window. Answer the question of whether all shared components should be removed with "Yes to
All". Finally, close the "Add or Remove Programs" and "Control Panel" windows.
Now FluidEXLGraphics has been completely removed from your computer.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/17

2.2 Add-In FluidLAB for MATLAB

The FluidLAB Add-In has been developed to calculate thermodynamic properties in MATLAB
more conveniently. Within MATLAB it enables the direct call of functions relating to real moist air,
steam, water, and ice from the ASHRAE-LibHuAirProp-IP property library.

2.2.1 Installing FluidLAB including LibHuAirProp


This section describes the installation of both FluidLAB LibHuAirProp_IP and LibHuAirProp_SI.

Before you begin, it is best to close any Windows applications, since Windows may need to be
rebooted during the installation process.
After you have downloaded and extracted the zip-file "CD_FluidLAB_ASHRAE_LibHuAirProp.zip",
you will see the folder
CD_FluidLAB_ASHRAE_LibHuAirProp
in your Windows Explorer, Norton Commander or other similar program you are using.
Open this folder by double-clicking on it.
In this folder you will see the following two files:
ASHRAE_LibHuAirProp_Users_Guide.pdf
FluidLAB_LibHuAirProp_Setup.exe.
In order to run the installation of FluidLAB including, the ASHRAE-LibHuAirProp property library,
double-click on the file
FluidLAB_LibHuAirProp_Setup.exe.
Installation may start with a window noting that all Windows programs should be closed. When
this is the case, the installation can be continued. Click the "Next >" button.
In the following dialog box, "Destination Location", the default path offered automatically for the
installation of FluidLAB is
C:\Program Files\FluidLAB\LibHuAirProp
By clicking the "Browse" button, you can change the installation directory before installation (see
figure below).

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/18

Figure 2.2.1: "Destination Location"


If you wish to change directories, click the "Browse" button and select your desired directory. The
instructions in this documentation refer to the stated default directory. Leave this window by clicking
the "Next >" button.
The dialog window "Start Installation" pops up. Click the "Next >" button to continue installation.
The FluidLAB files are now being copied into the created directory on your hard drive. Click the
"Finish >" button in the following window to complete installation.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/19

The installation program has copied the following files for LibHuAirProp_IP and LibHuAirProp_SI
into the directory "C:\Program Files\FluidLAB\LibHuAirProp":
advapi32.dll
Dformd.dll

LCKCE.dll
msvcp60.dll

Dforrt.dll

msvcrt.dll

INSTALL.LOG

Unwise.exe

LibHuAirProp_IP.dll

Unwise.ini

LibHuAirProp_SI.dll

- MATLAB-Interface-Program for calculable functions


a_ptW_HAP_IP

v_ptW_HAP_IP

alphap_ptW_HAP_IP

W_ptpH2O_HAP_IP

betap_ptW_HAP_IP

W_ptphi_HAP_IP

c_ptW_HAP_IP

W_ptd_HAP_IP

cp_ptW_HAP_IP

W_pttwb_HAP_IP

cv_ptW_HAP_IP

Ws_pt_HAP_IP

Eta_ptW_HAP_IP

XiAir_W_HAP_IP

f_pt_HAP_IP

XiH2O_W_HAP_IP

h_ptW_HAP_IP

Z_ptW_HAP_IP

Kappa_ptW_HAP_IP

hliq_pt_97_IP

Lambda_ptW_HAP_IP

hliqs_t_97_IP

Ny_ptW_HAP_IP

hvaps_t_97_IP

p_tsW_HAP_IP

ps_t_97_IP

p_zele_HAP_IP

sliq_pt_97_IP

pAIR_ptW_HAP_IP

sliqs_t_97_IP

pH2O_ptW_HAP_IP

svaps_t_97_IP

pH2Os_pt_HAP_IP

ts_p_97_IP

phi_ptW_HAP_IP

vliq_pt_97_IP

PR_ptW_HAP_IP

vliqs_t_97_IP

PsiAir_W_HAP_IP

vvaps_t_97_IP

PsiH2O_W_HAP_IP

hicesub_t_06_IP

Rho_ptW_HAP_IP

hvapsub_t_95_IP

s_ptW_HAP_IP

pmel_t_08_IP

t_phphi_HAP_IP

psub_t_08_IP

t_phW_HAP_IP

sicesub_t_06_IP

t_psW_HAP_IP

svapsub_t_95_IP

t_ptwbW_HAP_IP

tmel_p_08_IP

td_pW_HAP_IP

tsub_p_08_IP

ts_ppH2O_HAP_IP

vicesub_t_06_IP

twb_ptW_HAP_IP

vvapsub_t_95_IP

u_ptW_HAP_IP

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/20

- MATLAB-Interface-Program for calculable functions


a_ptW_HAP_SI

v_ptW_HAP_SI

alphap_ptW_HAP_SI

W_ptpH2O_HAP_SI

betap_ptW_HAP_SI

W_ptphi_HAP_SI

c_ptW_HAP_SI

W_ptd_HAP_SI

cp_ptW_HAP_SI

W_pttwb_HAP_SI

cv_ptW_HAP_SI

Ws_pt_HAP_SI

Eta_ptW_HAP_SI

XiAir_W_HAP_SI

f_pt_HAP_SI

XiH2O_W_HAP_SI

h_ptW_HAP_SI

Z_ptW_HAP_SI

Kappa_ptW_HAP_SI

hliq_pt_97_SI

Lambda_ptW_HAP_SI

hliqs_t_97_SI

Ny_ptW_HAP_SI

hvaps_t_97_SI

p_tsW_HAP_SI

ps_t_97_SI

p_zele_HAP_SI

sliq_pt_97_SI

pAIR_ptW_HAP_SI

sliqs_t_97_SI

pH2O_ptW_HAP_SI

svaps_t_97_SI

pH2Os_pt_HAP_SI

ts_p_97_SI

phi_ptW_HAP_SI

vliq_pt_97_SI

PR_ptW_HAP_SI

vliqs_t_97_SI

PsiAir_W_HAP_SI

vvaps_t_97_SI

PsiH2O_W_HAP_SI

hicesub_t_06_SI

Rho_ptW_HAP_SI

hvapsub_t_95_SI

s_ptW_HAP_SI

pmel_t_08_SI

t_phphi_HAP_SI

psub_t_08_SI

t_phW_HAP_SI

sicesub_t_06_SI

t_psW_HAP_SI

svapsub_t_95_SI

t_ptwbW_HAP_SI

tmel_p_08_SI

td_pW_HAP_SI

tsub_p_08_SI

ts_ppH2O_HAP_SI

vicesub_t_06_SI

twb_ptW_HAP_SI

vvapsub_t_95_SI

u_ptW_HAP_SI

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/21

Licensing the LibHuAirProp Property Library


The licensing procedure must be carried out when the prompt message appears. In this case, you
will see the "License Information" window for LibHuAirProp (see figure below).

Figure 2.2.2: "License Information" window


Here you are asked to type in the license key which you have obtained from Kretzschmar
Consulting Engineers. If you do not have this, or have any questions, you will find contact
information on the "Content" page of this Users Guide or by clicking the yellow question mark in
the "License Information" window. Then the following window will appear:

Figure 2.2.3: "Help" window

If you do not enter a valid license it is still possible to use MATLAB by clicking "Cancel". In this
case, the LibHuAirProp property library will display the result "11111111" for every calculation.
The "License Information" window will appear every time you use FluidLAB LibHuAirProp until you
enter a license code to complete registration. If you decide not to use FluidLAB LibHuAirProp, you
can uninstall the program following the instructions given in section 2.2.4 of this Users Guide.
With this procedure both the LibHuAirProp-SI and LibHuAirProp-IP property libraries have been
licensed.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/22

2.2.2 Example: Calculation of h = f(p,t,W) in an M-File


Now we will calculate, step by step, the air-specific enthalpy h of real moist air as a function of
pressure p, temperature t and humidity ratio W using FluidLAB.
Please carry out the following instructions:

- Start Windows Explorer , Total Commander , My Computer or another file manager program.

The following description refers to Windows Explorer .

- Your Windows Explorer should be set to "Details" for easier viewing. Click the "Views" button
and select "Details."
- Switch into the program directory of FluidLAB, in which you will find the folder "\LibHuAirProp"; it
is generally saved under: "C:\Program Files\FluidLAB"

- Create the folder "\LibHuAirProp_IP_Example" by clicking on "File" in the Explorer menu, then
"New" in the menu which appears and afterwards selecting "Folder". Name the new folder
"\LibHuAirProp_IP_Example."
- You will now see the following window:

Figure 2.2.4: Folders "LibHuAirProp" and "LibHuAirProp_IP_Example"


- Switch into the directory "\LibHuAirProp" within "\FluidLAB", the standard being
"C:\Program Files\FluidLAB\LibHuAirProp."
- You will see the following window:

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/23

Figure 2.2.5: Contents of the folder "LibHuAirProp"


You
will
now
have
to
copy
the
following
files
into
the
directory
"C:\Program Files\FluidLAB\LibHuAirProp_IP_Example" in order to calculate the function
h = f(p,t,W).
- The following eight files are needed:
"advapi32.dll"
"Dformd.dll"
"Dforrt.dll"
"h_ptW_HAP_IP.mexw32"
"LCKCE.dll"
"LibHuAirProp_IP.dll"
"msvcp60.dll"
"msvcrt.dll".
- Click the file "h_ptW_HAP_IP.mexw32", then click "Edit" in the upper menu bar and select
"Copy".
- Switch into the directory "C:\Program Files\FluidLAB\LibHuAirProp_IP_Example", click "Edit"
and then "Paste".
H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/24

- Repeat these steps in order to copy the other files listed above. You may also select all the
above-named files and then copy them as a group (press the Control button to enable multiple
markings).
- You will see the following window:

Figure 2.2.6: Contents of the folder "LibHuAirProp_IP_Example"

- Start MATLAB (if you have not started it already).


- Click the button marked in the next figure in order
"\LibHuAirProp_IP_Example" in the "Current Directory" window.

to

open

the

folder

Figure 2.2.7: Selection of the working directory


-

Find and select the directory "C:\Program Files\FluidLAB\LibHuAirProp_IP_Example" in the


pop-up menu (see the following image).

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/25

Figure 2.2.8: Choosing the "LibHuAirProp_IP_Example" folder


- Confirm your selection by clicking the "OK" button.

- First of all you need to create an MFile in MATLAB . Within MATLAB click "File", then select
"New" and afterwards click "M-File".
- If the "Editor" window appears as a separate window, you can embed it into MATLAB
clicking the insertion arrow (see next figure) in order to obtain a better view.

by

Figure 2.2.9: Embedding the "Editor" window


- In the following figure you will see the "Editor Untitled" window.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/26

Figure 2.2.10: Embedded "Editor" window


- Now type the following lines in the "Editor - Untitled" window:
Text to be written:

Explanation:

% h_ptW_HAP_IP.m
%%
p=14.6959; % pressure in psi
t=68; % temperature in F

file name as comment


paragraph separation
declaration of the
variables pressure,
temperature, art and
composition of mixture
paragraph separation
function call
paragraph separation

W=0.01; % humidity ratio W in lbw/lba


%%
h=h_ptW_HAP_IP(p,t,W)
%%

- Remarks:
The program interprets the first line, starting with "%," to be a data description in
"Current Directory."
Paragraph separations which are mandatory are marked with "%%". This also serves
to separate the declaration of variables and calculation instructions.
The words which are printed in green, start with "%" and come after the variables are
comments. They are not in fact absolutely necessary, but they are very helpful for
your overview and to make the process more easily understood.
Omit the semicolons after the numerical values if you wish to see the result for h and
the input parameters.
The values of the function parameters in their corresponding units stand for:
- First operand: Value for p = 14.6959 psi
(Range of validity:
p = 0.00145 1450.4 psi)

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/27

- Second operand: Value for t = 68 F


(Range of validity:
t = 226.67 ... 662 F)
- Third operand: Value for W = 0.01 lbw/lba (lb water per lb air)
(Range of validity:
W = 0 10 lbw/lba)
- Save the "M-File" by clicking the "File" button and then click "Save As...".
- The menu "Save file as:" appears; In this menu, the folder name "LibHuAirProp_IP_Example"
must be displayed in the "Save in:" field.
- Next to "File name" you have to type "Example_h_ptW_HAP_IP.m" and afterwards click the
"Save" button.
Note.
The name of the example file has to be different in comparison to the name of the used function.
For example, the file could not be named "h_ptW_HAP_IP.m" in this case. Otherwise an error
message will appear during the calculation.
- You will now see the following window:

Figure 2.2.11: "Example_h_ptW_HAP_IP.m" M-file


- Within the "Current Directory" window, the file "Example_h_ptW_HAP_IP.m" appears.
- Right-click on this file and select "Run" in the menu which appears (see next image).

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/28

Figure 2.2.12: Running the "Example_h_ptW_HAP_IP.m" M-file


-

You will see the following window:

Figure 2.2.13: MATLAB with calculated result


H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/29

The result for h appears in the "Command Window".


The result in our sample calculation here is: "h = 27.2413818291547". The corresponding unit is
Btu/lba (see table of the property functions in Chapter 1).
To be able to calculate other values, you have to copy the associated mexw32 files as well

because MATLAB can only access functions that are located in the "Current Directory" window.
The example calculated can be found in the directory
C:\Program Files\FluidLAB\LibHuAirProp_IP_Example," and you may use it as a basis for further
calculations using FluidLAB.

2.2.3 Example: Calculation of h = f(p,t,W) in the Command Window


- Please follow the instructions from page 2/22 to 2/24.

- Start MATLAB (if you have not started it before).


- Click the button marked in the following image in order to open the folder
"\LibHuAirProp_IP_Example" in the window "Current Directory.

Figure 2.2.14: Selection of the working directory


- Find and select the directory "C:\Program Files\FluidLAB\LibHuAirProp_IP_Example"
in the pop-up menu (see the following image).

Figure 2.2.15: Choosing the "LibHuAirProp_IP_Example" folder

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/30

- Confirm your selection by clicking the "OK" button.


- You will see the following window:

Figure 2.2.16: MATLAB with necessary files


Corresponding to the table of the property functions in Chapter 1 you have to call up the function
"h_ptW_HAP_IP" as follows for calculating h = f(p,t,W).
Write "h=h_ptW_HAP_IP (14.6959,68,0.01)" within the "Command Window"
The values of the function parameters in their corresponding units stand for:
- First operand: Value for p = 14.6959 psi
(Range of validity:
p = 0.00145 1450.4 psi)
- Second operand: Value for t = 68 F
(Range of validity:
t = 226.67 ... 662 F)
- Third operand: Value for W = 0.01 lbw/lba (lb water per lb air)
(Range of validity:
W = 0 10 lbw/lba)
-

Confirm your entry by pressing the "ENTER" button.

- You will see the following window:

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/31

Figure 2.2.17: MATLAB with calculated result


In the "Command Window" you will see the result "h = 27.2413818291547". The corresponding
unit is Btu/lba (see table of the property functions in Chapter 1).
To be able to calculate other values, you will have to copy the respective mexw32 files into the

working directory as well, because MATLAB can only access functions that are located in the
"Current Directory" window.

2.2.4 Removing FluidLAB including LibHuAirProp

To remove the property library ASHRAE-LibHuAirProp from your hard disk drive in Windows , click

"Start" in the Windows task bar, select "Settings" and click "Control Panel". Now double-click on
"Add or Remove Programs". In the list box of the "Add or Remove Programs" window that appears
select "FluidLAB LibHuAirProp" by clicking on it and click the "Change/Remove" button. In the
following dialog box click "Automatic" and then click the "Next >" button. Confirm the following
menu "Perform Uninstall" by clicking the "Finish" button. Finally, close the "Add or Remove
Programs" and "Control Panel" windows. Now, FluidLAB has been removed.
If there is no library other than ASHRAE-LibHuAirProp installed, the directory "FluidLAB" will be
removed as well.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/32

2.3 Add-In FluidMAT for Mathcad

The FluidMAT Add-In has been developed to calculate thermodynamic properties in Mathcad
more conveniently.

Within Mathcad it enables the direct access to functions relating to real moist air, steam, water,
and ice from the ASHRAE-LibHuAirProp-IP property library.

2.3.1

Installing FluidMAT including LibHuAirProp

This section describes the installation of both FluidMAT LibHuAirProp_IP and LibHuAirProp_SI .

Before you begin, it is best to close any Windows applications, since Windows may need to be
rebooted during the installation process.
After you have downloaded and extracted the zip-file "CD_FluidMAT_ASHRAE_LibHuAirProp.zip",
you will see the folder
CD_FluidMAT_ASHRAE_LibHuAirProp

in your Windows Explorer , Norton Commander etc.


Now, open this folder by double-clicking on it.
Within this folder you will see the following files:
ASHRAE_LibHuAirProp_Users_Guide.pdf
FluidMAT_LibHuAirProp_Setup.exe.
In order to run the installation of FluidMAT, including the ASHRAE-LibHuAirProp property library,
double-click on the file
FluidMAT_LibHuAirProp_Setup.exe.

Installation may start with a window noting that all Windows programs should be closed.
When this is the case, the installation can be continued. Click the "Next >" button.
The Read-Me file window will give you information about the FluidMAT product. Click "Next >" to
leave this window.
In the following dialog box, "Choose Destination Location" (see Figure 2.3.1), the default path

where Mathcad has been installed will be shown:


C:\Program Files\Mathcad\Mathcad 14\.
By clicking the "Browse" button, you can change the installation directory before installation.
The path will be displayed in the window.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/33

Figure 2.3.1: "Choose Destination Location"


Click on "Next >" in the window "Choose Destination Location".
Click on the "Next >" button in the "Start Installation" window.
After FluidMAT LibHuAirProp has been installed, the sentence "FluidMAT LibHuAirProp has been
successfully installed" will be shown.
Confirm this by clicking the "Finish >" button.
During the installation process the following files are copied into the chosen destination folder (the

same folder where Mathcad was initially installed in):

advapi32.dll

Dynamic link library for use in Windows programs

Dformd.dll

Dynamic link library for use in Windows programs

Dforrt.dll

Dynamic link library for use in Windows programs

INSTALL_MAT_LibHuAirProp.LOG

Installation log-file

LCKCE.dll

Dynamic link library for use in Windows programs

LibHuAirProp_IP.dll

Property library for real moist air

LibHuAirProp_SI.dll

Property library for real moist air

msvcp60.dll

Dynamic link library for use in Windows programs

msvcrt.dll

Dynamic link library for use in Windows programs

Readme_MAT_LibHuAirProp.txt

ReadMe file

The following files were installed into your Mathcad subdirectory \userEFI:
MAT_LibHuAirProp_IP.dll

Function definition of LibHuAirProp-IP

MAT_LibHuAirProp_SI.dll

Function definition of LibHuAirProp-SI

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/34

The following files were installed into your Mathcad subdirectory \doc\funcdoc:
MAT_LibHuAirProp_IP.xml

Function registration in the dialog window "Insert

Function" for LibHuAirProp-IP (Mathcad version


11 or lower)

MAT_LibHuAirProp_IP_DE.xml

Function registration in the dialog window "Insert

Function" for LibHuAirProp-IP (German Mathcad


version 12 or higher)

MAT_LibHuAirProp_IP_EN.xml

Function registration in the dialog window "Insert

Function" for LibHuAirProp-IP (English Mathcad


version 12 or higher)

MAT_LibHuAirProp_SI.xml

Function
Function
registration
registration
in inthe
thedialog
dialog window
window "Insert

Function" for LibHuAirProp-SI (Mathcad version


11 or lower)

MAT_LibHuAirProp_SI_DE.xml

Function
Function
registration
registration
in inthe
thedialog
dialog window
window "Insert

Function" for LibHuAirProp-SI (German Mathcad


version 12 or higher)

MAT_LibHuAirProp_SI_EN.xml

Function
Function
registration
registration
in inthe
thedialog
dialog window
window "Insert

Function" for LibHuAirProp-SI (English Mathcad


version 12 or higher)

From within Mathcad you can now select the ASHRAE-LibHuAirProp property functions.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/35

Licensing the LibHuAirProp Property Library


The licensing procedure has to be carried out when you are calculating a function with

LibHuAirProp in Mathcad and a FluidMAT prompt message appears. In this case, you will see the
"License Information" window for LibHuAirProp (see figure below).

Figure 2.3.2: "License Information" window


Here you are asked to type in the license key which you have obtained from Kretzschmar
Consulting Engineers If you do not have this, or have any questions, you will find contact
information on the "Content" page of this Users Guide or by clicking the yellow question mark in
the "License Information" window. Then the following window will appear:

Figure 2.3.3: "Help" window

If you do not enter a valid license it is still possible to use Mathcad by clicking "Cancel". In this
case, the LibHuAirProp property library will display the result "11111111" for every calculation.
The "License Information" window will appear every time you use FluidMAT LibHuAirProp until you
enter a license code to complete registration. If you decide not to use FluidMAT LibHuAirProp, you
can uninstall the program following the instructions given in section 2.3.3 of this Users Guide.
With this procedure both the LibHuAirProp-SI and LibHuAirProp-IP property libraries have been
licensed.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/36

2.3.2 Example: Calculation of h = f(p,t,W)


Now we will calculate, step by step, the air-specific enthalpy h as a function of pressure p,
temperature t and humidity ratio W of moist air using FluidMAT.
Please carry out the following steps:

- Start Mathcad .
Type "p:" and enter the value for pressure p in psi
(Range of validity: p = 0.00145 1450.4 psi)
e.g.: Enter "p:14.6959", then press the tabulator key and enter "in psi".

Note:
When typing in the comment containing the unit of the input parameter, Mathcad switches into the
text mode, since you type in a space using the space bar, e.g. "in<space>psi". The text modus is
marked by a red cursor instead of a blue one in the math mode. After typing a comment, always
finish by positioning the mouse pointer below the variable typed in before and clicking the left
mouse button to switch back to math mode.
- Type "t:" and enter the value for temperature t in F
(Range of validity: t = 226.67 ... 662 F)
e.g.: Enter "t:68", then press the tabulator key and enter "in F".
- Type "W:" and enter the value for the humidity ratio W in lbw/lba (lb water per lb air)
(Range of validity: W = 0 10 lbw/lba)
e.g.: Enter "W:0.01", then press the tabulator key and enter "in lbw/lba".

The Mathcad sheet should now look as shown in Figure 2.3.4.

Figure 2.3.4: Example Mathcad sheet after input of the given parameters
- Enter the symbol for the result and then a colon
e.g.: Type "h:".

- Now, click "Insert" in the Mathcad menu bar and then "Function"
The "Insert Function" window appears (see Figure 2.3.5)
- Click "LibHuAirProp_IP" under "Function Category" on the left hand side
(see Figure 2.3.5)
- Choose "h_ptW_HAP_IP" under "Function Name" on the right hand side

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/37

Figure 2.3.5: Choice of library and function name


- Click the "OK" button.

Now you will see the line "h_ptW_HAP_IP(,,)" in the Mathcad window
(see Figure 2.3.6).

Figure 2.3.6: Example Mathcad sheet with formula and placeholders


- The cursor is now situated on the first operand. You can now enter the value for p either by
entering the value directly or by entering the name of the variable where the value was saved.
e.g.: Enter "p".
- Situate the cursor on the next placeholder. You can now enter the value for the temperature t
either by entering the value for t directly or by typing the name of the variable in which the value
of the temperature has been saved.
e.g.: Enter "t".

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/38

- Situate the cursor on the next placeholder. You can now enter the value for the humidity ratio W
either by entering the value for W directly or by typing the name of the variable in which the
value of the humidity ratio has been saved.
e.g.: Enter "W".
- Close the input formula by pressing the "Enter" key.
- You can now go on working with the variable h which we have just calculated, or you can have
the result for this calculated. If you wish to see the result, type the command "h=" on the next

line in the Mathcad window.


- The result for h in Btu/lba appears. To add the unit, press the tabulator key twice and enter "in
Btu/lba".
The result in our sample calculation here is: h = 27.241 Btu/lba.
The representation of the result depends on the number of decimal places which you have set in
Mathcad.

Figure 2.3.7: Example Mathcad sheet with finished calculation


The calculation of h = f(p,t,W) has been carried out.
You can now arbitrarily change the values for p, t, and W. The air-specific enthalpy is recalculated

and updated every time you change the data. This shows that the Mathcad data flow and the DLL
calculations are working together successfully.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/39

2.3.3 Removing FluidMAT including LibHuAirProp

To remove FluidMAT ASHRAE-LibHuAirProp from Mathcad and your hard drive, carry out the
following steps:

- Click the "Start" button in the Windows task bar


- Click "Settings"
- Click "Control Panel"
- Double click "Add or Remove Programs"
- Click on "FluidMAT LibHuAirProp" in the list box
- Click the "Add or Remove" button
- Mark "Automatic" and click the "Next >" button
- Click "Finish" in the "Perform Uninstall" window
Finally, close the "Add or Remove Programs" and "Control Panel" windows.
Now FluidMAT ASHRAE-LibHuAirProp has been removed.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/40

2.4 Add-In FluidEES for Engineering Equation Solver

The FluidEES Add-In has been developed to conveniently calculate thermodynamic properties in
the Engineering Equation Solver (EES). It enables, within EES, the direct call of functions relating
to real moist air, steam, water and ice from the ASHRAE-LibHuAirProp property library.

2.4.1 Installing FluidEES including LibHuAirProp


In this section, the installation of FluidEES LibHuAirProp_IP and of LibHuAirProp_SI is described.

Before you begin, it is best to close any Windows applications you may have open, since
Windows may need to be rebooted during the installation process.
After you have downloaded and extracted the zip-file "CD_FluidEES_ASHRAE_LibHuAirProp.zip",
you will see the folder
CD_FluidEES_ASHRAE_LibHuAirProp
in your Windows Explorer, Norton Commander or other similar program you are using.
Now, open this folder by double-clicking on it.
Within this folder you will see the following two files:
ASHRAE_LibHuAirProp_Users_Guide.pdf
FluidEES_LibHuAirProp_Setup.exe.
In order to run the installation of FluidEES including the ASHRAE-LibHuAirProp property library,
first double-click the file
FluidEES_LibHuAirProp_Setup.exe.
Installation may start with a window noting that all Windows programs should be closed.
When this is the case, the installation can be continued. Click the "Next >" button.
In the following dialog box, "Destination Location" (see figure below), the default path where
Engineering Equation Solver has been installed will be shown (the standard location is:
C:\Program Files\EES32\Userlib\LibHuAirProp).

Figure 2.4.1: "Destination Location"


Click on "Next >" in the window "Destination Location."
H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/41

Click on the "Next >" button in the "Start Installation" window.


The FluidEES files are now being copied into the "\LibHuAirProp" folder on your hard drive.
Click the "Finish >" button in the next window to complete installation.
The installation program has copied the following files into the directory
"C:\Program Files\EES32\Userlib\LibHuAirProp":
advapi32.dll

- Dynamic link library for use in Windows programs

Dformd.dll

- Dynamic link library for use in Windows programs

Dforrt.dll

- Dynamic link library for use in Windows programs

INSTALL.LOG

- Log file

LCKCE.dll

- Dynamic link library for use in Windows programs

LibHuAirProp_IP.ctx

- Interface including property functions of LibHuAirProp_IP for EES

LibHuAirProp_IP.dll

- Dynamic link library with property functions of LibHuAirProp_IP

LibHuAirProp_IP.hlp

- Help file of the LibHuAirProp_IP property library

LibHuAirProp_SI.ctx

- Interface including property functions of LibHuAirProp_SI for EES

LibHuAirProp_SI.dll

- Dynamic link library with property functions of LibHuAirProp_SI

LibHuAirProp_SI.hlp

- Help file of the LibHuAirProp_SI property library

msvcp60.dll

- Dynamic link library for use in Windows programs

msvcrt.dll

- Dynamic link library for use in Windows programs

UNWISE.EXE

- File to remove the LibHuAirProp library

UNWISE.INI

- File to remove the LibHuAirProp library

You can now select the ASHRAE-LibHuAirProp property functions from within Engineering
Equation Solver.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/42

Licensing the LibHuAirProp Property Library

The licensing procedure must be carried out when Engineering Equation Solver starts up and a
FluidEES prompt message appears. In this case, you will see the "License Information" window for
LibHuAirProp (see figure below).

Figure 2.4.2: "License Information" window


Here you are asked to type in the license key which you have obtained from Kretzschmar
Consulting Engineers. If you do not have this, or have any questions, you will find contact
information on the "Content" page of this Users Guide or by clicking the yellow question mark in
the "License Information" window. Then the following window will appear:

Figure 2.4.3: "Help" window


If you do not enter a valid license it is still possible to start EES by clicking "Cancel". In this case,
the LibHuAirProp property library will display the result "11111111" for every calculation.
The "License Information" window will appear every time you use FluidEES LibHuAirProp until you
enter a license code to complete registration. If you decide not to use FluidEES LibHuAirProp, you
can uninstall the program following the instructions given in section 2.4.3 of this Users Guide.
With this procedure both the LibHuAirProp-SI and LibHuAirProp-IP property libraries have been
licensed.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/43

2.4.2 Example: Calculation of h = f(p,t,W)


Now we will calculate, step by step, the air-specific enthalpy h of humid air as a function of total
pressure p, temperature t and humidity ratio W for humid air, using FluidEES with LibHuAirProp-IP

in the Engineering Equation Solver .


How to perform a calculation with FluidEES:
- Start Engineering Equation Solver (EES).
- The LibHuAirProp-IP library, if installed, is loaded by the program automatically.
- We recommend preparing an EES sheet, as shown in Figure 2.4.4.
Note: the units of p, t, and W must correspond to those in Chapter 1.

Figure 2.4.4: Preparing an EES sheet for the calculation


- The function parameters values stand for:
- First operand: Total pressure p = 14.6959 psi
(Range of validity: p = 0.00145 1450.4 psi)
- Second operand: Temperature t = 68F
(Range of validity: t = 226.67 ... 662F)
- Third operand: Humidity Ratio W = 0.01 lbw/lba (lb water per lb dry air)
(Range of validity: W = 0 10 lbw/lba)
- Confirm your entry by pressing the "ENTER" key.
Note:
EES adapts to the language that is set in the "Regional and Language Options," which can be

found in the "Control Panel." If you run Engineering Equation Solver on an English version of

Windows , the standard decimal separator will be a dot (as shown in Fig. 2.4.4 and in the following
sample calculation). If your computer is set to German, for example, the expected decimal
separator will be a comma. In this case enter a comma in the values above instead of a dot. You
can find additional information on this issue by clicking on "Help" in the EES menu bar and then
select "Help Index". Click on "Search" in the window which appears, type "decimal separator" and
press the "ENTER" key.
- For calculating h = f(p,t,W), call up the function "h_ptW_HAP_IP" of the property library
LibHuAirProp_IP as follows:
- Click on "Options" in the EES menu bar and select "Function Info".

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/44

- The "Function Information" window will appear. Select "External routines" and you will see the
screen shown here in Figure 2.4.5.

Figure 2.4.5: "Function Information" window offering different libraries (routines)


- Double-click on the entry "LIBHUAIRPROP_IP.DLL".
- A list with calculable functions of the "LibHuAirProp_IP" library appears.
- Find and select the desired function, here "h_ptW_HAP_IP" (see Figure 2.4.6), and click the
"Paste" button below.

Figure 2.4.6: Selecting the "h_ptW_HAP_IP" function


- The selected function will be copied and now appears in the "Equations Window" (see
Fig. 2.4.7).
H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/45

Figure 2.4.7: "Equations Window" with the call of the property function
- Now, you can check the syntax of the instructions in the "Equations Window" by clicking the
symbol in the upper menu bar of EES. The program tests whether or not the syntax is correct
(e.g. dots as decimal separators versus commas). Confirm the "Information" window which
appears by clicking the "OK" button.
- Then click the

symbol in the upper menu bar of EES to start the calculation.

- Soon you will see the "Calculations Completed" window. Leave this window by clicking the
"Continue" button.
- The result for the air-specific enthalpy h appears in the "Solution" window (see Figure 2.4.8).

Figure 2.4.8: "Solution" window showing the result


The calculation of h = f(p,t,W) has thus been carried out.
The result in our sample calculation here is: "h = 27.2414". The corresponding unit is Btu/lba
(see table of the property functions in Chapter 1).
For further property functions calculable in FluidEES see the function table in Chapter 1.
H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 2/46

2.4.2 Removing FluidEES including LibHuAirProp


In order to remove the property library ASHRAE-LibHuAirProp from your hard drive in Windows,
click "Start" in the lower task bar, then "Settings" and "Control Panel."
Afterwards double-click on "Add or Remove Programs."
In the list box of the "Add or Remove Programs" menu which appears,
"FluidEES LibHuAirProp" by clicking on it and click the "Change/Remove" button.
In the following dialog box select "Automatic" and then click the "Next >" button.
Then confirm the menu "Perform Uninstall" by clicking the "Finish" button.
Finally, close the "Add or Remove Programs" and "Control Panel" windows.
"FluidEES LibHuAirProp" has now been removed.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

select

I-P 3/1

3 Property Functions of the "LibHuAirProp I-P Library"


3.1 Functions for Real Moist Air

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/2

Thermal Diffusivity a = f(p,t,W)


Function Name:
a_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION A_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
a_ptW_HAP_IP - Thermal diffusivity of humid air in ft 2 /s

Range of Validity:
Temperature t:

from -99.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W Ws

Comments:
- Thermal diffusivity a =

cp

- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


a_ptW_HAP_IP = -1000

References:
( p, t ,W )

Herrmann et al. [3], [4]

( p, t ,W )

Herrmann et al. [1], [2]

c p ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/3

Relative Pressure Coefficient p = f(p,t ,W )


Function Name:
alphap_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION ALPHAP_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
alphap_ptW_HAP_IP - Relative pressure coefficient of humid air in 1/R

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W Ws

Comments:
- Relative pressure coefficient p =

1 p
p T v

- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


alphap_ptW_HAP_IP = -1000

References:
p ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/4

Isothermal Stress Coefficient p = f(p,t ,W )


Function Name:
betap_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION BETAP_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
betap_ptW_HAP_IP - Isothermal stress coefficient of humid air in lb/ft 3

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W Ws

Comments:
- Isothermal stress coefficient p =

1 p
p v T

- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


betap_ptW_HAP_IP = -1000

References:
p ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/5

Speed of Sound c = f(p,t,W)


Function Name:
c_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION C_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
c_ptW_HAP_IP - Speed of sound of humid air in ft/s

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W 10 lb w /lba

Comments:
p
- Speed of sound c = v
v s
- When calculating supersaturated air an ideal mixing model (saturated humid air
and water droplets (or ice crystals) homogeneously mixed) is applied

Result for Wrong Input Values:


c_ptW_HAP_IP = -1000

References:
c ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/6

Isobaric Heat Capacity c p = f(p,t ,W )


Function Name:
cp_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION CP_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
cp_ptW_HAP_IP - Isobaric heat capacity of humid air in Btu/(lb R)

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W Ws

Comments:
h
- Isobaric heat capacity c p =

T p
- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


cp_ptW_HAP_IP = -1000

References:
c p ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/7

Isochoric Heat Capacity cv = f(p,t ,W )


Function Name:
cv_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION CV_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
cv_ptW_HAP_IP - Isochoric heat capacity of humid air in Btu/(lb R)

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W Ws

Comments:
u
- Isochoric heat capacity cv =

T v
- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


cv_ptW_HAP_IP = -1000

References:
cv ( p, t ,W )

Herrmann et al. [3], [4]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/8

Enhancement Factor f = f(p,t)


Function Name:
f_pt_HAP_IP

Fortran Program:
REAL*8 FUNCTION F_PT_HUAIRPROP(P,T), REAL*8 P,T

Input Values:
-

p
t

Total pressure p in psi


Temperature t in F

Result:
f_pt_HAP_IP - Enhancement factor of water (decimal ratio)

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Comments:
- Enhancement factor f =
with ps (t )

pH2O,s
ps (t )

for t 32F - Steam pressure of water


for t < 32F - Sublimation pressure of water

- Describes the enhancement of the saturation pressure of water in the air


atmosphere under elevated pressure
- Derived iteratively from the isothermal compressibility of liquid water, from
Henry's constant [15], [16] and from the virial coefficients of air, water, and the
air-water mixture

Result for Wrong Input Values:


f_pt_HAP_IP = -1000

References:
f ( p, t )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/9

Air-Specific Enthalpy h = f(p,t,W)


Function Name:
h_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION H_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
h_ptW_HAP_IP

- Air-specific enthalpy in Btu/lba

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W 10 lb w /lba

Comments:
- When calculating supersaturated air an ideal mixing model (saturated humid air
and water droplets (or ice crystals) homogeneously mixed) is applied

Result for Wrong Input Values:


h_ptW_HAP_IP = -1000

References:
h(p,t,W)

Herrmann et al. [1], [2]

hw (p,t)

IAPWS-IF97 [7], [8] and IAPWS-06 [11]

ha (t)

Lemmon et al. [14]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/10

Dynamic Viscosity = f(p,t ,W )


Function Name:
Eta_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION ETA_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
Eta_ptW_HAP_IP - Dynamic viscosity of humid air in (lb s/ft)

Range of Validity:
Temperature t:

from -99.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W 10 lb w /lba

Comments:
- A new very accurate algorithm is implemented between 32F and 662F
- When calculating supersaturated air an ideal mixing model (saturated humid air
and water droplets (or ice crystals) homogeneously mixed) is applied

Result for Wrong Input Values:


Eta_ptW_HAP_IP = -1000

References:
( p, t ,W )

Herrmann et al. [3], [4]

w (p,t )

IAPWS-IF97 [7], [8] and IAPWS-06 [19]

a (t )

Lemmon et al. [18]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/11

Isentropic Exponent = f(p,t ,W )


Function Name:
Kappa_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION KAPPA_PTW_HUAIRPROP(P,T, W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
Kappa_ptW_HAP_IP - Isentropic exponent

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W 10 lb w /lba

Comments:
- Isentropic exponent =

v p
p v s

- When calculating supersaturated air an ideal mixing model (saturated humid air
and water droplets homogeneously mixed) is applied for t 32F. For
temperatures below (ice fog) the value of the saturated state is applied.

Result for Wrong Input Values:


Kappa_ptW_HAP_IP = -1000

References:
v ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/12

Thermal Conductivity = f(p,t ,W )


Function Name:
Lambda_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION LAMBDA_PTW_HUAIRPROP(P,T, W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
Lambda_ptW_HAP_IP - Thermal conductivity in Btu/(h ft R)

Range of Validity:
Temperature t:

from -99.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W 10 lb w /lba

Comments:
- A new very accurate algorithm is implemented between 32F and 662F
- When calculating supersaturated air an ideal mixing model (saturated humid air
and water droplets (or ice crystals) homogeneously mixed) is applied

Result for Wrong Input Values:


Lambda_ptW_HAP_IP = -1000

References:
( p, t ,W )

Herrmann et al. [3], [4]

w ( p, t )

IAPWS-IF97 [7], [8] and IAPWS-08 [20]

a (t )

Lemmon et al. [18]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/13

Kinematic Viscosity = f(p,t ,W )


Function Name:
Ny_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION NY_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
Ny_ptW_HAP_IP - Kinematic viscosity in ft 2 /s

Range of Validity:
Temperature t:

from -99.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W Ws

Comments:
- Kinematic Viscosity =

Result for Wrong Input Values:


Ny_ptW_HAP_IP = -1000

References:
( p, t ,W )

Herrmann et al. [3], [4]

( p, t ,W ) Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/14

Backward Function: Pressure p = f(t,s,W)


Function Name:
p_tsW_HAP_IP

Fortran Program:
REAL*8 FUNCTION P_TSW_HUAIRPROP(T,S,W), REAL*8 T,S,W

Input Values:
t
s
W

Temperature t in F
Air-specific entropy s in Btu/(lb R)
Humidity ratio W in lb w /lba

Result:
p_tsW_HAP_IP - Total pressure of humid air in psi

Range of Validity:
Temperature t:

from -225.67F to 662F

Air-specific entropy s:

from -6.32 Btu/(lb R) to 9.32877 Btu/(lb R)

Humidity ratio W:

0 W 10 lb w /lba

Comments:
- Iteration of total pressure p from s = f(p,t,W)

Result for Wrong Input Values:


p_tsW_HAP_IP = -1000

References:
s( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/15

Pressure p = f(zele )
Function Name:
p_zele_HAP_IP

Fortran Program:
REAL*8 FUNCTION P_ZELE_HUAIRPROP(ZELE), REAL*8 ZELE

Input Values:
zele

Elevation zele in ft

Result:
p_zele_HAP_IP - Pressure of humid air in psi

Range of Validity:
from -16,404 ft to 36,089 ft

Elevation zele

Comments:
- Pressure of humid air from elevation

- p( zele ) = 14.696psi 1 6.8754 106 ele


ft

5.256

Result for Wrong Input Values:


p_zele_HAP_IP = -1000

References:
p( zele )

ASHRAE [23]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/16

Partial Pressure of Air pAir = f(p, t ,W )


Function Name:
pAir_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION PAIR_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
pAir_ptW_HAP_IP - Partial pressure of (dry) air in humid air in psi

Range of Validity:
Temperature t:
Total pressure p:
Humidity ratio W:

from -225.67F to 662F


from 0.00145 psi to 1450.4 psi
0 W 10lb w /lba

Comments:
- Partial pressure of (dry) air in humid air pAir = 1 pH2O
- Partial pressure of water vapor at saturation is calculated in case of
supersaturated humid air (W > Ws ( p, t ) )
- The temperature value is used to calculate the saturation state

Result for Wrong Input Values:


pAir_ptW_HAP_IP = -1000

References:
pH2O ( p,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/17

Partial Pressure of Water Vapor pH2O = f(p, t ,W )


Function Name:
pH2O_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION PH2O_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
pH2O_ptW_HAP_IP - Partial pressure of water vapor in humid air in psi

Range of Validity:
Temperature t:
Total pressure p:
Humidity ratio W:

from -225.67F to 662F


from 0.00145 psi to 1450.4 psi
0 W 10lb w /lba

Comments:
- Partial pressure of water vapor in humid air pH2O =

W p
Ra

+W

Rw

- Partial pressure of water vapor at saturation is calculated in case of


supersaturated humid air (W > Ws ( p, t ) )
- The temperature value is used to calculate the saturation state

Result for Wrong Input Values:


pH2O_ptW_HAP_IP = -1000

References:
pH2O ( p,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/18

Partial Sat. Pressure of Water Vapor in Humid Air pH2O,s = f(p, t )


Function Name:
pH2Os_pt_HAP_IP

Fortran Program:
REAL*8 FUNCTION PH2OS_PT_HUAIRPROP(P,T), REAL*8 P,T

Input Values:
p
t

Total pressure p in psi


Temperature t in F

Result:
pH2Os_pt_HAP_IP - Partial saturation pressure of water vapor in humid air in psi

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Comments:
- Partial pressure of water vapor at saturation pH2O,s = f ps (t )
with ps (t )

for t 32F - Steam pressure of water

for t < 32F - Sublimation pressure of water

Result for Wrong Input Values:


pH2Os_pt_HAP_IP = -1000

References:
f ( p, t )
ps (t )

Herrmann et al. [1], [2]


for t 32F

IAPWS-IF97 [7], [8]

for t < 32F

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/19

Relative Humidity = f(p, t ,W )


Function Name:
phi_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION PHI_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
phi_ptW_HAP_IP - Relative humidity (decimal ratio)

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W 10 lb w /lba

Comments:
- Relative humidity =

pH2O
pH2O,s

- This equation is valid for pH2O pH2O,s and for 0 1

Result for Wrong Input Values:


phi_ptW_HAP_IP = -1000

References:
( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/20

Prandtl Number Pr = f(p,t,W)


Function Name:
Pr_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION PR_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
Pr_ptW_HAP_IP - Prandtl number

Range of Validity:
Temperature t:

from -99.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W 10lb w /lba

Comments:
- Prandtl number Pr =

cp

- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


Pr_ptW_HAP_IP = -1000

References:
( p, t ,W )

Herrmann et al. [3], [4]

c p ( p, t ,W )

Herrmann et al. [3], [4]

( p, t ,W )

Lemmon et al. [20]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/21

Mole Fraction of Air Air = f(W )


Function Name:
PsiAir_W_HAP_IP

Fortran Program:
REAL*8 FUNCTION PSIAIR_W_HUAIRPROP(W), REAL*8 W

Input Values:
W

Humidity ratio W in lb w /lba

Result:
PsiAir_W_HAP_IP - Mole fraction of (dry) air in humid air in mola/mol

Range of Validity:
Humidity ratio W:

0 W 10lb w /lba

Comments:
- Mole fraction of air Air = 1 H2O

W
= 1
Ra
+W
R
H2O

Result for Wrong Input Values:


PsiAir_W_HAP_IP = -1000

References:
Air (W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/22

Mole Fraction of Water H2O = f(W )


Function Name:
PsiH2O_W_HAP_IP

Fortran Program:
REAL*8 FUNCTION PSIH2O_W_HUAIRPROP(W), REAL*8 W

Input Values:
W

Humidity ratio W in lb w /lba

Result:
PsiH2O_W_HAP_IP - Mole fraction of water in humid air in molw/mol

Range of Validity:
Humidity ratio W:

0 W 10 lb w /lba

Comments:
- Mole fraction of water H2O =

W
Ra
+W
RH2O

Result for Wrong Input Values:


PsiH2O_W_HAP_IP = -1000

References:
H2O (W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/23

Density = f(p,t ,W )
Function Name:
Rho_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION RHO_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
Rho_ptW_HAP_IP - Density of humid air in lb/ft 3

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W 10lb w /lba

Comments:
- Density of humid air obtained from air-specific volume: =

1+ W
v

Result for Wrong Input Values:


Rho_ptW_HAP_IP = -1000

References:
( p, t ,W ) Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/24

Air-Specific Entropy s = f(p,t,W)


Function Name:
s_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION S_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
s_ptW_HAP_IP

- Air-specific entropy in Btu/(lba R)

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W 10 lb w /lba

Comments:
- When calculating supersaturated air an ideal mixing model (saturated humid air
and water droplets (or ice crystals) homogeneously mixed) is applied

Result for Wrong Input Values:


s_ptW_HAP_IP = -1000

References:
s( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/25

Backward Function: Temperature t = f(p,h,)


Function Name:
t_phphi_HAP_IP

Fortran Program:
REAL*8 FUNCTION T_PHPHI_HUAIRPROP(P,H,PHI), REAL*8 P,H,PHI

Input Values:
p
h

Total pressure p in psi


Air-specific enthalpy h in Btu/lba
Relative humidity (decimal ratio)

Result:
t_phphi_HAP_IP - Temperature from pressure, enthalpy, and relative humidity in F

Range of Validity:
Total pressure p:

from 0.00145 psi to 1450.4 psi

Air-specific enthalpy h:

from -2469.22 Btu/lba to 12772.088 Btu/lba

Relative humidity :

0 1

Comments:
- Iteration of temperature t from h = f(p,t,W) using W = f(p,t,)

Result for Wrong Input Values:


t_phphi_HAP_IP = -1000

References:
h( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/26

Backward Function: Temperature t = f(p,h,W)


Function Name:
t_phW_HAP_IP

Fortran Program:
REAL*8 FUNCTION T_PHW_HUAIRPROP(P,H,W), REAL*8 P,H,W

Input Values:
p
h

Total pressure p in psi


Air-specific enthalpy h in Btu/lba

Humidity ratio W in lb w /lba

Result:
t_phW_HAP_IP - Temperature from pressure, enthalpy, and humidity ratio in F

Range of Validity:
Total pressure p:

from 0.00145 psi to 1450.4 psi

Air-specific enthalpy h:

from -2469.22 Btu/lba to 12772.088 Btu/lba

Humidity ratio W:

0 W 10lb w /lba

Comments:
- Iteration of temperature t from h = f(p,t,W)

Result for Wrong Input Values:


t_phW_HAP_IP = -1000

References:
h( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/27

Backward Function: Temperature t = f(p,s,W)


Function Name:
t_psW_HAP_IP

Fortran Program:
REAL*8 FUNCTION T_PSW_HUAIRPROP(P,S,W), REAL*8 P,S,W

Input Values:
p
s

Total pressure p in psi


Air - specific entropy s in Btu /(lb R)

Humidity ratio W in lb w /lba

Result:
t_psW_HAP_IP - Temperature from pressure, entropy, and humidity ratio in F

Range of Validity:
Total pressure p:

from 0.00145 psi to 1450.4 psi

Air-specific entropy s:

from -6.32 Btu/(lb R) to 9.3288 Btu/(lb R)

Humidity ratio W:

0 W 10lb w /lba

Comments:
- Iteration of temperature t from s = f(p,t,W)

Result for Wrong Input Values:


t_psW_HAP_IP = -1000

References:
s( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/28

Backward Function: Temperature t = f(p,t wb ,W )


Function Name:
t_ptwbW_HAP_IP

Fortran Program:
REAL*8 FUNCTION T_PTWBW_HUAIRPROP(P,TWB,W), REAL*8 P,TWB,W

Input Values:
p
t wb

Total pressure p in psi


Wet-bulb temperature in F

Humidity ratio W in lb w /lba

Result:
t_ptwbW_HAP_IP

- Temperature from pressure, wet bulb temperature and

humidity ratio in F

Range of Validity:
Total pressure p:

from 0.00145 psi to 1450.4 psi

Wet bulb temperature t wb :

from -225.67F to 662F

Humidity ratio W:

0 W 10 lb w /lba

Comments:
- Iterationof temperature t from t wb = f( p, t ,W )

Result for Wrong Input Values:


t_ptwbW_HAP_IP = -1000

References:
t wb ( p, t ,W ) Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/29

Dew-Point/Frost-Point Temperature td = f(p,W )


Function Name:
td_pW_HAP_IP

Fortran Program:
REAL*8 FUNCTION TD_PW_HUAIRPROP(P,W), REAL*8 P,W

Input Values:
p
W

Total pressure p in psi


Humidity ratio W in lb w /lba

Result:
td_pW_HAP_IP - Dew-point/frost-point temperature in F

Range of Validity:
Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W 10lb w /lba

Comments:
Dew-point temperature td = ts ( pH2O ) for t 32F (saturation temperature of
water in humid air)
td = tsub ( pH2O ) for t 32F (sublimation temperature
of water in humid air)

Result for Wrong Input Values:


td_pW_HAP_IP = -1000

References:
ts ( pH2O )

for td 32F

IAPWS-IF97 [7], [8]

tsub ( pH2O )

for td 32F

IAPWS-08 [11]

pH2O

Herrmann et. al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/30

Saturation Temperature t s = f(p,pH2O )


Function Name:
ts_ppH2O_HAP_IP

Fortran Program:
REAL*8 FUNCTION TS_PPH2O_HUAIRPROP(P,PH2O), REAL*8 P,PH2O

Input Values:
p
pH2O

- Total pressure p in psi


- Partial saturation pressure of water pH2O in psi

Result:
ts_ppH2O_HAP_IP - Saturation temperature of water in humid air in F

Range of Validity:
Total pressure p:

from 0.00145 psi to 1450.4 psi

Partial pressure pH2O :

from 0.00145 psi to 1450.4 psi

Comments:
- Iteration of saturation temperature ts from pH2O,s = f( p, t )

Result for Wrong Input Values:


ts_ppH2O_HAP_IP = -1000

References:
pH2O,s

Herrmann et. al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/31

Wet-Bulb/Ice-Bulb Temperature t wb = f(p,t ,W )


Function Name:
twb_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION TWB_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
twb_ptW_HAP_IP - Wet-bulb/ice-bulb temperature in F

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W 10lb w /lba

Comments:
- Iteration of wet-bulb temperature t wb from hunsaturated (p, t ,W ) = h fog (p, t wb ,W )
- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


twb_ptW_HAP_IP = -1000

References:
t wb ( p, t ,W ) Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/32

Air-Specific Internal Energy u = f(p,t,W)


Function Name:
u_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION U_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
u_ptW_HAP_IP

- Air-specific internal energy in Btu/lba

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W 10lb w /lba

Comments:
- Internal energy u = h pv

Result for Wrong Input Values:


u_ptW_HAP_IP = -1000

References:
u( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/33

Air-Specific Volume v = f(p,t,W)


Function Name:
v_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION V_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
v_ptW_HAP_IP

- Air-specific volume in ft3 /lba

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Humidity ratio W:

0 W 10 lb w /lba

Comments:
- When calculating supersaturated air an ideal mixing model (saturated humid air
and water droplets (or ice crystals) homogeneously mixed) is applied

Result for Wrong Input Values:


v_ptW_HAP_IP = -1000

References:
v ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/34

Humidity Ratio from Partial Pressure of Water Vapor W = f(p ,t ,pH2O )


Function Name:
W_ptpH2O_HAP_IP

Fortran Program:
REAL*8 FUNCTION W_PTPH2O_HUAIRPROP(P,T,PH2O), REAL*8 P,T,PH2O

Input Values:
- Total pressure p in psi
p
- Temperature t in F
t
pH2O - Partial pressure of water pH2O in psi

Result:
W_ptpH2O_HAP_IP - Humidity ratio from pressure, temperature and partial
pressure of water vapor in lb w /lba

Range of Validity:
Total pressure p:

from 0.00145 psi to 1450.4 psi

Temperature t :

from -225.67F to 662F

Partial pressure pH2O :

from 0.00145 psi to 1450.4 psi

Comments:
- Iteration of humidity ratio W from pH2O = f( p, t ,W )

- Result for supersaturated humid air is Ws

Result for Wrong Input Values:


W_ptpH2O_HAP_IP = -1000

References:
pH2O ( p, t ,W ) Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/35

Humidity Ratio from Relative Humidity W = f(p,t , )


Function Name:
W_ptphi_HAP_IP

Fortran Program:
REAL*8 FUNCTION W_PTPHI_HUAIRPROP(P,T,PHI), REAL*8 P,T,PHI

Input Values:
p
t

Total pressure p in psi


Temperature t in F
Relative humidity (decimal ratio)

Result:
W_ptphi_HAP_IP

- Humidity ratio from pressure, temperature and relative


humidity in lbw /lba

Range of Validity:
Temperature t:

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Relative humidity :

0 1

Comments:
- Iteration of humidity ratio W from = f ( p, t ,W )

Result for Wrong Input Values:


W_ptphi_HAP_IP = -1000

References:
( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/36

Humidity Ratio from Dew-Point Temperature W = f(p,td )


Function Name:
W_ptd_HAP_IP

Fortran Program:
REAL*8 FUNCTION W_PTD_HUAIRPROP(P,TD), REAL*8 P,TD

Input Values:
p
td

Total pressure p in psi


Dew -po int temperature t d in F

Result:
W_ptd_HAP_IP

- Humidity ratio from pressure and dew-point temperature


in lb w /lba

Range of Validity:
Dew point temperature td :

from -225.67F to 662F

Total pressure p:

from 0.00145 psi to 1450.4 psi

Comments:
- Iteration of humidity ratio W from td = f(p,W )

Result for Wrong Input Values:


W_ptd_HAP_IP = -1000

References:
td ( p,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/37

Humidity Ratio from Wet-Bulb Temperature W = f(p,t ,t wb )


Function Name:
W_pttwb_HAP_IP

Fortran Program:
REAL*8 FUNCTION W_PTTWB_HUAIRPROP(P,T,TWB), REAL*8 P,T,TWB

Input Values:
p
t
t wb

Total pressure p in psi


Temperature t in F
Wet-bulb temperature in F

Result:
W_pttwb_HAP_IP

- Humidity ratio from pressure, temperature and wet-bulb


temperature in lb w /lba

Range of Validity:
Total pressure p:

from 0.00145 psi to 1450.4 psi

Temperature t:

from -225.67F to 662F

Wet-bulb temperature t wb :

from -225.67F to 662F

Comments:
- Iteration of humidity ratio W from t wb = f(p, t ,W )
- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


W_pttwb_HAP_IP = -1000

References:
t wb ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/38

Saturation Humidity Ratio Ws = f(p,t )


Function Name:
Ws_pt_HAP_IP

Fortran Program:
REAL*8 FUNCTION WS_PT_HUAIRPROP(P,T), REAL*8 P,T

Input Values:
p
t

Total pressure p in psi


Temperature t in F

Result:
Ws_pt_HAP_IP

- Saturation humidity ratio in lb w /lba

Range of Validity:
Total pressure p:

from 0.00145 psi to 1450.4 psi

Temperature t:

from -225.67F to 662F

Comments:
- Calculation of saturation humidity ratio Ws from Ws =

pH2O,s
MH2O
Ma ( p pH2O,s )

Result for Wrong Input Values:


Ws_pt_HAP_IP = -1000

References:
pH2O,s

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/39

Mass Fraction of Air Air = f(W )


Function Name:
XiAir_W_HAP_IP

Fortran Program:
REAL*8 FUNCTION XIAIR_W_HUAIRPROP(W), REAL*8 W

Input Values:
W

Humidity ratio W in lb w /lba

Result:
XiAir_W_HAP_IP

- Mass fraction of (dry) air in humid air in lba /lb

Range of Validity:
Humidity ratio W:

0 W 10lb w /lba

Comments:
- Mass fraction of (dry) air Air = 1 H2O = 1

W
1+ W

Result for Wrong Input Values:


XiAir_W_HAP_IP = -1000

References:
Air (W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/40

Mass Fraction of Water Vapor in Humid Air H2O = f(W )


Function Name:
XiH2O_W_HAP_IP

Fortran Program:
REAL*8 FUNCTION XIH2O_W_HUAIRPROP(W), REAL*8 W

Input Values:
W

Humidity ratio W in lb w /lba

Result:
XiH2O_W_HAP_IP

- Mass fraction of water vapor in humid air in lb w /lb

Range of Validity:
Humidity ratio W:

0 W 10lb w /lba

Comments:
- Mass fraction of water H2O =

W
1+ W

Result for Wrong Input Values:


XiH2O_W_HAP_IP = -1000

References:
H2O (W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/41

Compression Factor Z = f(p,t,W)


Function Name:
Z_ptW_HAP_IP

Fortran Program:
REAL*8 FUNCTION Z_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in psi


Temperature t in F
Humidity ratio W in lb w /lba

Result:
Z_ptW_HAP_IP - Compression factor (decimal ratio)

Range of Validity:
Total pressure p:

from 0.00145 psi to 1450.4 psi

Temperature t:

from -225.67F to 662F

Humidity ratio W:

0 W Ws

Comments:
- Compression factor Z = 1 +

Mv
1+ W
and M is the molar mass of humid air
with v =

Bm Cm
+
v
v2

- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


Z_ptW_HAP_IP = -1000

References:
Bm (t ,W ), Cm (t ,W )

Herrmann et al. [1], [2]

( p, t ,W ), v ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/42

3.2 Functions for Steam and Water for Temperatures t 32F

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/43

Specific Enthalpy of Liquid Water hliq = f( p, t )


Function Name:
hliq_pt_97_IP

Fortran Program:
REAL*8 FUNCTION HLIQ_PT_97(P,T), REAL*8 P,T

Input Values:
p
t

Pressure p in psi
Temperature t in F

Result:
hliq_pt_97_IP - Specific enthalpy of liquid water in Btu/lb

Range of Validity:
Pressure p:

from ps (32F) = 0.08865 psi to 1450.4 psi

Temperature t:

from 32F to 662F

Comments:
- Specific enthalpy of liquid water hliq = h97 ( p, t ) (Region 1)

Result for Wrong Input Values:


hliq_pt_97_IP = -1000

References:
h97 (p,t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/44

Specific Enthalpy of Saturated Liquid Water hliq,s = f(t )


Function Name:
hliqs_t_97_IP

Fortran Program:
REAL*8 FUNCTION HLIQS_T_97(T), REAL*8 T

Input Values:
t

Temperature t in F

Result:
hliqs_t_97_IP - Specific enthalpy of saturated liquid water in Btu/lb

Range of Validity:
Temperature t:

from 32F to 662F

Comments:
- Specific enthalpy of liquid water hliq,s = h97 ( ps , t ) (Region 1)
with ps = ps97 (t )

Result for Wrong Input Values:


hliqs_t_97_IP = -1000

References:
h97 (p, t ), ps97 (t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/45

Specific Enthalpy of Saturated Water Vapor hvap,s = f(t )


Function Name:
hvaps_t_97_IP

Fortran Program:
REAL*8 FUNCTION HVAPS_T_97(T), REAL*8 T

Input Values:
t

Temperature t in F

Result:
hvaps_t_97_IP - Specific enthalpy of saturated water vapor in Btu/lb

Range of Validity:
Temperature t:

from 32F to 662F

Comments:
- Specific enthalpy of saturated water vapor hvap,s = h97 ( ps , t ) (Region 2)
with ps = ps97 (t )

Result for Wrong Input Values:


hvaps_t_97_IP = -1000

References:
h97 (p, t ), ps97 (t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/46

Saturation Pr essure of Water ps = f(t )


Function Name:
ps_t_97_IP

Fortran Program:
REAL*8 FUNCTION PS_T_97(T), REAL*8 T

Input Values:
t

Temperature t in F

Result:
ps_t_97_IP - Saturation pressure of water in psi

Range of Validity:
Temperature t:

from 32F to 662F

Comments:
- Saturation pressure of water ps = ps97 (t ) (Region 4)

Result for Wrong Input Values:


ps_t_97_IP -1000

References:
ps97 (t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/47

Specific Entropy of Liquid Water sliq = f( p, t )


Function Name:
sliq_pt_97_IP

Fortran Program:
REAL*8 FUNCTION SLIQ_PT_97(P,T), REAL*8 P,T

Input Values:
p
t

Pressure p in psi
Temperature t in F

Result:
sliq_pt_97_IP - Specific entropy of liquid water in Btu/(lb R)

Range of Validity:
Pressure p:

from ps (32F) = 0.08865 psi to 1450.4 psi

Temperature t:

from 32F to 662F

Comments:
- Specific entropy of liquid water sliq = s 97 ( p, t ) (Region 1)

Result for Wrong Input Values:


sliq_pt_97_IP = -1000

References:
s 97 ( p, t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/48

Specific Entropy of Saturated Liquid Water sliq,s = f(t )


Function Name:
sliqs_t_97_IP

Fortran Program:
REAL*8 FUNCTION SLIQS_T_97(T), REAL*8 T

Input Values:
t

Temperature t in F

Result:
sliqs_t_97_IP - Specific entropy of saturated liquid water in Btu/(lb R)

Range of Validity:
Temperature t:

from 32F to 662F

Comments:
- Specific entropy of liquid water sliq,s = s 97 ( ps , t ) (Region 1)
with ps = ps97 (t )

Result for Wrong Input Values:


sliqs_t_97_IP = -1000

References:
s 97 (p, t ), ps97 (t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/49

Specific Entropy of Saturated Water Vapor svap,s = f(t )


Function Name:
svaps_t_97_IP

Fortran Program:
REAL*8 FUNCTION SVAPS_T_97(T), REAL*8 T

Input Values:
t

Temperature t in F

Result:
svaps_t_97_IP - Specific entropy of saturated water vapor in Btu/(lb R)

Range of Validity:
Temperature t:

from 32F to 662F

Comments:
- Specific entropy of saturated water vapor svap,s = s 97 ( ps , t ) (Region 2)
with ps = ps97 (t )

Result for Wrong Input Values:


svaps_t_97_IP = -1000

References:
s 97 (p, t ), ps97 (t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/50

Saturation Temperature of Water t s = f( p )


Function Name:
ts_p_97_IP

Fortran Program:
REAL*8 FUNCTION TS_P_97(P), REAL*8 P

Input Values:
p

Pressure p in psi

Result:
ts_p_97_IP - Saturation temperature of water in F

Range of Validity:
Pressure p:

from 0.08865 psi to 1450.4 psi

Comments:
- Saturation temperature of water ts = ts97 ( p ) (Region 4)

Result for Wrong Input Values:


ts_p_97_IP = -1000

References:
ts97 (p )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/51

Specific Volume of Liquid Water v liq = f( p, t )


Function Name:
vliq_pt_97_IP

Fortran Program:
REAL*8 FUNCTION VLIQ_PT_97(P,T), REAL*8 P,T

Input Values:
p
t

Pressure p in psi
Temperature t in F

Result:
vliq_pt_97_IP - Specific volume of liquid water in ft 3 /lb

Range of Validity:
Pressure p:

from ps (32F) = 0.08865 psi to 1450.4 psi

Temperature t:

from 32F to 662F

Comments:
- Specific volume of liquid water v liq = v 97 ( p, t ) (Region 1)

Result for Wrong Input Values:


vliq_pt_97_IP = -1000

References:
v 97 (p,t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/52

Specific Volume of Saturated Liquid Water v liq,s = f(t )


Function Name:
vliqs_t_97_IP

Fortran Program:
REAL*8 FUNCTION VLIQS_T_97(T), REAL*8 T

Input Values:
-

Temperature t in F

Result:
vliqs_t_97_IP - Specific volume of saturated liquid water in ft 3 /lb

Range of Validity:
Temperature t:

from 32F to 662F

Comments:
- Specific volume of liquid water v liq,s = v 97 ( ps , t ) (Region 1)
with ps = ps97 (t )

Result for Wrong Input Values:


vliqs_t_97_IP = -1000

References:
v 97 (p, t ), ps97 (t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/53

Specific Volume of Saturated Water Vapor v vap,s = f(t )


Function Name:
vvaps_t_97_IP
Fortran Program:
REAL*8 FUNCTION VVAPS_T_97(T), REAL*8 T

Input Values:
-

Temperature t in F

Result:
vvaps_t_97_IP - Specific volume of saturated water vapor in ft 3 /lb

Range of Validity:
Temperature t:

from 32F to 662F

Comments:
- Specific volume of saturated water vapor v vap,s = v 97 ( ps , t ) (Region 2)
with ps = ps97 (t )

Result for Wrong Input Values:


vvaps_t_97_IP = -1000
References:
v 97 (p, t ), ps97 (t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/54

3.3 Functions for Steam and Water for Temperatures t 32F

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/55

Specific Enthalpy of Saturated Ice hice,sub = f(t )


Function Name:
hicesub_t_06_IP

Fortran Program:
REAL*8 FUNCTION HICESUB_T_06(T), REAL*8 T

Input Values:
-

Temperature t in F

Result:
hicesub_t_06_IP - Specific enthalpy of saturated ice in Btu/lb

Range of Validity:
Temperature t:

from -225.67F to 32F

Comments:
- Specific enthalpy of saturated ice hice,sub = h06 ( psub , t )
08
with psub = psub
(t )

Result for Wrong Input Values:


hicesub_t_06_IP = -1000

References:
h06 (p, t )

IAPWS-06 [10]

08
psub
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/56

Specific Enthalpy of Saturated Water Vapor hvap,sub = f(t )


Function Name:
hvapsub_t_95_IP

Fortran Program:
REAL*8 FUNCTION HVAPSUB_T_95(T), REAL*8 T

Input Values:
-

Temperature t in F

Result:
hvapsub_t_95_IP - Specific enthalpy of saturated water vapor in Btu/lb

Range of Validity:
Temperature t:

from -225.67F to 32F

Comments:
- Specific enthalpy of saturated water vapor hvap,sub = h95 ( psub , t )
08
with psub = psub
(t )

Result for Wrong Input Values:


hvapsub_t_95_IP = -1000

References:
h95 (p, t )

IAPWS-95 [5], [6]

08
psub
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/57

Melting Pr essure of Ice pmel = f(t )


Function Name:
pmel_t_08_IP

Fortran Program:
REAL*8 FUNCTION PMEL_T_08 (T), REAL*8 T

Input Values:
t

Temperature t in F

Result:
pmel_t_08_IP - Melting pressure of ice in psi

Range of Validity:
Temperature t:

from -7.573F to 32F

Result for Wrong Input Values:


pmel_t_08_IP = -1000

References:
08
pmel
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/58

Sublim ation Pr essure of Ice psub = f(t )


Function Name:
psub_t_08_IP

Fortran Program:
REAL*8 FUNCTION PSUB_T_08 (T), REAL*8 T

Input Values:
t

Temperature t in F

Result:
psub_t_08_IP - Sublimation pressure of ice in psi

Range of Validity:
Temperature t:

from -225.67F to 32F

Result for Wrong Input Values:


psub_t_08_IP = -1000

References:
08
psub
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/59

Specific Entropy of Saturated Ice sice,sub = f(t )


Function Name:
sicesub_t_06_IP

Fortran Program:
REAL*8 FUNCTION SICESUB_T_06(T), REAL*8 T

Input Values:
-

Temperature t in F

Result:
sicesub_t_06_IP - Specific entropy of saturated ice in Btu/(lb R)

Range of Validity:
Temperature t:

from -225.67F to 32F

Comments:
- Specific entropy of saturated ice sice,sub = s 06 ( psub , t )
08
with psub = psub
(t )

Result for Wrong Input Values:


sicesub_t_06_IP = -1000

References:
s 06 ( p, t )

IAPWS-06 [10]

08
psub
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/60

Specific Entropy of Saturated Water Vapor svap,sub = f(t )


Function Name:
svapsub_t_95_IP

Fortran Program:
REAL*8 FUNCTION SVAPSUB_T_95(T), REAL*8 T

Input Values:
-

Temperature t in F

Result:
svapsub_t_95_IP - Specific entropy of saturated water vapor in Btu/(lb R)

Range of Validity:
Temperature t:

from -225.67F to 32F

Comments:
- Specific entropy of saturated water vapor svap,sub = s 95 ( psub , t )
08
with psub = psub
(t )

Result for Wrong Input Values:


svapsub_t_95_IP = -1000

References:
s 95 (p, t )

IAPWS-95 [7], [8]

08
psub
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/61

Melting Temperature of Ice tmel = f( p )


Function Name:
tmel_p_08_IP

Fortran Program:
REAL*8 FUNCTION TMEL_P_08(P), REAL*8 P

Input Values:
p

Pressure p in psi

Result:
tmel_p_08_IP - Melting temperature of ice in F

Range of Validity:
from ps (32F) = 0.08865 psi to 1450.4 psi

Pressure p:

Result for Wrong Input Values:


tmel_p_08_IP = -1000

References:
08
tmel
(p )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/62

Sublim ation Temperature of Ice t sub = f( p )


Function Name:
tsub_p_08_IP

Fortran Program:
REAL*8 FUNCTION TSUB_P_08(P), REAL*8 P

Input Values:
p

Pressure p in psi

Result:
tsub_p_08_IP - Sublimation temperature of ice in F

Range of Validity:
Pressure p:

from psubl (-225.67F) = 1.7407 x 10-12 psi to psubl (32F) = 0.08865 psi

Result for Wrong Input Values:


tsub_p_08_IP = -1000

References:
08
tsub
(p )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/63

Specific Volume of Saturated Ice v ice,sub = f(t )


Function Name:
vicesub_t_06_IP

Fortran Program:
REAL*8 FUNCTION VICESUB_T_06(T), REAL*8 T

Input Values:
-

Temperature t in F

Result:
vicesub_t_06_IP - Specific volume of saturated ice in ft 3 /lb

Range of Validity:
Temperature t:

from -225.67F to 32F

Comments:
- Specific volume of saturated ice v ice,sub = v 06 ( psub , t )
08
with psub = psub
(t )

Result for Wrong Input Values:


vicesub_t_06_IP = -1000

References:
v 06 (p, t )

IAPWS-06 [10]

08
psub
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 3/64

Specific Volume of Saturated Water Vapor v vap,sub = f(t )


Function Name:
vvapsub_t_95_IP

Fortran Program:
REAL*8 FUNCTION VVAPSUB_T_95(T), REAL*8 T

Input Values:
-

Temperature t in F

Result:
vvapsub_t_95_IP - Specific volume of saturated water vapor in ft 3 /lb

Range of Validity:
Temperature t:

from -225.67F to 32F

Comments:
- Specific volume of saturated water vapor v vap,sub = v 95 ( psub , t )
08
with psub = psub
(t )

Result for Wrong Input Values:


vvapsub_t_95_IP = -1000

References:
v 95 (p, t )

IAPWS-95 [7], [8]

08
psub
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

4 Property Libraries for Calculating Heat Cycles, Boilers,


Turbines, and Refrigerators
Water and Steam

Humid Combustion Gas Mixtures

Library LibIF97
- Industrial Formulation
IAPWS-IF97
(Revision 2007)
- Supplementary Standards

Library LibHuGas
Ideal mixture of the real fluids:
CO2 - Span and Wagner
H2O - IAPWS-95
N2 - Span et al.

- IAPWS Revised Advisory


Note No. 3 on
Thermodynamic
Derivatives (2008)

Humid Air
Library LibHuAir
Ideal mixture of the real fluids:

O2 - Schmidt and Wagner


Ar - Tegeler et al.

and of the ideal gases:

- IAPWS-IF97-S01
- IAPWS-IF97-S03rev
- IAPWS-IF97-S04
- IAPWS-IF97-S05

I-P 4/1

SO2, CO, Ne (scientific equations of Bcker et al.)


Consideration of

- Dry air from Lemmon et al.


- Steam and water from IAPWS-IF97

Consideration of
- Dissociation from VDI-Guideline 4670
- Poynting effect

Dissociation from VDI 4670 and Poynting effect

Library LibIDGAS

Library LibIdAir

Ideal gas mixture calculated from the VDIGuideline 4670

Ideal gas mixture calculate from


VDI-Guideline 4670

Carbon Dioxide

Ideal Gas Mixtures

Library LibCO2

Library LibIdGasMix
Ideal mixture of the ideal gases:

Formulation of Span and Wagner


(1994)

Hydrogen
Library LibH2

Ar
Ne
N2
O2
CO
CO2
Air
NO
H2O

Formulation of
Leachman et al. (2007)

Helium
Library LibHe
Formulation of McCarty
and Arp (1990)

Methanol
Library LibCH3OH

SO2
H2
H2S
OH
He
F2
NH3

Methane
Ethane
Ethylene
Propylene
Propane
Iso-Butane
n-Butane
Benzene
Methanol

Seawater
Library LibSeaWa
IAPWS Formulation (2008)
and IAPWS-IF97

Refrigerant R134a
Library LibR134a
Formulation of
Tillner-Roth and Baehr (1994)

Consideration of
- Dissociation from VDI-Guideline 4670

Formulation of
de Reuck and Craven (1993)

Refrigerant NH3
Library LibNH3
Formulation of Tillner-Roth
(1995)

ORC Working Fluids

Mixtures for Absorption Processes

Refrigerants

Library LibMM
Siloxane C6H18OSi2 (MM)

Library LibAmWa

Library LibPropan

Ammonia/Water Mixtures

Refrigerant Propane
Formulation of Lemmon
et al. (2008)

Formulation of Colonna et al. (2006)


Library LibD4
Siloxane C8H24O4Si4 (D4)
Formulation of Colonna et al. (2006)
Library LibD5
Siloxane C10H30O5Si5 (D5)
Formulation of Colonna et al. (2006)
Library LibMD4M
Siloxane C14H42O5Si6 (MD4M)
Formulation of Colonna et al. (2006)

IAPWS Guideline 2005 of Tillner-Roth


and Friend (1998)
Helmholtz energy formulation for the
mixing term

Library LibButan_Iso

Library LibWaLi

Refrigerant Iso-Butane
Formulation of Bcker
et al. (2003)

Water/Lithium Bromide Mixtures

Library LibButan_n

Formulation of Kim and Infante Ferreira


(2004)

Refrigerant n-Butane
Formulation of Bcker
et al. (2003)

Gibbs energy equation for the


mixing term

I-P 4/2

Add-In FluidEXL for Excel

Add-In FluidEES for EES

Using the Add-In FluidEXL a direct call of the property functions


in Excel is possible.

The Add-In FluidEES allows to call the functions of the property


libraries within the Engineering Equation Solver EES .

Function in FluidEXL

Function in FluidEES

Add-In FluidMAT for Mathcad

Add-In FluidLAB for MATLAB

Using the Add-on FluidMAT, the functions of the


property libraries can be used in Mathcad .

The property functions can be called in MATLAB .

Function in FluidLAB

Function in FluidMAT

The following thermodynamic and transport properties can be calculated1:


Thermodynamic Properties
Saturation pressure ps
Saturation temperature Ts
Density
Specific volume v
Enthalpy h
Internal energy u
Entropy s
Exergy e

Transport Properties
Dynamic viscosity
Kinematic viscosity
Thermal conductivity
Prandtl-number Pr

Isobaric heat capacity cp


Isochoric heat capacity cv
Isentropic exponent
Speed of sound w
Surface tension
Thermodynamic Derivatives
Partial derivatives can be calculated

Backward Functions
T, v, s (p,h)
p, T (v,h)
T, v, h (p,s)
p, T (v,u)
p, T, v (h,s)

For information please contact:


Zittau/Goerlitz University of Applied Sciences
Department of Technical Thermodynamics
Prof. Hans-Joachim Kretzschmar
Dr. Ines Stoecker
Theodor-Koerner-Allee 16
02763 Zittau, Germany

E-mail: hj.kretzschmar@hs-zigr.de
Internet: www.thermodynamics-zittau.de
Phone: +49-3583-61-1846
Fax.: +49-3583-61-1846
1 Not all of these property functions are available in all property libraries listed before.

I-P 5/1

5 References
[1]

Herrmann, S.; Kretzschmar, H.-J.; Gatley, D.P.: Thermodynamic Properties of Real


Moist Air, Dry Air, Steam, Water, and Ice. HVAC&R Research 5, 961-986 (2009).

[2]

Herrmann, S.; Kretzschmar, H.-J.; Gatley, D.P.: Thermodynamic Properties of Real


Moist Air, Dry Air, Steam, Water, and Ice. ASHRAE RP-1485, American Society of
Heating, Refrigerating, and Air-Conditioning Engineers, Inc., Atlanta, GA (2009).

[3]

Herrmann, S.; Kretzschmar, H.-J.; Teske, V.; Vogel, E.; Ulbig, P.; Span, R.; Gatley,
D.P.: Determination of Thermodynamic and Transport Properties of Humid Air for
Power-Cycle Calculations, Report PTB-CP-3, Physikalisch-Technische Bundesanstalt,
Braunschweig und Berlin (2009).

[4]

Herrmann, S.; Kretzschmar, H.-J.; Teske, V.; Vogel, E.; Ulbig, P.; Span, R.; Gatley,
D.P.: Properties of Humid Air for Calculating Power Cycles, J. Eng. Gas Turbines
Power, submitted (2009).

[5]

IAPWS. Revised Release on the IAPWS Formulation 1995 for the Thermodynamic
Properties of Ordinary Water Substance for General and Scientific Use. (2009),
available from www.iapws.org.

[6]

Wagner, W.; Pru, A.: The IAPWS Formulation 1995 for the Thermodynamic Properties
of Ordinary Water Substance for General and Scientific Use. J. Phys. Chem. Ref. Data
31, 387-535 (2002).

[7]

IAPWS. Revised Release on the IAPWS Industrial Formulation 1997 for the
Thermodynamic Properties of Water and Steam IAPWS-IF97. (2007), available from
www.iapws.org.

[8]

Wagner, W.; Kretzschmar, H.-J.: International Steam Tables. Springer, Berlin (2008).

[9]

Parry, W.T.; Bellows, J.C.; Gallagher, J.S.; Harvey, A.H.: ASME International Steam
Tables for Industrial Use. ASME Press, New York (2000).

[10]

IAPWS. Revised Release on the Equation of State 2006 for H2O Ice Ih. (2009);
available from www.iapws.org.

[11]

IAPWS. Revised Release on the Pressure along the Melting and Sublimation Curves of
Ordinary Water Substance. (2008); available from www.iapws.org.

[12]

Nelson, H.F.; Sauer, H.J.: Formulation of High-Temperature Properties for Moist Air.
HVAC&R Research 8, 311-334 (2002).

[13]

Gatley, D.P.: Understanding Psychrometrics, 2nd ed., ASHRAE, Atlanta (2005).

[14]

Lemmon, E.W.; Jacobsen, R.T.; Penoncello, S.G.; Friend, D.G.: Thermodynamic


Properties of Air and Mixture of Nitrogen, Argon, and Oxygen from 60 to 2000 K at
Pressures to 2000 MPa. J. Phys. Chem. Ref. Data 29, 331-385 (2000).

[15]

Harvey, A.H.; Huang, P.H.: First-Principles Calculation of the Air-Water Second Virial
Coefficient. Int. J. Thermophys. 28, 556-565 (2007).

[16]

IAPWS. Guideline on the Henry's Constant and Vapor-Liquid Distribution Constant for
Gases in H2O and D2O at High Temperatures. (2004), available from www.iapws.org.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

I-P 5/2

[17]

Gatley, D.P.; Herrmann, S.; Kretzschmar, H.-J.: A Twenty-First Century Molar Mass for
Dry Air. HVAC&R Research 14, 655-662 (2008).

[18]

Lemmon, E.W.; Jacobsen, R.T.: Viscosity and Thermal Conductivity Equations for
Nitrogen, Oxygen, Argon, and Air. Int. J. Thermophys. 25, 21-69 (2004).

[19]

IAPWS. Release on the IAPWS Formulation 2008 for the Viscosity of Ordinary Water
Substance. (2008), available from www.iapws.org.

[20]

IAPWS. Revised Release on the IAPS Formulation 1985 for the Thermal Conductivity
of Ordinary Water Substance. (2008), available from www.iapws.org.

[21]

Hyland, R.W.; Wexler, A.: Formulations for the Thermodynamic Properties of Dry Air
from 173.15 K to 473.15 K, and of Saturated Moist Air from 173.15 K to 372.15 K, at
Pressures to 5 MPa. ASHRAE Trans. 89, 520-535 (1983).

[22]

Mohr, P.J.; Taylor, P.N.: CODATA Recommended Values of the Fundamental Physical
Constants: 2002. Rev. Mod. Phys. 77, 1-107 (2005).

[23]

ASHRAE. 2009 Handbook of Fundamentals. Chapter 1 - Psychrometrics. American


Society of Heating, Refrigerating, and Air-Conditioning Engineers, Inc., Atlanta, GA
(2009).

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

Part SI Units

SI 1/2

1 Property Library ASHRAE-LibHuAirProp-SI


1.1 Function Overview
1.1.1 Function Overview for Real Moist Air
Functional
Dependence

Function Name

Property or Function

Unit of the
Result

a = f( p, t ,W )

a_ptW_HAP_SI

Thermal diffusivity

m/s

3/2

p = f( p, t ,W )

alphap_ptW_HAP_SI

Relative pressure coefficient

1/K

3/3

p = f( p, t,W )

betap_ptW_HAP_SI

Isothermal stress coefficient

kg/m

3/4

c = f( p, t ,W )

c_ptW_HAP_SI

Speed of sound

m/s

3/5

c p = f( p, t ,W )

cp_ptW_HAP_SI

Specific isobaric heat capacity

kJ/(kgK)

3/6

cv = f( p, t ,W )

cv_ptW_HAP_SI

Specific isochoric heat capacity

kJ/(kgK)

3/7

f = f( p, t )

f_pt_HAP_SI

Enhancement factor (decimal ratio)

3/8

h = f( p, t ,W )

h_ptW_HAP_SI

Air-specific enthalpy

kJ/kga

3/9

= f( p, t ,W )

Eta_ptW_HAP_SI

Dynamic viscosity

Pas

3/10

= f( p, t ,W )

Kappa_ptW_HAP_SI

Isentropic exponent

3/11

= f( p, t ,W )

Lambda_ptW_HAP_SI

Thermal conductivity

W/(mK)

3/12

= f( p, t ,W )

Ny_ptW_HAP_SI

Kinematic viscosity

m/s

3/13

p = f(t , s,W )

p_tsW_HAP_SI

Pressure of humid air

kPa

3/14

p = f( zele )

p_zele_HAP_SI

Pressure of humid air from elevation

kPa

3/15

pAir = f( p, t ,W )

pAIR_ptW_HAP_SI

Partial pressure of dry air in moist air

kPa

3/16

pH2O = f( p, t ,W )

pH2O_ptW_HAP_SI

Partial pressure of water vapor in moist air

kPa

3/17

pH2Os = f( p, t )

pH2Os_pt_HAP_SI

Partial saturation pressure of water vapor

kPa

3/18

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

Page

SI 1/3
Functional
Dependence

Function Name

Property or Function

Unit of the
Result

Page

= f( p, t ,W )

phi_ptW_HAP_SI

Relative humidity (decimal ratio)

3/19

Pr = f( p, t ,W )

Pr_ptW_HAP_SI

PRANDTL number

3/20

Air = f(W )

PsiAir_W_HAP_SI

Mole fraction of dry air in moist air

mola/mol

3/21

H2O = f(W )

PsiH2O_W_HAP_SI

Mole fraction of water vapor in moist air

molw/mol

3/22

= f( p, t ,W )

Rho_ptW_HAP_SI

Density

kg/m

3/23

s = f( p, t ,W )

s_ptW_HAP_SI

Air-specific entropy

kJ/(kgaK)

3/24

t = f( p, h, )

t_phphi_HAP_SI

Backward function: temperature from total pressure, air-specific


enthalpy and relative humidity

3/25

t = f( p, h,W )

t_phW_HAP_SI

Backward function: temperature from total pressure, air-specific


enthalpy and humidity ratio

3/26

t = f( p, s,W )

t_psW_HAP_SI

Backward function: temperature from total pressure, air-specific


entropy and humidity ratio

3/27

t = f( p, t wb ,W )

t_ptwbW_HAP_SI

Backward function: temperature from total pressure, wet-bulb


temperature and humidity ratio

3/28

t d = f( p,W )

td_pW_HAP_SI

Dew-point/frost-point temperature

3/29

t s = f( p, pH2O )

ts_ppH2O_HAP_SI

Backward function: saturation temperature of water from total


pressure and partial pressure of water vapor

3/30

t wb = f( p, t ,W )

twb_ptW_HAP_SI

Wet-bulb/ice-bulb temperature

3/31

u = f( p, t ,W )

u_ptW_HAP_SI

Air-specific internal energy

kJ/kga

3/32

v = f( p, t ,W )

v_ptW_HAP_SI

Air-specific volume

m/kga

3/33

W = f( p, t, pH2O )

W_ptpH2O_HAP_SI

Humidity ratio from total pressure, temperature, and partial pressure


of water vapor

kgw/kga

3/34

W = f( p, t , )

W_ptphi_HAP_SI

Humidity ratio from total pressure, temperature, and relative humidity kgw/kga

3/35

W = f( p, td )

W_ptd_HAP_SI

Humidity ratio from total pressure and dew-point temperature

3/36

kgw/kga

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 1/4
Functional
Dependence

Function Name

Property or Function

Unit of the
Result

Page

W = f( p, t, t wb )

W_pttwb_HAP_SI

Humidity ratio from total pressure, (dry bulb) temperature, and wetbulb temperature

kgw/kga

3/37

Ws = f( p, t )

Ws_pt_HAP_SI

Saturation humidity ratio

kgw/kga

3/38

Air = f(W )

XiAir_W_HAP_SI

Mass fraction of dry air in moist air

kga/kg

3/39

H2O = f(W )

XiH2O_W_HAP_SI

Mass fraction of water vapor in moist air

kgw/kg

3/40

Z = f( p, t ,W )

Z_ptW_HAP_SI

Compression factor (decimal ratio)

3/41

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 1/5

Range of Validity of Thermodynamic Properties


Property

Units

Range of Validity
p 10 000 kPa

Symbol

Quantity

Unit

Pressure

kPa

Temperature

Humidity ratio

kgw/kga (kg water / kg dry air)

Relative humidity

(decimal ratio)

350

td

Dew point temperature

350

twb

Wet bulb temperature

0.01

143.15

350

Humidity ratio:

10

kgw/kga

Relative humidity:

(decimal ratio)

Dew-point temperature:

143.15

td

Wet-bulb temperature:

143.15

t wb

Pressure:
Temperature:

Range of Validity of Transport Properties


Property

Range of Validity
p 10 000 kPa

0.01

73.15

350

Humidity ratio:

10

kgw/kga

Relative humidity:

(decimal ratio)

Pressure:
Temperature:

Molar Masses
Molar Mass

Reference

Dry Air

28.966 kg/kmol

[17]

Water

18.015268 kg/kmol

[5], [6]

Component

Reference States
Property

Dry Air

Steam, Water, and Ice

Pressure

101.325 kPa

ps(0.01C) = 0.611657 kPa

0C

0.01C

Enthalpy

0 kJ/kg

0.000611782 kJ/kg

Entropy

0 kJ/(kg K)

0 kJ/(kg K)

Temperature

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 1/6

1.1.2 Function Overview for Steam and Water for Temperatures t 0C


Functional
Dependence

Function Name

Property

hliq = f( p, t )

hliq_pt_97_SI

Specific enthalpy of liquid water

kJ/kg

3/43

hliq,s = f(t )

hliqs_t_97_SI

Specific enthalpy of saturated liquid water

kJ/kg

3/44

hvap,s = f(t )

hvaps_t_97_SI

Specific enthalpy of saturated water vapor

kJ/kg

3/45

ps = f(t )

ps_t_97_SI

Saturation pressure of water

kPa

3/46

sliq = f( p, t )

sliq_pt_97_SI

Specific entropy of liquid water

kJ/(kgK)

3/47

sliq,s = f(t )

sliqs_t_97_SI

Specific entropy of saturated liquid water

kJ/(kgK)

3/48

svap,s = f(t )

svaps_t_97_SI

Specific entropy of saturated water vapor

kJ/(kgK)

3/49

ts = f( p )

ts_p_97_SI

Saturation temperature of water

3/50

v liq = f( p, t )

vliq_pt_9_SI

Specific volume of liquid water

m/kg

3/51

v liq,s = f(t )

vliqs_t_97_SI

Specific volume of saturated liquid water

m/kg

3/52

v vap,s = f(t )

vvaps_t_97_SI

Specific volume of saturated water vapor

m/kg

3/53

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

Unit of the
Result

Page

SI 1/7

Range of Validity
Property

Pressure:

Units
Range of Validity

0.01 p
0 t

Temperature:

Symbol

Quantity

Unit

10 000 kPa

Pressure

kPa

350

Temperature

Reference State
Property

Pressure
Temperature

Water Vapor and Liquid


Water
ps(0.01C) = 0.611657 kPa

0.01C

Enthalpy

0.000611782 kJ/kg

Entropy

0 kJ/(kg K)

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 1/8

1.1.3 Function Overview for Steam and Ice for Temperatures t 0C


Functional
Dependence

Function Name

Property

Unit of the
Result

Page

hice,sub = f(t )

hicesub_t_06_SI

Specific enthalpy of saturated ice

kJ/kg

3/55

hvap,sub = f(t )

hvapsub_t_95_SI

Specific enthalpy of saturated water vapor

kJ/kg

3/56

pmel = f(t )

pmel_t_08_SI

Melting pressure of ice

kPa

3/57

psub = f(t )

psub_t_08_SI

Sublimation pressure of ice

kPa

3/58

sice,sub = f(t )

sicesub_t_06_SI

Specific entropy of saturated ice

kJ/(kgK)

3/59

svap,sub = f(t )

svapsub_t_95_SI

Specific entropy of saturated water vapor

kJ/(kgK)

3/60

tmel = f( p )

tmel_p_08_SI

Melting temperature of ice

3/61

tsub = f( p )

tsub_p_08_SI

Sublimation temperature of ice

3/62

v ice,sub = f(t )

vicesub_t_06_SI

Specific volume of saturated ice

m/kg

3/63

v vap,sub = f(t )

vvapsub_t_95_SI

Specific volume of saturated water vapor

m/kg

3/64

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 1/9

Range of Validity
Property

Pressure:

Units
Range of Validity

psub(143.15C) = 1.2002 x 10

Temperature:

11

143.15

Symbol

Quantity

Unit

p 10 000 kPa

Pressure

kPa

t 0

Temperature

Reference State
Property

Water Vapor and Ice

Pressure

ps(0.01C) = 0.611657 kPa

Temperature

0.01C

Enthalpy

0.000611782 kJ/kg

Entropy

0 kJ/(kg K)

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 1/10

1.2 Conversion of SI and I-P Units


Property

Conversion: SI Units I-P Units

Thermal diffusivity

Relative pressure

coefficient
Isothermal stress

coefficient

Speed of sound

Specific isobaric

cp

heat capacity

Specific isochoric
heat capacity

Dynamic viscosity

Enhancement
factor

Conversion: I-P Units SI Units

aIP aSI
=
10.76391042
ft
m
s
s

aSI aIP
=
0.0929304
m
ft
s
s

p,IP

p,SI

1
R
p,IP
lb
ft

p,SI
1
K
p,SI
kg
m

9
5

0.062428

1
K
p,SI
kg
m

p,IP
1
R
p,IP
lb
ft

5
9

16.018463

cIP cSI
=
3.2808399
ft
m
s
s

cSI cIP
=
0.3048
m
ft
s
s

c p,IP

c p,SI

Btu
lb R

c p,SI
kJ
kg K

0.2388459

kJ
kg K

c p,IP
Btu
lb R

4.1868

Units SI

Units I-P

m/s

ft/s

1/K

1/R

kg/m

lb/ft

m/s

ft/s

kJ/(kgK)

Btu/(lbR)

cv

cv ,IP
cv ,SI
=
0.2388459
Btu
kJ
lb R kg K

cv ,SI
cv ,IP
=
4.1868
kJ
Btu
kg K lb R

kJ/(kgK)

Btu/(lbR)

IP
= SI 0.02088543
lb s Pa
ft
s

SI

= IP 47.880259
Pa lb s
s
ft

Pas

lbs/ft

fIP = fSI

fSI = fIP

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 1/11

Property

Conversion: SI Units I-P Units

Air-specific
enthalpy

(moist air)
Specific enthalpy
(water, water

exponent
Thermal
conductivity
Kinematic
viscosity

hSI
kJ
kga

Units SI

Units I-P

= IP 7.68565365666 2.326
Btu

lb

kJ/kga

Btu/lba

kJ/kg

Btu/lb

W/(mK)

Btu/(hftR)

m/s

ft/s

kPa

psi

hw

hIP hSI
=
0.4299226
Btu kJ
lb
kg

hSI hIP
=
2.326
kJ Btu
kg
lb

IP = SI

SI = IP

Btu
h ft R

vapor, ice)
Isentropic

h
hIP
= SI 0.4299226 + 7.68565365666
Btu
kJ
lba
kga

Conversion: I-P Units SI Units

IP

SI

W
mK

SI

0.57778932

W
mK

= SI 10.763910417
ft m
s
s
p
pIP
= SI 0.14503774
psi kPa

SI

IP

IP

Btu
h ft R

1.73073467

= IP 0.092903040
m ft
s
s
pSI pIP
=
6.894757
kPa psi

Pressure

Relative humidity

IP = SI

SI = IP

Prandtl number

Pr

PrIP = PrIP

PrSI = PrIP

Mole fraction

IP = SI

SI = IP

mol/mol

mol/mol

Density

kg/m

lb/ft

kJ/(kgaK)

Btu/(lbaR)

Air-specific
entropy
(moist air)

IP
lb
ft

sIP

Btu
lba R

SI
kg
m
=

SI

0.062428

sSI
kJ
kga K

kg
m

0.2388459 + 0.01616365106

IP
lb
ft

16.018463

sSI
s
= IP 0.01616365106 4.1868
kJ
Btu

kga K lba R

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 1/12

Property

Conversion: SI Units I-P Units

Specific entropy
(water, water

sw

vapor, ice)
Temperature

Air-specific
internal energy

(moist air)

volume

sSI
sIP
=
4.1868
kJ
Btu
kga K lba R

tIP tSI 9
=
+ 32
F C 5

tSI tIP
5
=
32
C F
9

(u = h pv )

(u = h pv )

uIP
=
Btu
lba

IP

(moist air)
Specific volume
(water, water

sSI
sIP
=
0.23884589
Btu
kJ
lba R kga K

hSI
0.4299226 + 7.68565365666
kJ
kga

p
SI 0.145037738 SI 16.018453
m
kPa
kga

Air-specific

vw

vapor, ice)

Conversion: I-P Units SI Units

ft
lba

IP
ft
lb

SI
m
kga

16.018453

= SI 16.018453
m
kg

uSI
h

= IP 7.68565365666 2.236
kJ
Btu

kga
lba

p
IP 6.894757293 SIP 0.062428
ft
psi
lba

SI
m
kga

SI
m
kg

= IP 0.062428
ft
lba

= IP 0.062428
ft
lb

Units SI

Units I-P

kJ/(kgaK)

Btu/(lbaR)

kJ/kga

Btu/lb

m/kga

ft/lba

m/kg

ft/lb

Humidity ratio

WIP = WSI

WSI = WIP

kgw/kga

lbw/lba

Mass fraction

IP = SI

SI = IP

kgw/kg

lbw/lb

ZIP = ZSI

ZSI = ZIP

Compression
factor

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 1/13

1.3 Calculation Algorithms


1.3.1 Algorithms for Real Moist Air
The properties of moist air are calculated from the modified Hyland-Wexler model given in Herrmann,
Kretzschmar, and Gatley (HKG) [1], [2]. The modifications incorporate:

the value for the universal molar gas constant from the CODATA standard by Mohr and Taylor
[22]
the value for the molar mass of dry air from Gatley et al. [17] and that of water from IAPWS-95
[5], [6]
the calculation of the ideal-gas parts of the heat capacity, enthalpy, and entropy for dry air from
the fundamental equation of Lemmon et al. [14]
the calculation of the ideal-gas parts of the heat capacity, enthalpy, and entropy for water
vapor from IAPWS-IF97 [7], [8], [9] for t 0C and from IAPWS-95 [5], [6] for t 0C

the calculation of the vapor-pressure enhancement factor from the equation given by the
models of Hyland and Wexler [21]
the calculation of the second and third molar virial coefficients Baa and Caaa for dry air from
the fundamental equation of Lemmon et al. [14]
the calculation of the second and third molar virial coefficients Bww and Cwww for water and
steam from IAPWS-95 [5], [6]
the calculation of the air-water second molar cross-virial coefficient Baw from Harvey and
Huang [15]
the calculation of the air-water third molar cross-virial coefficients Caaw and Caww from Nelson
and Sauer [12], [13]
the calculation of the saturation pressure of water from IAPWS-IF97 [7], [8], [9] for t 0C and
of the sublimation pressure of water from IAPWS-08 [11] for t 0C
the calculation of the isothermal compressibility of saturated liquid water from IAPWS-IF97 [7],
[8], [9] for t 0C and that of ice from IAPWS-06 [10] for t 0C in the determination of the
vapor-pressure enhancement factor
the calculation of Henry's constant from the IAPWS Guideline 2004 [16] in the determination of
the enhancement factor. The mole fractions for the three main components of dry air were
taken from Lemmon et al. [14]. Argon was not considered in the calculation of Henrys constant
in the former research projects, but it is now the third component of dry air.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 1/14

1.3.2 Algorithms for Steam and Water for Temperatures t 0C


The p-T diagram in Fig. 1 shows the formulations used for water and water vapor. The temperature
range above 0C is covered by IAPWS-IF97 [7], [8], [9]:

The saturation line is calculated from the IAPWS-IF97 saturation pressure equation ps97 (t )
and saturation temperature equation ts97 ( p ) .

The properties in the liquid region including saturated-liquid line are calculated from the
fundamental equation of the IAPWS-IF97 region 1.

The properties in the vapor region including saturated-vapor line are calculated from the
fundamental equation of the IAPWS-IF97 region 2.

1.3.3 Algorithms for Steam and Ice for Temperatures t 0C

08
The sublimation curve is covered by the IAPWS-08 sublimation pressure equation psubl
(t )
[11] (see Fig. 1).

The properties of ice including saturated ice are determined by the fundamental equation of
the IAPWS-06 [10].

The properties of vapor including saturated vapor are calculated from the fundamental
equation of IAPWS-95 [5], [6].

1.3.4 Overview of the Applied Formulations for Steam, Water, and Ice
The following p-T diagram shows the used IAPWS Formulations and the ranges where they are
applied.

Figure 1: p-T diagram with used IAPWS formulations for steam, water, and ice.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/1

2
2.1

Add-Ins for ASHRAE-LibHuAirProp-SI


Graphics

Add-In FluidEXL

for Excel

The FluidEXLGraphics Add-In has been developed to calculate thermophysical properties in Excel

more conveniently. Within Excel , it enables the direct call of functions relating to real moist air,
steam, water, and ice from the ASHRAE-LibHuAirProp-SI property library.

2.1.1 Installing FluidEXL

Graphics

including LibHuAirProp

The installation of FluidEXLGraphics and ASHRAE-LibHuAirProp_SI is described in Section 2.1.1 in


"Part I-P Units" of this User's Guide.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/2

2.1.2 Example: Calculation of h = f(p,t,W)


We will now calculate, step by step, the air-specific enthalpy h of real moist air as a function of total
pressure p, temperature t and humidity ratio W, using FluidEXLGraphics. The following description

relates to Excel 2003. The procedure is analogous for Excel 97, 2000, XP, and 2007.
Please carry out the following steps:

Start Excel

Enter the value for p in kPa into a cell


(Range of validity:
p = 0.01 10 000 kPa
e.g.: Enter the value 101.325 into cell A2

Enter the value for t in C into a cell


(Range of validity:
t = 143.15 ... 350C)
e.g.: Enter the value 20 into cell B2

Enter the value for W in kgw/kga (kg water per kg air) into a cell
(Range of validity: W = 0 10 kgw/kga)
e.g.: Enter the value 0.01 into cell C2

Click the cell in which the air-specific enthalpy h in kJ/kga is to be displayed


e.g.: Click the cell D2

Click "Calculate" in the FluidEXLGraphics menu bar


The "Insert Function" window appears (see Figure 2.1.1.)

Figure 2.1.1: Choosing the library and function name

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/3

Search and click the "ASHRAE-LibHuAirProp-SI" library under "Or select a category:" in
the upper part of the window
Search and click the "h_ptW_HAP_SI" function under "Select a function:" right below
Click the "OK button
The "Function Arguments" menu for the function "h_ptW_HAP_SI" in the next figure will
now appear.

Figure 2.1.2: Input menu for the function


-

The cursor is now situated on the line next to "p in kPa". You can now enter the value
for the mixture pressure p either by clicking the cell with the value for p, by entering
the name of the cell, or by entering the value for p directly into the line next to "p in
kPa".
e. g.: Click the cell A2

Situate the cursor on the line next to "t in C" and enter the value for t either by clicking
the cell with the value for t, by entering the name of the cell, or by entering the value
for t directly into the line next to "t in C".
e. g.: Type B2 into the line next to "t in C"

Situate the cursor on the line next to "W in kgw/kga" and enter the value for the
humidity ratio W either by clicking the cell with the value for W, by entering the name
of the cell, or by entering the value for W directly into the line next to "W in kgw/kga.
e. g.: Click the cell C2
H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/4

- Here it is possible to get detailed information on the "h_ptW_HAP_SI" property function.


- Click the blue "Help on this function" link in the lower left-hand edge of the "Function Arguments"
window.
You may be informed that the "LibHuAirProp_SI.hlp" function help cannot be found. In this case,
confirm the question whether you want to look for it yourself with "Yes". Search and click on the
"LibHuAirProp_SI.hlp" file in the installation menu of FluidEXLGraphics in the window which is
opened, in the standard case
C:\Program Files\FluidEXL_Graphics_Eng
and click "Yes" in order to complete the search.
- Now you should see the help page of the "h_ptW_HAP_SI" property function (see Figure 2.1.3).

Figure 2.1.3: Help page for the "h_ptW_HAP_SI" function


- Click the "OK" button
The result for h in kJ/kga appears in the cell selected above.
The cell D2 now contains the value 45.48662391.
The calculation of h = f(p,t,W) has thus been completed.
You can now arbitrarily change the values for p, t or W in the appropriate cells. The specific

enthalpy h is recalculated and updated every time you change the data. This shows that the Excel
data flow and the DLL calculations are working together successfully
H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/5

Note:
If the calculation results in -1000, this indicates that the values entered are located outside the
range of validity of real moist air. More detailed information on each function and its range of
validity is available in Chapter 3.
For further property functions calculable in FluidEXLGraphics see the function table in Chapter 1.

2.1.3 Removing FluidEXL

Graphics

including LibHuAirProp

The de-installation of FluidEXLGraphics and ASHRAE-LibHuAirProp_SI is described in Section


2.1.3 in "Part I-P Units" of this User's Guide.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/6

2.2 Add-In FluidLAB for MATLAB

The FluidLAB Add-In has been developed to calculate thermodynamic properties in MATLAB

more conveniently. Within MATLAB it enables the direct call of functions relating to real moist air,
steam, water, and ice from the ASHRAE-LibHuAirProp-SI property library.

2.2.1 Installing FluidLAB including LibHuAirProp


The installation of FluidLAB and ASHRAE-LibHuAirProp_SI is described in Section 2.2.1 in
"Part I-P Units" of this User's Guide.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/7

2.2.2

Example: Calculation of h = f(p,t,W) in an M-File

Now we will calculate, step by step, the air-specific enthalpy h of moist air as a function of mixture

pressure p, given temperature t and given humidity ratio W, using MATLAB .


Please carry out the following instructions:

- Start Windows Explorer , Total Commander , My Computer or another file manager program.

The following description refers to Windows Explorer

- Your Windows Explorer should be set to "Details" for easier viewing. Click the "Views" button
and select "Details".
- Switch into the program directory of FluidLAB in which you will find the folder "\LibHuAirProp"; it
is generally saved under: "C:\Program Files\FluidLAB"

- Create the folder "\LibHuAirProp_SI_Example" by clicking on "File" in the Explorer menu, then
"New" in the menu which appears and afterwards selecting "Folder". Name the new folder
"\LibHuAirProp_SI_Example".
- You will now see the following window:

Figure 2.2.1: Folders "LibHuAirProp" and "LibHuAirProp_SI_Example"


- Switch into the directory "\LibHuAirProp" within "\FluidLAB", the standard being:
"C:\Program Files\FluidLAB\LibHuAirProp".

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/8

You will see the following window:

Figure 2.2.2: Contents of the folder "LibHuAirProp"


You
will
now
have
to
copy
the
following
files
into
the
"C:\Program Files\FluidLAB\LibHuAirProp_SI_Example" in order to calculate the function
h = f(p,t,W).

directory

- The following eight files are needed:


"advapi32.dll"
"Dformd.dll"
"Dforrt.dll"
"h_ptW_HAP_SI.mexw32"
"LCKCE.dll"
"LibHuAirProp_SI.dll"
"msvcp60.dll"
"msvcrt.dll".
- Click the file "h_ptW_HAP_SI.mexw32", then click "Edit" in the upper menu bar and select
"Copy".

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/9

- Switch into the directory "C:\Program Files\FluidLAB\LibHuAirProp_SI_Example", click "Edit"


and then "Paste".
- Repeat these steps in order to copy the other files listed above. You may also select all the
above-named files and then copy them as a group (press the Control button to enable multiple
markings).
- You will see the following window:

Figure 2.2.3: Contents of the folder "LibHuAirProp_SI_Example"

- Start MATLAB (if you have not started it already).


- Click the button marked in the following image in order
"\LibHuAirProp_SI_Example" in the "Current Directory" window.

to

open

the

folder

Figure 2.2.4: Selection of the working directory


-

Find and select the directory "C:\Program Files\FluidLAB\LibHuAirProp_SI_Example" in the


pop-up menu (see figure below).

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/10

Figure 2.2.5: Choosing the "LibHuAirProp_SI_Example" folder


- Confirm your selection by clicking the "OK" button.

- First of all you need to create an MFile in MATLAB . Within MATLAB click "File", then "New"
and afterwards click "M-File".
- If the "Editor" window appears as a separate window, you can embed it into MATLAB
clicking the insertion arrow (see next figure) in order to obtain a better view.

Figure 2.2.6: Embedding the "Editor" window


- In the following figure you will see the "Editor - Untitled" window.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

by

SI 2/11

Figure 2.2.7: Embedded "Editor" window


- Now type the following lines in the "Editor - Untitled" window:
Text to be written:

Explanation:

% h_ptW_HAP_SI.m
%%
p=101.325; % pressure in kPa
t=20;
% temperature in C

file name as comment


paragraph separation
declaration of the
variables pressure,
temperature, art and
composition of mixture
paragraph separation
function call
paragraph separation

W=0.01;

% humidity ratio W in kgw/kga

%%
h=h_ptW_HAP_SI(p,t,W)
%%

- Remarks:
The program interprets the first line, starting with "%," to be a data description in
"Current Directory"
Paragraph separations which are mandatory are marked with "%%". This also servers
to separate the declaration of variables and calculation instructions.
The words which are printed in green, start with "%" and come after the variables are
comments. They are not in fact absolutely necessary, but they are very helpful for
your overview and to make the process more easily understood
Omit the semicolons after the numerical values if you wish to see the result for h and
the input parameters.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/12

The values of the function parameters in their corresponding units stand for:
- First operand: Value for p = 101.325 kPa
(Range of validity:
p = 0.01 10000 kPa)
- Second operand: Value for t = 20C
(Range of validity:
t = 143.15 ... 350C)
- Third operand: Value for W = 0.01 kgw/kga (kg water per kg air)
(Range of validity:
W = 0 10 kgw/kga)
- Save the "M-File" by clicking the "File" button and then click "Save As...".
- The menu "Save file as:" appears; In this menu, the folder name "LibHuAirProp_SI_Example"
must be displayed in the "Save in:" field.
- Next to "File name" you have to type "Example_h_ptW_HAP_SI.m" and afterwards click the
"Save" button.
- You will now see the following window:

Figure 2.2.8: "Example_h_ptW_HAP_SI.m" M-file


- Within the "Current Directory" window the file "Example_h_ptW_HuAirProp_SI.m" appears.
- Right-click on this file and select "Run" in the menu which appears (see next figure).

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/13

Figure 2.2.9: Running the "Example_h_ptW_HAP_SI.m" M-file


- You will see the following window:

Figure 2.2.10: MATLAB with calculated result


H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/14

The result for h appears in the "Command Window"


The result in our sample calculation here is: "h = 45.4866239115793". The corresponding unit is
kJ/kg (see table of the property functions in Chapter 1).
To be able to calculate other values, you have to copy the associated mexw32 files as well

because MATLAB can only access functions that are located in the "Current Directory" window.
The calculated example can be found in the directory
"C:\Program Files\FluidLAB\LibHuAirProp_SI_Example"
and you may use it as a basis for further calculations with FluidLAB.

2.2.3

Example: Calculation of h = f(p,t,W) in the Command Window

- Please follow the instructions from page 2/7 to 2/9.


-

Start MATLAB (if you have not started it before).

- Click the button marked in the following image in order to open the folder
"\LibHuAirProp_SI_Example" in the window "Current Directory.

Figure 2.2.11: Selection of the working directory


- Find and select the directory "C:\ProgramFiles\FluidLAB\LibHuAirProp_SI_Example" in the popup menu (see figure below).

Figure 2.2.12: Choosing the "LibHuAirProp_SI_Example" folder


H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/15

- Confirm your selection by clicking the "OK" button.


- You will see the following window:

Figure 2.2.13: MATLAB with necessary files


Corresponding to the table of the property functions in Chapter 1 you have to call up the function
"h_ptW_HAP_SI" as follows for calculating h = f(p,t,W)
Write "h=h_ptW_HAP_SI (101.325,20,0.01)" within the "Command Window"
The values of the function parameters in their corresponding units stand for:
- First operand: Value for p = 101.325 kPa
(Range of validity:
p = 0.01 10 000 kPa)
- Second operand: Value for t = 20C
(Range of validity:
t = 143.15 ... 350C)
- Third operand: Value for W = 0.01 kgw/kga (kg water per kg air)
(Range of validity:
W = 0 10 kgw/kga)
-

Confirm your entry by pressing the "ENTER" button.

- You will see the following window:

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/16

Figure 2.2.14: MATLAB with calculated result


The result for h appears in the "Command Window"
The result in our sample calculation here is: "h = 45.4866239115793". The corresponding unit is
kJ/kg (see table of the property functions in Chapter 1).
To be able to calculate other values, you will have to copy the respective mexw32 files into the

working directory as well, because MATLAB can only access functions that are located in the
"Current Directory" window.

2.2.4 Removing FluidLAB including LibHuAirProp


The de-installation of FluidLAB and ASHRAE-LibHuAirProp_SI is described in Section 2.2.4 in
"Part I-P Units" of this User's Guide.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/17

2.3 Add-In FluidMAT for Mathcad

The FluidMAT Add-In has been developed to calculate thermodynamic properties in Mathcad
more conveniently.

Within Mathcad it enables the direct call of functions relating to real moist air, steam, water, and
ice from the ASHRAE-LibHuAirProp-SI property library.

2.3.1

Installing FluidMAT including LibHuAirProp

The installation of FluidMAT and ASHRAE-LibHuAirProp_SI is described in Section 2.3.1 in


"Part I-P Units" of this User's Guide.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/18

2.3.2

Example: Calculation of h = f(p,t,W)

Now we will calculate, step by step, the air-specific enthalpy h as a function of pressure p,
temperature t and humidity ratio W of moist air, using FluidMAT.
Please carry out the following steps:

- Start Mathcad .
- Type "p:" and enter the value for pressure p in bar
(Range of validity:
p = 0.01 10 000 kPa)
e.g.: Enter "p:101.325", then press the tabulator button and enter "in kPa".

Note:
When typing in the comment containing the unit of the input parameter, Mathcad switches into the
text mode, since you type in a space using the space bar, e.g. "in<space>kPa". The text modus is
marked by a red cursor instead of a blue one in the math mode. After typing a comment, always
finish by positioning the mouse pointer below the variable typed in before and clicking the left
mouse button to switch back to math mode.
- Type "t:" and enter the value for temperature t in C
(Range of validity: t = 143.15 ... 350C)
e.g.: Enter "t:20", then press the tabulator key and enter "in C".
- Type "W:" and er the value for the humidity ratio in kgw/kga (kg water per kg air)
(Range of validity: W = 0 10 kgw/kga)
e.g.: Enter "W:0.01", then press the tabulator key and enter "in kgw/kga".

The Mathcad sheet should now look as shown in Figure 2.3.1.

Figure 2.3.1: Example Mathcad sheet after input of the given parameters
- Enter the symbol for the result and then a colon
e.g.: Type "h:" and press the Enter key

- Click "Insert" in the Mathcad menu bar and then "Function"


The "Insert function" window appears (see Figure 2.3.2)
- Click "LibHuAirProp_SI" under "Function Category" on the left hand side (see Figure 2.3.2)
- Choose "h_ptW_HAP_SI" under "Function name" on the right hand side

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/19

Figure 2.3.2: Choice of library and function name


- Click the "OK" button

Now you will see the line "h_ptW_HAP_SI(, , )" in the Mathcad window
(see Figure 2.3.3).

Figure 2.3.3: Example Mathcad sheet with formula and placeholders


- The cursor is now situated on the first operand. You can now enter the value for p either by
entering the value directly or by entering the name of the variable where the value was saved.
e.g.: Enter "p".
- Situate the cursor on the next placeholder. You can now enter the value for the temperature t
either by entering the value for t directly or by typing the name of the variable in which the value
of the temperature has been saved.
e.g.: Enter "t".

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/20

- Situate the cursor on the next placeholder. You can now enter the value for the humidity ratio W
either by entering the value for W directly or by typing the name of the variable in which the
value of the humidity ratio has been saved.
e.g.: Enter "W".
- Close the input formula by pressing the "Enter" key.
- You can now go on working with the variable h which we have just calculated, or you can have
the result for this calculated. If you wish to see the result, type the command "h=" on the next

line in the Mathcad window


- The result for h in kJ/kga appears. To add the unit, press the tabulator button twice and enter "in
kJ/kga".
The result in our sample calculation here is: h = 45.487 kJ/kga.
The representation of the result depends on the number of decimal places which you have set in
Mathcad.

Figure 2.3.4: Example Mathcad sheet with finished calculation


The calculation of h = f(p,t,W) has been carried out.
You can now arbitrarily change the values for p, t, and W. The air-specific enthalpy is recalculated

and updated every time you change the data. This shows that the Mathcad data flow and the DLL
calculations are working together successfully.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/21

2.3.3

Removing FluidMAT including LibHuAirProp

The de-installation of FluidMAT and ASHRAE-LibHuAirProp_SI is described in Section 2.3.3 in


"Part I-P Units" of this User's Guide.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/22

2.4 Add-In FluidESS for Engineering Equation Solver


The FluidEES Add-In has been developed to conveniently calculate thermodynamic properties in

the Engineering Equation Solver (EES). It enables, within EES , the direct call of functions
relating to real moist air, steam, water and ice from the ASHRAE-LibHuAirProp property library.

2.4.1 Installing FluidEES including LibHuAirProp


The installation of FluidEES and ASHRAE-LibHuAirProp_SI is described in Section 2.1 in "Part I-P
Units" of this User's Guide.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/23

2.4.2 Example: Calculation of h = f(p,t,W)


Now we will calculate, step by step, the air-specific enthalpy h of humid air as a function of total
pressure p, temperature t and humidity ratio W for humid air, using FluidEES with LibHuAirProp_SI

in the Engineering Equation Solver .


How to perform a calculation with FluidEES:

- Start Engineering Equation Solver (EES).


- The LibHuAirProp_SI library, if installed, is loaded by the program automatically.

- We recommend preparing an EES sheet, as shown in Figure 2.4.1.


Note: the units of p, t, and W must correspond to those in Chapter 1.

Figure 2.4.1: Preparing an EES sheet for the calculation


- The function parameter values stand for:
- First operand: Total pressure p = 101.325 kPa
(Range of validity: p = 0.01 10 000 kPa)
- Second operand: Temperature t = 20 C
(Range of validity: t = 143.15 ... 350C)
- Third operand: Humidity Ratio W = 0.01 kgw/kga (kg water per kg dry air)
(Range of validity: W = 0 10 kgw/kga)
- Confirm your entry by pressing the "ENTER" key.
Note:
EES adapts to the language that is set in the "Regional and Language Options," which can be

found in the "Control Panel." If you run Engineering Equation Solver on an English version of

Windows , the standard decimal separator will be a dot (as shown in Fig. 2.4.1 and in the following
sample calculation). If your computer is set to German, for example, the expected decimal
separator will be a comma. In this case enter a comma in the values above instead of a dot. You
can find additional information on this issue by clicking on "Help" in the EES menu bar and then
select "Help Index". Click on "Search" in the window which appears, type "decimal separator" and
press the "ENTER" key.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/24

- For calculating h = f(p,t,W), call up the function "h_ptW_HAP_SI" of the property library
LibHuAirProp_SI as follows:

- Click on "Options" in the EES menu bar and select "Function Info."
- The "Function Information" window will appear. Select "External routines" and you will see the
screen shown here in Figure 2.4.2.

Figure 2.4.2: "Function Information" window offering different libraries (routines)


- Double-click on the entry "LIBHUAIRPROP_SI.DLL".
- A list with calculable functions of the "LibHuAirProp_SI" library appears.
- Find and select the desired function, here "h_ptW_HAP_SI" function (see Figure 2.4.3) and click
the "Paste" button below.

Figure 2.4.3: Selecting the "h_ptW_HAP_SI" function


H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/25

- The selected function will be copied and now appears in the "Equations Window" (see
Fig. 2.4.4).

Figure 2.4.4: "Equations Window" with the call of the property function
- Now, you can check the syntax of the instructions in the "Equations Window" by clicking the

symbol in the upper menu bar of EES . The program tests whether or not the syntax is correct
(e.g. dots as decimal separators versus commas). Confirm the "Information" window which
appears by clicking the "OK" button.
- Then click the

symbol in the upper menu bar of EES to start the calculation.

- Soon you will see the "Calculations Completed" window. Leave this window by clicking the
"Continue" button.
- The result for the air-specific enthalpy h appears in the "Solution" window.

Figure 2.4.5: "Solution" window showing the result


The calculation of h = f(p,t,W) has thus been carried out.
The result in our sample calculation here is: "h = 45.4866". The corresponding unit is kJ/kga
(see table of the property functions in Chapter 1).
For further property functions calculable in FluidEES see the function table in Chapter 1.
H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 2/26

2.4.3 Removing FluidEES including LibHuAirProp


The de-installation of FluidEES and ASHRAE-LibHuAirProp_SI is described in Section 2.4.3 in
"Part I-P Units" of this User's Guide.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/1

3 Property Functions of the "LibHuAirProp_SI Library"


3.1 Functions for Real Moist Air

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/2

Thermal Diffusivity a = f(p,t,W)


Function Name:
a_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION A_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
a_ptW_HAP_SI - Thermal diffusivity of humid air in m 2 /s

Range of Validity:
Temperature t:

from -73.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W Ws

Comments:
- Thermal diffusivity a =

cp

- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


a_ptW_HAP_SI = -1000

References:
( p, t ,W )

Herrmann et al. [3], [4]

( p, t ,W )

Herrmann et al. [1], [2]

c p ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/3

Relative Pressure Coefficient p = f(p,t ,W )


Function Name:
alphap_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION ALPHAP_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
alphap_ptW_HAP_SI - Relative pressure coefficient of humid air in 1/K

Range of Validity:
Temperature t:

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W Ws

Comments:
- Relative pressure coefficient p =

1 p
p T v

- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


alphap_ptW_HAP_SI = -1000

References:
( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/4

Isothermal Stress Coefficient p = f(p,t ,W )


Function Name:
betap_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION BETAP_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
betap_ptW_HAP_SI - Isothermal stress coefficient of humid air in kg/m 3

Range of Validity:
Temperature t:

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W Ws

Comments:
- Isothermal stress coefficient p =

1 p
p v T

- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


betap_ptW_HAP_SI = -1000

References:
v ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/5

Speed of Sound c = f(p,t,W)


Function Name:
c_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION C_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
c_ptW_HAP_SI - Speed of sound of humid air in m/s

Range of Validity:
Temperature t:

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W 10 kgw /kga

Comments:
p
- Speed of sound c = v
v s
- When calculating supersaturated air an ideal mixing model (saturated humid air
and water droplets (or ice crystals) homogeneously mixed) is applied

Result for Wrong Input Values:


c_ptW_HAP_SI = -1000

References:
v ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/6

Specific Isobaric Heat Capacity c p = f(p,t ,W )


Function Name:
cp_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION CP_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
cp_ptW_HAP_SI - Specific isobaric heat capacity of humid air in kJ/(kg K)

Range of Validity:
Temperature t:

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W Ws

Comments:
h
- Specific isobaric heat capacity c p =

T p
- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


cp_ptW_HAP_SI = -1000

References:
h( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/7

Specific Isochoric Heat Capacity cv = f(p,t ,W )


Function Name:
cv_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION CV_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
cv_ptW_HAP_SI - Specific isochoric heat capacity of humid air in kJ/(kg K)

Range of Validity:
Temperature t:

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W Ws

Comments:
u
- Specific isochoric heat capacity cv =

T v
- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


cv_ptW_HAP_SI = -1000

References:
cv ( p, t ,W )

Herrmann et al. [3], [4]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/8

Enhancement Factor f = f(p,t)


Function Name:
f_pt_HAP_SI

Fortran Program:
REAL*8 FUNCTION F_PT_HUAIRPROP(P,T), REAL*8 P,T

Input Values:
-

p
t

Total pressure p in kPa


Temperature t in C

Result:
f_pt_HAP_SI - Enhancement factor of water (decimal ratio)

Range of Validity:
Temperature t:

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Comments:
- Enhancement factor f =
with ps (t )

pH2O,s
ps (t )

for t 0.01C - Steam pressure of water


for t < 0.01C - Sublimation pressure of water

- Describes the enhancement of the saturation pressure of water in the air


atmosphere under elevated pressure
- Derived iteratively from the isothermal compressibility of liquid water, from
Henry's constant [15], [16] and from the virial coefficients of air, water, and the
air-water mixture

Result for Wrong Input Values:


f_pt_HAP_SI = -1000

References:
f ( p, t )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/9

Air-Specific Enthalpy h = f(p,t,W)


Function Name:
h_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION H_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
h_ptW_HAP_SI

- Air-specific enthalpy in kJ/kga

Range of Validity:
Temperature t:

from -143.5C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W 10 kgw /kga

Comments:
- When calculating supersaturated air an ideal mixing model (saturated humid air
and water droplets (or ice crystals) homogeneously mixed) is applied

Result for Wrong Input Values:


h_ptW_HAP_SI = -1000

References:
h(p,t,W)

Herrmann et al. [1], [2]

hw (p,t)

IAPWS-IF97 [7], [8] and IAPWS-06 [11]

ha (t)

Lemmon et al. [14]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/10

Dynamic Viscosity = f(p,t ,W )


Function Name:
Eta_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION ETA_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
Eta_ptW_HAP_SI - Dynamic viscosity of humid air in Pa s

Range of Validity:
Temperature t:

from -73.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W 10 kgw /kga

Comments:
- A new very accurate algorithm is implemented between 0C and 350C
- When calculating supersaturated air an ideal mixing model (saturated humid air
and water droplets (or ice crystals) homogeneously mixed) is applied

Result for Wrong Input Values:


Eta_ptW_HAP_SI = -1000

References:
( p, t ,W )

Herrmann et al. [3], [4]

a (t )

Lemmon et al. [18]

w (p,t )

IAPWS-IF97 [7], [8] and IAPWS-08 [19]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/11

Isentropic Exponent = f(p,t ,W )


Function Name:
Kappa_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION KAPPA_PTW_HUAIRPROP(P,T, W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
Kappa_ptW_HAP_SI - Isentropic exponent

Range of Validity:
Temperature t:

from -143.5C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W 10 kgw /kga

Comments:
- Isentropic exponent =

v p
p v s

- When calculating supersaturated air an ideal mixing model (saturated humid air
and water droplets homogeneously mixed) is applied for t 0.01C. For
temperatures below (ice fog) the value of the saturated state is applied.

Result for Wrong Input Values:


Kappa_ptW_HAP_SI = -1000

References:
v ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/12

Thermal Conductivity = f(p,t ,W )


Function Name:
Lambda_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION LAMBDA_PTW_HUAIRPROP(P,T, W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
Lambda_ptW_HAP_SI - Thermal conductivity in W/(m K)

Range of Validity:
Temperature t:

from -73.5C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W 10 kgw /kga

Comments:
- A new very accurate algorithm is implemented between 0C and 350C
- When calculating supersaturated air an ideal mixing model (saturated humid air
and water droplets (or ice crystals) homogeneously mixed) is applied

Result for Wrong Input Values:


Lambda_ptW_HAP_SI = -1000

References:
( p, t ,W )

Herrmann et al. [3], [4]

a (t )

Lemmon et al. [18]

w ( p, t )

IAPWS-IF97 [7], [8] and IAPWS-08 [20]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/13

Kinematic Viscosity = f(p,t ,W )


Function Name:
Ny_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION NY_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
Ny_ptW_HAP_SI - Kinematic viscosity in m 2 /s

Range of Validity:
Temperature t:

from -73.5C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W Ws

Comments:
- Kinematic Viscosity =

Result for Wrong Input Values:


Ny_ptW_HAP_SI = -1000

References:
( p, t ,W )

Herrmann et al. [3], [4]

( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/14

Backward Function: Total Pressure p = f(t,s,W)


Function Name:
p_tsW_HAP_SI

Fortran Program:
REAL*8 FUNCTION P_TSW_HUAIRPROP(T,S,W), REAL*8 T,S,W

Input Values:
t
s
W

Temperature t in C
Air-specific entropy s in kJ(kg K)
Humidity ratio W in kgw /kga

Result:
p_tsW_HAP_SI - Total pressure in kPa

Range of Validity:
Temperature t:

from -143.5C to 350C

Air-specific entropy s:

from -26.53 kJ/(kg K) to 38.990 kJ/(kg K)

Humidity ratio W:

0 W 10kgw /kga

Comments:
- Iteration of total pressure p from s = f(p,t,W)

Result for Wrong Input Values:


p_tsW_HAP_SI = -1000

References:
s( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/15

Pressure p = f(zele )
Function Name:
p_zele_HAP_SI

Fortran Program:
REAL*8 FUNCTION P_ZELE_HUAIRPROP(ZELE), REAL*8 ZELE

Input Values:
zele

Elevation zele in m

Result:
p_zele_HAP_SI - Pressure of humid air in kPa

Range of Validity:
from -5,000 m to 11,000 m

Elevation zele

Comments:
- Pressure of humid air from elevation

- p( zele ) = 101.325 kPa 1 2.25577 105 ele


m

5.256

Result for Wrong Input Values:


p_zele_HAP_SI = -1000

References:
p( zele )

ASHRAE [23]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/16

Partial Pressure of Dry Air pAir = f(p, t ,W )


Function Name:
pAir_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION PAIR_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
pAir_ptW_HAP_SI - Partial pressure of (dry) air in humid air in kPa

Range of Validity:
Temperature t:
Total pressure p:
Humidity ratio W:

from -143.15C to 350C


from 0.01 kPa to 10 000 kPa
0 W 10kgw /kga

Comments:
- Partial pressure of (dry) air in humid air pAir = 1 pH2O
- Partial pressure of water vapor at saturation is calculated in case of
supersaturated humid air (W > Ws ( p, t ) )
- The temperature value is used to calculate the saturation state

Result for Wrong Input Values:


pAir_ptW_HAP_SI = -1000

References:
pH2O ( p,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/17

Partial Pressure of Water Vapor pH2O = f(p, t ,W )


Function Name:
pH2O_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION PH2O_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
pH2O_ptW_HAP_SI - Partial pressure of water vapor in humid air in kPa

Range of Validity:
Temperature t:
Total pressure p:
Humidity ratio W:

from -143.15C to 350C


from 0.01 kPa to 10 000 kPa
0 W 10kgw /kga

Comments:
- Partial pressure of water vapor in humid air pH2O =

W p
Ra

+W

Rw

- Partial pressure of water vapor at saturation is calculated in case of


supersaturated humid air (W > Ws ( p, t ) )
- The temperature value is used to calculate the saturation state

Result for Wrong Input Values:


pH2O_ptW_HAP_SI = -1000

References:
pH2O ( p,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/18

Partial Saturation Pressure of Water Vapor pH2O,s = f(p, t )


Function Name:
pH2Os_pt_HAP_SI

Fortran Program:
REAL*8 FUNCTION PH2OS_PT_HUAIRPROP(P,T), REAL*8 P,T

Input Values:
p
t

Total pressure p in kPa


Temperature t in C

Result:
pH2Os_pt_HAP_SI - Partial saturation pressure of water vapor in humid air in kPa

Range of Validity:
Temperature t:

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Comments:
- Partial pressure of steam at saturation pH2O,s = f ps (t )
with ps (t )

for t 0.01C - Steam pressure of water

for t < 0.01C - Sublimation pressure of water

Result for Wrong Input Values:


pH2Os_pt_HAP_SI = -1000

References:
f ( p, t )
ps (t )

Herrmann et al. [1], [2]


for t 0.01C

IAPWS-IF97 [7], [8]

for t < 0.01C

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/19

Relative Humidity = f(p, t ,W )


Function Name:
phi_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION PHI_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
phi_ptW_HAP_SI - Relative humidity (decimal ratio)

Range of Validity:
Temperature t:

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W 10kgw /kga

Comments:
- Relative humidity =

pH2O
pH2O,s

- This equation is valid for pH2O pH2O,s and for 0 1

Result for Wrong Input Values:


phi_ptW_HAP_SI = -1000

References:
( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/20

Prandtl Number Pr = f(p,t,W)


Function Name:
Pr_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION PR_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
Pr_ptW_HAP_SI - Prandtl number

Range of Validity:
Temperature t:

from -73.5C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W 10kgw /kga

Comments:
- Prandtl number Pr =

cp

- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


Pr_ptW_HAP_SI = -1000

References:
( p, t ,W )

Herrmann et al. [3], [4]

c p ( p, t ,W )

Herrmann et al. [3], [4]

( p, t ,W )

Lemmon et al. [20]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/21

Mole Fraction of Dry Air Air = f(W )


Function Name:
PsiAir_W_HAP_SI

Fortran Program:
REAL*8 FUNCTION PSIAIR_W_HUAIRPROP(W), REAL*8 W

Input Values:
W

Humidity ratio W in kgw /kga

Result:
PsiAir_W_HAP_SI - Mole fraction of (dry) air in humid air in mola/mol

Range of Validity:
Humidity ratio W:

0 W 10kgw /kga

Comments:
- Mole fraction of air Air = 1 H2O

W
= 1
Ra
+W
R
H2O

Result for Wrong Input Values:


PsiAir_W_HAP_SI = -1000

References:
Air (W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/22

Mole Fraction of Water H2O = f(W )


Function Name:
PsiH2O_W_HAP_SI

Fortran Program:
REAL*8 FUNCTION PSIH2O_W_HUAIRPROP(W), REAL*8 W

Input Values:
W

Humidity ratio W in kgw /kga

Result:
PsiH2O_W_HAP_SI - Mole fraction of water in humid air in molw/mol

Range of Validity:
Humidity ratio W:

0 W 10 kgw /kga

Comments:
- Mole fraction of water H2O =

W
Ra
+W
RH2O

Result for Wrong Input Values:


PsiH2O_W_HAP_SI = -1000

References:
H2O (W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/23

Density = f(p,t ,W )
Function Name:
Rho_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION RHO_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
Rho_ptW_HAP_SI - Density of humid air in kg/m 3

Range of Validity:
Temperature t:

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W 10kgw /kga

Comments:
- Density of humid air obtained from air-specific volume: =

1+ W
v

Result for Wrong Input Values:


Rho_ptW_HAP_SI = -1000

References:
( p, t ,W ) Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/24

Air-Specific Entropy s = f(p,t,W)


Function Name:
s_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION S_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
s_ptW_HAP_SI

- Air-specific entropy in kJ/(kga K)

Range of Validity:
Temperature t:

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W 10 kgw /kga

Comments:
- When calculating supersaturated air an ideal mixing model (saturated humid air
and water droplets (or ice crystals) homogeneously mixed) is applied

Result for Wrong Input Values:


s_ptW_HAP_SI = -1000

References:
s( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/25

Backward Function: Temperature t = f(p,h,)


Function Name:
t_phphi_HAP_SI

Fortran Program:
REAL*8 FUNCTION T_PHPHI_HUAIRPROP(P,H,PHI), REAL*8 P,H,PHI

Input Values:
p
h

Total pressure p in kPa


Air-specific enthalpy h in kJ/kga
Relative humidity (decimal ratio)

Result:
t_phphi_HAP_SI - Temperature from pressure, enthalpy, and relative humidity in C

Range of Validity:
Total pressure p:

from 0.01 kPa to 10 000 kPa

Air-specific enthalpy h:

from -5745 kJ/kga to 29690 kJ/kga

Relative humidity :

0 1

Comments:
- Iteration of temperature t from h = f(p,t,W) using W = f(p,t,)

Result for Wrong Input Values:


t_phphi_HAP_SI = -1000

References:
h( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/26

Backward Function: Temperature t = f(p,h,W)


Function Name:
t_phW_HAP_SI

Fortran Program:
REAL*8 FUNCTION T_PHW_HUAIRPROP(P,H,W), REAL*8 P,H,W

Input Values:
p
h
W

Total pressure p in kPa


Air-specific enthalpy h in kJ/kga
Humidity ratio W in kgw /kga

Result:
t_phW_HAP_SI - Temperature from pressure, enthalpy, and humidity ratio in C

Range of Validity:
Total pressure p:

from 0.01 kPa to 10 000 kPa

Air-specific enthalpy h:

from -5745 kJ/kga to 29690 kJ/kga

Humidity ratio W:

0 W 10 kgw /kga

Comments:
- Iteration of temperature t from h = f(p,t,W)

Result for Wrong Input Values:


t_phW_HAP_SI = -1000

References:
h( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/27

Backward Function: Temperature t = f(p,s,W)


Function Name:
t_psW_HAP_SI

Fortran Program:
REAL*8 FUNCTION T_PSW_HUAIRPROP(P,S,W), REAL*8 P,S,W

Input Values:
p
s
W

Total pressure p in kPa


Air-specific entropy s in kJ/(kga K)
Humidity ratio W in kgw /kga

Result:
t_psW_HAP_SI - Temperature from pressure, entropy, and humidity ratio in C

Range of Validity:
Total pressure p:

from 0.01 kPa to 10 000 kPa

Air-specific entropy s:

from -26.53 kJ/(kg K) to 38.990 kJ/(kg K)

Humidity ratio W:

0 W 10kgw /kga

Comments:
- Iteration of temperature t from s = f(p,t,W)

Result for Wrong Input Values:


t_psW_HAP_SI = -1000

References:
s( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/28

Backward Function: Temperature t = f(p,t wb ,W )


Function Name:
t_ptwbW_HAP_SI

Fortran Program:
REAL*8 FUNCTION T_PTWBW_HUAIRPROP(P,TWB,W), REAL*8 P,TWB,W

Input Values:
p
t wb

Total pressure p in kPa


Wet-bulb temperature in C

Humidity ratio W in kgw /kga

Result:
t_ptwbW_HAP_SI

- Temperature from pressure, wet bulb temperature and

humidity ratio in C

Range of Validity:
Total pressure p:

from 0.01 kPa to 10 000 kPa

Wet bulb temperature t wb :

from -143.15C to 350C

Humidity ratio W:

0 W 10 kgw /kga

Comments:
- Iterationof temperature t from t wb = f( p, t ,W )

Result for Wrong Input Values:


t_ptwbW_HAP_SI = -1000

References:
t wb ( p, t ,W ) Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/29

Dew-Point/Frost-Point Temperature td = f(p,W )


Function Name:
td_pW_HAP_SI

Fortran Program:
REAL*8 FUNCTION TD_PW_HUAIRPROP(P,W), REAL*8 P,W

Input Values:
p
W

Total pressure p in kPa


Humidity ratio W in kgw /kga

Result:
td_pW_HAP_SI - Dew-point/frost-point temperature in C

Range of Validity:
Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W 10kgw /kga

Comments:
Dew-point temperature td = ts ( pH2O ) for t 0.01C (saturation temperature of
water in humid air)
td = tsub ( pH2O ) for t 0.01C (sublimation temperature
of water in humid air)

Result for Wrong Input Values:


td_pW_HAP_SI = -1000

References:
ts ( pH2O )

for td 0.01C

IAPWS-IF97 [7], [8]

tsub ( pH2O )

for td 0.01C

IAPWS-08 [11]

pH2O

Herrmann et. al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/30

Saturation Temperature t s = f( p, pH2O )


Function Name:
ts_ppH2O_HAP_SI

Fortran Program:
REAL*8 FUNCTION TS_PPH2O_HUAIRPROP(P,PH2O), REAL*8 P,PH2O

Input Values:
p
pH2O

- Total pressure p in kPa


- Partial pressure of water vapor pH2O in kPa

Result:
ts_ppH2O_HAP_SI - Saturation temperature in C

Range of Validity:
Total pressure p:

from 0.01 kPa to 10 000 kPa

Partial Pr essure pH2O : from 0.01 kPa to 10 000 kPa

Comments:
- Iteration of saturation temperature t s from pH2O,s = f( p, t )

Result for Wrong Input Values:


ts_ppH2O_HAP_SI = -1000

References:
pH2O,s

Herrmann et. al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/31

Wet-Bulb/Ice-Bulb Temperature t wb = f(p,t ,W )


Function Name:
twb_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION TWB_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
twb_ptW_HAP_SI - Wet-bulb/ice-bulb temperature in C

Range of Validity:
Temperature t:

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W 10kgw /kga

Comments:
- Iteration of wet-bulb/ice-bulb temperature t wb
from hunsaturated (p, t ,W ) = h fog (p, t wb ,W )
- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


twb_ptW_HAP_SI = -1000

References:
t wb ( p, t ,W ) Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/32

Air-Specific Internal Energy u = f(p,t,W)


Function Name:
u_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION U_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
u_ptW_HAP_SI

- Air-specific internal energy in kJ/kga

Range of Validity:
Temperature t:

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W 10kgw /kga

Comments:
- Internal energy u = h pv

Result for Wrong Input Values:


u_ptW_HAP_SI = -1000

References:
u( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/33

Air-Specific Volume v = f(p,t,W)


Function Name:
v_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION V_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
v_ptW_HAP_SI

- Air-specific volume in m3 /kga

Range of Validity:
Temperature t:

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Humidity ratio W:

0 W 10 kgw /kga

Comments:
- When calculating supersaturated air an ideal mixing model (saturated humid air
and water droplets (or ice crystals) homogeneously mixed) is applied

Result for Wrong Input Values:


v_ptW_HAP_SI = -1000

References:
v ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/34

Humidity Ratio from Partial Pressure of Steam W = f(p ,t ,pH2O )


Function Name:
W_ptpH2O_HAP_SI

Fortran Program:
REAL*8 FUNCTION W_PTPH2O_HUAIRPROP(P,T,PH2O), REAL*8 P,T,PH2O

Input Values:
- Total pressure p in kPa
p
- Temperature t in C
t
pH2O - Partial pressure of water pH2O in kPa

Result:
W_ptpH2O_HAP_SI - Humidity ratio from temperature and partial pressure of
water vapor in kgw /kga

Range of Validity:
Total pressure p:

from 0.01 kPa to 10 000 kPa

Temperature t :

from -143.15C to 350C

Partial pressure pH2O :

from 0.01 kPa to 10 000 kPa

Comments:
- Iteration of humidity ratio W from pH2O = f( p, t ,W )
- Result for supersaturated humid air is Ws

Result for Wrong Input Values:


W_ptpH2O_HAP_SI = -1000

References:
pH2O ( p, t ,W ) Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/35

Humidity Ratio from Relative Humidity W = f(p,t , )


Function Name:
W_ptphi_HAP_SI

Fortran Program:
REAL*8 FUNCTION W_PTPHI_HUAIRPROP(P,T,PHI), REAL*8 P,T,PHI

Input Values:
p
t

Total pressure p in kPa


Temperature t in C
Relative humidity (decimal ratio)

Result:
W_ptphi_HAP_SI

- Humidity ratio from temperature and relative humidity


in kgw /kga

Range of Validity:
Temperature t:

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Relative humidity :

0 1

Comments:
- Iteration of humidity ratio W from = f ( p, t ,W )

Result for Wrong Input Values:


W_ptphi_HAP_SI = -1000

References:
( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/36

Humidity Ratio from Dew-Point Temperature W = f(p,td )


Function Name:
W_ptd_HAP_SI

Fortran Program:
REAL*8 FUNCTION W_PTD_HUAIRPROP(P,TD), REAL*8 P,TD

Input Values:
p
td

Total pressure p in kPa


Dew -po int temperature t d in C

Result:
W_ptd_HAP_SI

- Humidity ratio from temperature and dew-point temperature


in kgw /kga

Range of Validity:
Dew point temperature td :

from -143.15C to 350C

Total pressure p:

from 0.01 kPa to 10 000 kPa

Comments:
- Iteration of humidity ratio W from td = f(p,W )

Result for Wrong Input Values:


W_ptd_HAP_SI = -1000

References:
td ( p,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/37

Humidity Ratio from Wet-Bulb Temperature W = f(p,t ,t wb )


Function Name:
W_pttwb_HAP_SI

Fortran Program:
REAL*8 FUNCTION W_PTTWB_HUAIRPROP(P,T,TWB), REAL*8 P,T,TWB

Input Values:
p
t
t wb

Total pressure p in kPa


Temperature t in C
Wet-bulb temperature in C

Result:
W_pttwb_HAP_SI

- Humidity ratio from temperature and wet-bulb temperature


in kgw /kga

Range of Validity:
Total pressure p:

from 0.01 kPa to 10 000 kPa

Temperature t:

from -143.15C to 350C

Wet-bulb temperature t wb :

from -143.15C to 350C

Comments:
- Iteration of humidity ratio W from t wb = f(p, t ,W )
- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


W_pttwb_HAP_SI = -1000

References:
t wb ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/38

Saturation Humidity Ratio Ws = f(p,t )


Function Name:
Ws_pt_HAP_SI

Fortran Program:
REAL*8 FUNCTION WS_PT_HUAIRPROP(P,T), REAL*8 P,T

Input Values:
p
t

Total pressure p in kPa


Temperature t in C

Result:
Ws_pt_HAP_SI

- Saturation humidity ratio (mass fraction) in kgw /kga

Range of Validity:
Total pressure p:

from 0.01 kPa to 10 000 kPa

Temperature t:

from -143.15C to 350C

Comments:
- Calculation of saturation humidity ratio Ws from Ws =

pH2O,s
MH2O
Ma ( p pH2O,s )

Result for Wrong Input Values:


Ws_pt_HAP_SI = -1000

References:
pH2O,s

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/39

Mass Fraction of Dry Air Air = f(W )


Function Name:
XiAir_W_HAP_SI

Fortran Program:
REAL*8 FUNCTION XIAIR_W_HUAIRPROP(W), REAL*8 W

Input Values:
W

Humidity ratio W in kgw /kga

Result:
XiAir_W_HAP_SI

- Mass fraction of (dry) air in humid air in kga /kg

Range of Validity:
Humidity ratio W:

0 W 10kgw /kga

Comments:
- Mass fraction of (dry) air Air = 1 H2O = 1

W
1+ W

Result for Wrong Input Values:


XiAir_W_HAP_SI = -1000

References:
Air (W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/40

Mass Fraction of Water Vapor H2O = f(W )


Function Name:
XiH2O_W_HAP_SI

Fortran Program:
REAL*8 FUNCTION XIH2O_W_HUAIRPROP(W), REAL*8 W

Input Values:
W

Humidity ratio W in kgw /kga

Result:
XiH2O_W_HAP_SI

- Mass fraction of water vapor in humid air in kgw /kg

Range of Validity:
Humidity ratio W:

0 W 10kgw /kga

Comments:
- Mass fraction of water vapor H2O =

W
1+ W

Result for Wrong Input Values:


XiH2O_W_HAP_SI = -1000

References:
H2O (W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/41

Compression Factor Z = f(p,t,W)


Function Name:
Z_ptW_HAP_SI

Fortran Program:
REAL*8 FUNCTION Z_PTW_HUAIRPROP(P,T,W), REAL*8 P,T,W

Input Values:
p
t
W

Total pressure p in kPa


Temperature t in C
Humidity ratio W in kgw /kga

Result:
Z_ptW_HAP_SI - Compression factor (decimal ratio)

Range of Validity:
Total pressure p:

from 0.01 kPa to 10 000 kPa

Temperature t:

from -143.15C to 350C

Humidity ratio W:

0 W Ws

Comments:
- Compression factor Z = 1 +

Mv
1+ W
and M is the molar mass of humid air
with v =

Bm Cm
+
v
v2

- Calculation for supersaturated humid air (W > Ws ) is not possible

Result for Wrong Input Values:


Z_ptW_HAP_SI = -1000

References:
Bm (t ,W ), Cm (t ,W )

Herrmann et al. [1], [2]

( p, t ,W ), v ( p, t ,W )

Herrmann et al. [1], [2]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/42

3.2 Functions for Steam and Water for Temperatures t 0C

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/43

Specific Enthalpy of Liquid Water hliq = f( p, t )


Function Name:
hliq_pt_97_SI

Fortran Program:
REAL*8 FUNCTION HLIQ_PT_97(P,T), REAL*8 P,T

Input Values:
p
t

Pressure p in kPa
Temperature t in C

Result:
hliq_pt_97_SI - Specific enthalpy of liquid water in kJ/kg

Range of Validity:
Pressure p:

from ps (0C) = 0.6112 kPa to 10 000 kPa

Temperature t:

from 0C to 350C

Comments:
- Specific enthalpy of liquid water hliq = h97 ( p, t ) (Region 1)

Result for Wrong Input Values:


hliq_pt_97_SI = -1000

References:
h97 (p,t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/44

Specific Enthalpy of Saturated Liquid Water hliq,s = f(t )


Function Name:
hliqs_t_97_SI

Fortran Program:
REAL*8 FUNCTION HLIQS_T_97(T), REAL*8 T

Input Values:
t

Temperature t in C

Result:
hliqs_t_97_SI - Specific enthalpy of saturated liquid water in kJ/kg

Range of Validity:
Temperature t:

from 0C to 350C

Comments:
- Specific enthalpy of liquid water hliq,s = h97 ( ps , t ) (Region 1)
with ps = ps97 (t )

Result for Wrong Input Values:


hliqs_t_97_SI = -1000

References:
h97 (p, t ), ps97 (t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/45

Specific Enthalpy of Saturated Water Vapor hvap,s = f(t )


Function Name:
hvaps_t_97_SI

Fortran Program:
REAL*8 FUNCTION HVAPS_T_97(T), REAL*8 T

Input Values:
t

Temperature t in C

Result:
hvaps_t_97_SI - Specific enthalpy of saturated water vapor in kJ/kg

Range of Validity:
Temperature t:

from 0C to 350C

Comments:
- Specific enthalpy of saturated water vapor hvap,s = h97 ( ps , t ) (Region 2)
with ps = ps97 (t )

Result for Wrong Input Values:


hvaps_t_97_SI = -1000

References:
h97 (p, t ), ps97 (t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/46

Saturation Pr essure of Water ps = f(t )


Function Name:
ps_t_97_SI

Fortran Program:
REAL*8 FUNCTION PS_T_97(T), REAL*8 T

Input Values:
t

Temperature t in C

Result:
ps_t_97_SI - Saturation pressure of water in kPa

Range of Validity:
Temperature t:

from 0C to 350C

Comments:
- Saturation pressure of water ps = ps97 (t ) (Region 4)

Result for Wrong Input Values:


ps_t_97_SI -1000

References:
ps97 (t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/47

Specific Entropy of Liquid Water sliq = f( p, t )


Function Name:
sliq_pt_97_SI

Fortran Program:
REAL*8 FUNCTION SLIQ_PT_97(P,T), REAL*8 P,T

Input Values:
p
t

Pressure p in kPa
Temperature t in C

Result:
sliq_pt_97_SI - Specific entropy of liquid water in kJ/(kg K)

Range of Validity:
Pressure p:

from ps (0C) = 0.6112 kPa to 10 000 kPa

Temperature t:

from 0C to 350C

Comments:
- Specific entropy of liquid water sliq = s 97 ( p, t ) (Region 1)

Result for Wrong Input Values:


sliq_pt_97_SI = -1000

References:
s 97 ( p, t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/48

Specific Entropy of Saturated Liquid Water sliq,s = f(t )


Function Name:
sliqs_t_97_SI

Fortran Program:
REAL*8 FUNCTION SLIQS_T_97(T), REAL*8 T

Input Values:
t

Temperature t in C

Result:
sliqs_t_97_SI - Specific entropy of saturated liquid water in kJ/(kg K)

Range of Validity:
Temperature t:

from 0C to 350C

Comments:
- Specific entropy of liquid water sliq,s = s 97 ( ps , t ) (Region 1)
with ps = ps97 (t )

Result for Wrong Input Values:


sliqs_t_97_SI = -1000

References:
s 97 (p, t ), ps97 (t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/49

Specific Entropy of Saturated Water Vapor svap,s = f(t )


Function Name:
svaps_t_97_SI

Fortran Program:
REAL*8 FUNCTION SVAPS_T_97(T), REAL*8 T

Input Values:
t

Temperature t in C

Result:
svaps_t_97_SI - Specific entropy of saturated water vapor in kJ/(kg K)

Range of Validity:
Temperature t:

from 0C to 350C

Comments:
- Specific entropy of saturated water vapor svap,s = s 97 ( ps , t ) (Region 2)
with ps = ps97 (t )

Result for Wrong Input Values:


svaps_t_97_SI = -1000

References:
s 97 (p, t ), ps97 (t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/50

Saturation Temperature of Water t s = f( p )


Function Name:
ts_p_97_SI

Fortran Program:
REAL*8 FUNCTION TS_P_97(P), REAL*8 P

Input Values:
p

Pressure p in kPa

Result:
ts_p_97_SI - Saturation temperature of water in C

Range of Validity:
Pressure p:

from 0.6112 kPa to 10 000 kPa

Comments:
- Saturation temperature of water ts = ts97 ( p ) (Region 4)

Result for Wrong Input Values:


ts_p_97_SI = -1000

References:
ts97 (p )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/51

Specific Volume of Liquid Water v liq = f( p, t )


Function Name:
vliq_pt_97_SI

Fortran Program:
REAL*8 FUNCTION VLIQ_PT_97(P,T), REAL*8 P,T

Input Values:
p
t

Pressure p in kPa
Temperature t in C

Result:
vliq_pt_97_SI - Specific volume of liquid water in m 3 /kg

Range of Validity:
Pressure p:

from ps (0C) = 0.6112 kPa to 10 000 kPa

Temperature t:

from 0C to 350C

Comments:
- Specific volume of liquid water v liq = v 97 ( p, t ) (Region 1)

Result for Wrong Input Values:


vliq_pt_97_SI = -1000

References:
v 97 (p,t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/52

Specific Volume of Saturated Liquid Water v liq,s = f(t )


Function Name:
vliqs_t_97_SI

Fortran Program:
REAL*8 FUNCTION VLIQS_T_97(T), REAL*8 T

Input Values:
-

Temperature t in C

Result:
vliqs_t_97_SI - Specific volume of saturated liquid water in m 3 /kg

Range of Validity:
Temperature t:

from 0C to 350C

Comments:
- Specific volume of liquid water v liq,s = v 97 ( ps , t ) (Region 1)
with ps = ps97 (t )

Result for Wrong Input Values:


vliqs_t_97_SI = -1000

References:
v 97 (p, t ), ps97 (t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/53

Specific Volume of Saturated Water Vapor v vap,s = f(t )


Function Name:
vvaps_t_97_SI
Fortran Program:
REAL*8 FUNCTION VVAPS_T_97(T), REAL*8 T

Input Values:
-

Temperature t in C

Result:
vvaps_t_97_SI - Specific volume of saturated water vapor in m 3 /kg

Range of Validity:
Temperature t:

from 0C to 350C

Comments:
- Specific volume of saturated water vapor v vap,s = v 97 ( ps , t ) (Region 2)
with ps = ps97 (t )

Result for Wrong Input Values:


vvaps_t_97_SI = -1000
References:
v 97 (p, t ), ps97 (t )

IAPWS-IF97 [7], [8]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/54

3.3 Functions for Steam and Water for Temperatures t 0C

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/55

Specific Enthalpy of Saturated Ice hice,sub = f(t )


Function Name:
hicesub_t_06_SI

Fortran Program:
REAL*8 FUNCTION HICESUB_T_06(T), REAL*8 T

Input Values:
-

Temperature t in C

Result:
hicesub_t_06_SI - Specific enthalpy of saturated ice in kJ/kg

Range of Validity:
Temperature t:

from -143.15C to 0C

Comments:
- Specific enthalpy of saturated ice hice,sub = h06 ( psub , t )
08
with psub = psub
(t )

Result for Wrong Input Values:


hicesub_t_06_SI = -1000

References:
h06 (p, t )

IAPWS-06 [10]

08
psub
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/56

Specific Enthalpy of Saturated Water Vapor hvap,sub = f(t )


Function Name:
hvapsub_t_95_SI

Fortran Program:
REAL*8 FUNCTION HVAPSUB_T_95(T), REAL*8 T

Input Values:
-

Temperature t in C

Result:
hvapsub_t_95_SI - Specific enthalpy of saturated water vapor in kJ/kg

Range of Validity:
Temperature t:

from -143.15C to 0C

Comments:
- Specific enthalpy of saturated water vapor hvap,sub = h95 ( psub , t )
08
with psub = psub
(t )

Result for Wrong Input Values:


hvapsub_t_95_SI = -1000

References:
h95 (p, t )

IAPWS-95 [5], [6]

08
psub
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/57

Melting Pr essure pmel = f(t )


Function Name:
pmel_t_08_SI

Fortran Program:
REAL*8 FUNCTION PMEL_T_08 (T), REAL*8 T

Input Values:
t

Temperature t in C

Result:
pmel_t_08_SI - Melting pressure of ice in kPa

Range of Validity:
Temperature t:

from -21.985C to 0C

Result for Wrong Input Values:


pmel_t_08_SI = -1000

References:
08
pmel
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/58

Sublim ation Pr essure psub = f(t )


Function Name:
psub_t_08_SI

Fortran Program:
REAL*8 FUNCTION PSUB_T_08 (T), REAL*8 T

Input Values:
t

Temperature t in C

Result:
psub_t_08_SI - Sublimation pressure of ice in kPa

Range of Validity:
Temperature t:

from -143.15C to 0C

Result for Wrong Input Values:


psub_t_08_SI = -1000

References:
08
psub
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/59

Specific Entropy of Saturated Ice sice,sub = f(t )


Function Name:
sicesub_t_06_SI

Fortran Program:
REAL*8 FUNCTION SICESUB_T_06(T), REAL*8 T

Input Values:
-

Temperature t in C

Result:
sicesub_t_06_SI - Specific entropy of saturated ice in kJ/(kg K)

Range of Validity:
Temperature t:

from -143.15C to 0C

Comments:
- Specific entropy of saturated ice sice,sub = s 06 ( psub , t )
08
with psub = psub
(t )

Result for Wrong Input Values:


sicesub_t_06_SI = -1000

References:
s 06 ( p, t )

IAPWS-06 [10]

08
psub
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/60

Specific Entropy of Saturated Water Vapor svap,sub = f(t )


Function Name:
svapsub_t_95_SI

Fortran Program:
REAL*8 FUNCTION SVAPSUB_T_95(T), REAL*8 T

Input Values:
-

Temperature t in C

Result:
svapsub_t_95_SI - Specific entropy of saturated water vapor in kJ/(kg K)

Range of Validity:
Temperature t:

from -143.15C to 0C

Comments:
- Specific entropy of saturated water vapor svap,sub = s 95 ( psub , t )
08
with psub = psub
(t )

Result for Wrong Input Values:


svapsub_t_95_SI = -1000

References:
s 95 (p, t )

IAPWS-95 [7], [8]

08
psub
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/61

Melting Temperature tmel = f( p )


Function Name:
tmel_p_08_SI

Fortran Program:
REAL*8 FUNCTION TMEL_P_08(P), REAL*8 P

Input Values:
p

Pressure p in kPa

Result:
tmel_p_08_SI - Melting temperature of ice in C

Range of Validity:
from ps (0C) = 0.6112 kPa to 10 000 kPa

Pressure p:

Result for Wrong Input Values:


tmel_p_08_SI = -1000

References:
08
tmel
(p )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/62

Sublim ation Temperature t sub = f( p )


Function Name:
tsub_p_08_SI

Fortran Program:
REAL*8 FUNCTION TSUB_P_08(P), REAL*8 P

Input Values:
p

Pressure p in kPa

Result:
tsub_p_08_SI - Sublimation temperature of ice in C

Range of Validity:
Pressure p:

from psubl (-143.15C) = 1.2002 x 10-11 kPa to psubl (0C) = 0.6112 kPa

Result for Wrong Input Values:


tsub_p_08_SI = -1000

References:
08
tsub
(p )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/63

Specific Volume of Saturated Ice v ice,sub = f(t )


Function Name:
vicesub_t_06_SI

Fortran Program:
REAL*8 FUNCTION VICESUB_T_06(T), REAL*8 T

Input Values:
-

Temperature t in C

Result:
vicesub_t_06_SI - Specific volume of saturated ice in m 3 /kg

Range of Validity:
Temperature t:

from -143.15C to 0C

Comments:
- Specific volume of saturated ice v ice,sub = v 06 ( psub , t )
08
with psub = psub
(t )

Result for Wrong Input Values:


vicesub_t_06_SI = -1000

References:
v 06 (p, t )

IAPWS-06 [10]

08
psub
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 3/64

Specific Volume of Saturated Water Vapor v vap,sub = f(t )


Function Name:
vvapsub_t_95_SI

Fortran Program:
REAL*8 FUNCTION VVAPSUB_T_95(T), REAL*8 T

Input Values:
-

Temperature t in C

Result:
vvapsub_t_95_SI - Specific volume of saturated water vapor in m 3 /kg

Range of Validity:
Temperature t:

from -143.15C to 0C

Comments:
- Specific volume of saturated water vapor v vap,sub = v 95 ( psub , t )
08
with psub = psub
(t )

Result for Wrong Input Values:


vvapsub_t_95_SI = -1000

References:
v 95 (p, t )

IAPWS-95 [7], [8]

08
psub
(t )

IAPWS-08 [11]

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

4 Property Libraries for Calculating Heat Cycles, Boilers,


Turbines, and Refrigerators
Water and Steam

Humid Combustion Gas Mixtures

Library LibIF97
- Industrial Formulation
IAPWS-IF97
(Revision 2007)
- Supplementary Standards

Library LibHuGas
Ideal mixture of the real fluids:
CO2 - Span and Wagner
H2O - IAPWS-95
N2 - Span et al.

- IAPWS Revised Advisory


Note No. 3 on
Thermodynamic
Derivatives (2008)

Humid Air
Library LibHuAir
Ideal mixture of the real fluids:

O2 - Schmidt and Wagner


Ar - Tegeler et al.

and of the ideal gases:

- IAPWS-IF97-S01
- IAPWS-IF97-S03rev
- IAPWS-IF97-S04
- IAPWS-IF97-S05

SI 4/1

SO2, CO, Ne (scientific equations of Bcker et al.)


Consideration of

- Dry air from Lemmon et al.


- Steam and water from IAPWS-IF97

Consideration of
- Dissociation from VDI-Guideline 4670
- Poynting effect

Dissociation from VDI 4670 and Poynting effect

Library LibIDGAS

Library LibIdAir

Ideal gas mixture calculated from the VDIGuideline 4670

Ideal gas mixture calculate from


VDI-Guideline 4670

Carbon Dioxide

Ideal Gas Mixtures

Library LibCO2

Library LibIdGasMix
Ideal mixture of the ideal gases:

Formulation of Span and Wagner


(1994)

Hydrogen
Library LibH2

Ar
Ne
N2
O2
CO
CO2
Air
NO
H2O

Formulation of
Leachman et al. (2007)

Helium
Library LibHe
Formulation of McCarty
and Arp (1990)

Methanol
Library LibCH3OH

SO2
H2
H2S
OH
He
F2
NH3

Methane
Ethane
Ethylene
Propylene
Propane
Iso-Butane
n-Butane
Benzene
Methanol

Seawater
Library LibSeaWa
IAPWS Formulation (2008)
and IAPWS-IF97

Refrigerant R134a
Library LibR134a
Formulation of
Tillner-Roth and Baehr (1994)

Refrigerant NH3
Consideration of
- Dissociation from VDI-Guideline 4670

Formulation of
de Reuck and Craven (1993)

Library LibNH3
Formulation of Tillner-Roth
(1995)

ORC Working Fluids

Mixtures for Absorption Processes

Refrigerants

Library LibMM
Siloxane C6H18OSi2 (MM)

Library LibAmWa

Library LibPropan

Ammonia/Water Mixtures

Refrigerant Propane
Formulation of Lemmon
et al. (2008)

Formulation of Colonna et al. (2006)


Library LibD4
Siloxane C8H24O4Si4 (D4)
Formulation of Colonna et al. (2006)
Library LibD5
Siloxane C10H30O5Si5 (D5)
Formulation of Colonna et al. (2006)
Library LibMD4M
Siloxane C14H42O5Si6 (MD4M)
Formulation of Colonna et al. (2006)

IAPWS Guideline 2005 of Tillner-Roth


and Friend (1998)
Helmholtz energy formulation for the
mixing term

Library LibButan_Iso

Library LibWaLi

Refrigerant Iso-Butane
Formulation of Bcker
et al. (2003)

Water/Lithium Bromide Mixtures

Library LibButan_n

Formulation of Kim and Infante Ferreira


(2004)

Refrigerant n-Butane
Formulation of Bcker
et al. (2003)

Gibbs energy equation for the


mixing term

SI 4/2

Add-In FluidEXL for Excel

Add-In FluidEES for EES

Using the Add-In FluidEXL a direct call of the property functions


in Excel is possible.

The Add-In FluidEES allows to call the functions of the property


libraries within the Engineering Equation Solver EES.

Function in FluidEXL

Function in FluidEES

Add-In FluidMAT for Mathcad

Add-In FluidLAB for MATLAB

Using the Add-on FluidMAT, the functions of the


property libraries can be used in Mathcad.

The property functions can be called in MATLAB.

Function in FluidLAB

Function in FluidMAT

The following thermodynamic and transport properties can be calculated1:


Thermodynamic Properties
Saturation pressure ps
Saturation temperature Ts
Density
Specific volume v
Enthalpy h
Internal energy u
Entropy s
Exergy e

Transport Properties
Dynamic viscosity
Kinematic viscosity
Thermal conductivity
Prandtl-number Pr

Isobaric

heat capacity cp
Isochoric heat capacity cv
Isentropic exponent
Speed of sound w
Surface tension
Thermodynamic Derivatives
Partial derivatives can be calculated

Backward Functions
T, v, s (p,h)
p, T (v,h)
T, v, h (p,s)
p, T (v,u)
p, T, v (h,s)

For information please contact:


Zittau/Goerlitz University of Applied Sciences
Department of Technical Thermodynamics
Prof. Hans-Joachim Kretzschmar
Dr. Ines Stoecker
Theodor-Koerner-Allee 16
02763 Zittau, Germany

E-mail: hj.kretzschmar@hs-zigr.de
Internet: www.thermodynamics-zittau.de
Phone: +49-3583-61-1846
Fax.: +49-3583-61-1846
1 Not all of these property functions are available in all property libraries listed before.

SI 5/1

5 References
[1]

Herrmann, S.; Kretzschmar, H.-J.; Gatley, D.P.: Thermodynamic Properties of Real


Moist Air, Dry Air, Steam, Water, and Ice. HVAC&R Research 5, 961-986 (2009).

[2]

Herrmann, S.; Kretzschmar, H.-J.; Gatley, D.P.: Thermodynamic Properties of Real


Moist Air, Dry Air, Steam, Water, and Ice. ASHRAE RP-1485, American Society of
Heating, Refrigerating, and Air-Conditioning Engineers, Inc., Atlanta, GA (2009).

[3]

Herrmann, S.; Kretzschmar, H.-J.; Teske, V.; Vogel, E.; Ulbig, P.; Span, R.; Gatley,
D.P.: Determination of Thermodynamic and Transport Properties of Humid Air for
Power-Cycle Calculations, Report PTB-CP-3, Physikalisch-Technische Bundesanstalt,
Braunschweig und Berlin (2009).

[4]

Herrmann, S.; Kretzschmar, H.-J.; Teske, V.; Vogel, E.; Ulbig, P.; Span, R.; Gatley,
D.P.: Properties of Humid Air for Calculating Power Cycles, J. Eng. Gas Turbines
Power, submitted (2009).

[5]

IAPWS. Revised Release on the IAPWS Formulation 1995 for the Thermodynamic
Properties of Ordinary Water Substance for General and Scientific Use. (2009),
available from www.iapws.org.

[6]

Wagner, W.; Pru, A.: The IAPWS Formulation 1995 for the Thermodynamic Properties
of Ordinary Water Substance for General and Scientific Use. J. Phys. Chem. Ref. Data
31, 387-535 (2002).

[7]

IAPWS. Revised Release on the IAPWS Industrial Formulation 1997 for the
Thermodynamic Properties of Water and Steam IAPWS-IF97. (2007), available from
www.iapws.org.

[8]

Wagner, W.; Kretzschmar, H.-J.: International Steam Tables. Springer, Berlin (2008).

[9]

Parry, W.T.; Bellows, J.C.; Gallagher, J.S.; Harvey, A.H.: ASME International Steam
Tables for Industrial Use. ASME Press, New York (2000).

[10]

IAPWS. Revised Release on the Equation of State 2006 for H2O Ice Ih. (2009);
available from www.iapws.org.

[11]

IAPWS. Revised Release on the Pressure along the Melting and Sublimation Curves of
Ordinary Water Substance. (2008); available from www.iapws.org.

[12]

Nelson, H.F.; Sauer, H.J.: Formulation of High-Temperature Properties for Moist Air.
HVAC&R Research 8, 311-334 (2002).

[13]

Gatley, D.P.: Understanding Psychrometrics, 2nd ed., ASHRAE, Atlanta (2005).

[14]

Lemmon, E.W.; Jacobsen, R.T.; Penoncello, S.G.; Friend, D.G.: Thermodynamic


Properties of Air and Mixture of Nitrogen, Argon, and Oxygen from 60 to 2000 K at
Pressures to 2000 MPa. J. Phys. Chem. Ref. Data 29, 331-385 (2000).

[15]

Harvey, A.H.; Huang, P.H.: First-Principles Calculation of the Air-Water Second Virial
Coefficient. Int. J. Thermophys. 28, 556-565 (2007).

[16]

IAPWS. Guideline on the Henry's Constant and Vapor-Liquid Distribution Constant for
Gases in H2O and D2O at High Temperatures. (2004), available from www.iapws.org.

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp

SI 5/2

[17]

Gatley, D.P.; Herrmann, S.; Kretzschmar, H.-J.: A Twenty-First Century Molar Mass for
Dry Air. HVAC&R Research 14, 655-662 (2008).

[18]

Lemmon, E.W.; Jacobsen, R.T.: Viscosity and Thermal Conductivity Equations for
Nitrogen, Oxygen, Argon, and Air. Int. J. Thermophys. 25, 21-69 (2004).

[19]

IAPWS. Release on the IAPWS Formulation 2008 for the Viscosity of Ordinary Water
Substance. (2008), available from www.iapws.org.

[20]

IAPWS. Revised Release on the IAPS Formulation 1985 for the Thermal Conductivity
of Ordinary Water Substance. (2008), available from www.iapws.org.

[21]

Hyland, R.W.; Wexler, A.: Formulations for the Thermodynamic Properties of Dry Air
from 173.15 K to 473.15 K, and of Saturated Moist Air from 173.15 K to 372.15 K, at
Pressures to 5 MPa. ASHRAE Trans. 89, 520-535 (1983).

[22]

Mohr, P.J.; Taylor, P.N.: CODATA Recommended Values of the Fundamental Physical
Constants: 2002. Rev. Mod. Phys. 77, 1-107 (2005).

[23]

ASHRAE. 2009 Handbook of Fundamentals. Chapter 1 - Psychrometrics. American


Society of Heating, Refrigerating, and Air-Conditioning Engineers, Inc., Atlanta, GA
(2009).

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D. P. Gatley: Property Library ASHRAE-LibHuAirProp