ashrae_libhuairprop_users_guide.pdf

8/9/2019 ASHRAE_LibHuAirProp_Users_Guide.pdf

1/246

Users Guidefor

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.0I-P and SI units

Add-in funct ions fo r use w ithASHRAE Humid Air PropertiesLibrary 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

Ines Stoecker

Matthias Kunick

Mariana Nicke

Donald P. Gatley

KRETZSCHMARCONSULTINGENGINEERS

www.thermofluidprop.com

Prepared by


2/246

2010 American Society of Heating, Refrigerating and Air-ConditioningEngineers, 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 appearanceof any technical data or editorial material in this publication does not constituteendorsement, warranty, or guaranty by ASHRAE of any product, service, process,procedure, design, or the like. ASHRAE does not warrant that the information in thepublication is free of errors, and ASHRAE does not necessarily agree with anystatement or opinion in this publication. The entire risk of the use of any information inthis publication is assumed by the user.

LICENSING AGREEMENT

Using this product indicates your acceptance of the terms and conditions of thisagreement. The title and all copyrights and ownership rights of the product are retainedby ASHRAE. You assume responsibility for the selection of the product to achieve yourresults 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 twocomputers (such as a desktop and a laptop) at the same time. You may also copy theproduct into any computer-readable form for backup purposes. You may not copy ortransfer 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 theperson 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 thirdparties 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 andallowing other individuals to view the content. Personal use does not include makingcopies, in whole or in part, of the content for the purposes of distribution, reusing theinformation contained in the product in your own presentation, or posting any of thefiles 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 obtainpermission to copy and paste this publications content for other than only personaluse, go to www.ashrae.org/permissions.

ISBN 978-1-933742-74-8


3/246

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 th is software?

thermodynamic properties psychrometric functions

transport properties backward functions

What range of state is covered by th is 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 2009ASHRAE Handbook of Fundamentals were calculatedusing LibHuAirProp

Thermodynamic and psychrometric property algor ithms from ASHRAE Research Project 1485


4/246


5/246

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

Property Library for RealHumid 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 Function Overview for Real Moist Air ......................................................... I-P - 1/2

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

1.1.3 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 Algorithms for Real Moist Air .................................................................... I-P - 1/13

1.3.2 Algorithms for Steam and Water for Temperatures t 32F..................... I-P - 1/14

1.3.3 Algorithms for Steam and Ice for Temperatures t 32F ......................... I-P - 1/14

1.3.4 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 FluidEXLGraphics

for Excel

.......................................................................... I-P - 2/1

2.1.1 Installing FluidEXLGraphics

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

2.1.2 Example: Calculation of h= f(p,t,W) ........................................................... I-P - 2/92.1.3 Removing FluidEXL

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

2.2 Add-In FluidLAB for MATLAB

............................................................................. I-P - 2/17

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

2.2.2 Example: Calculation of h= f(p,t,W) in an M-File ..................................... I-P - 2/22

2.2.3 Example: Calculation of h= f(p,t,W) in the Command Window ................ I-P - 2/26

2.2.4 Removing FluidLAB including LibHuAirProp ............................................ I-P - 2/31


6/246


2.3 Add-In FluidMAT for Mathcad

............................................................................ I-P - 2/32

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

2.3.2 Example: Calculation of h= f(p,t,W) ......................................................... I-P - 2/36

2.3.3 Removing FluidMAT including LibHuAirProp ........................................... I-P - 2/39

2.4 Add-In FluidEES for Engineering Equation Solver

............................................. I-P - 2/40

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

2.4.2 Example: Calculation of h= f(p,t,W) ......................................................... I-P - 2/43

2.4.3 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 Function Overview for Real Moist Air .......................................................... SI - 1/2

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

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

1.2 Conversion of SI and I-P Units .............................................................................. SI - 1/101.3 Calculation Algorithms........................................................................................... SI - 1/13

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

1.3.2 Algorithms for Steam and Water for Temperatures t 0C ....................... SI - 1/14

1.3.3 Algorithms for Steam and Ice for Temperatures t 0C ........................... SI - 1/14

1.3.4 Overview of the Applied Formulations for Steam, Water, and Ice ............. SI - 1/14

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


for Excel

.......................................................................... SI - 2/1


including LibHuAirProp ....................................... SI - 2/1

2.1.2 Example: Calculation of h= f(p,t,W) ............................................................ SI - 2/2

2.1.3 Removing FluidEXLGraphics

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


7/246


2.2 Add-In FluidLAB for MATLAB

................................................................................ SI - 2/6

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

2.2.2 Example: Calculation of h= f(p,t,W) in an M-File ........................................ SI - 2/7

2.2.3 Example: Calculation of h= f(p,t,W) in the Command Window ................. SI - 2/14

2.2.4 Removing FluidLAB including LibHuAirProp ............................................. SI - 2/16

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

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

2.3.2 Example: Calculation of h= f(p,t,W) .......................................................... SI - 2/18

2.3.3 Removing FluidMAT including LibHuAirProp ............................................. SI - 2/21


.............................................. SI - 2/22

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

2.4.2 Example: Calculation of h= f(p,t,W) .......................................................... SI - 2/23

2.4.3 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

________________________________________________________________________

Prof. Hans-Joachim Kretzschmar

Sebastian Herrmann

Rathener Str. 6 Dr. Ines Stoecker

01259 Dresden, Germany Matthias Kunick

Phone: +49-3583-61-1846 Mariana Nicke

Fax: +49-3583-61-1846 Donald P. Gatley

E-mail: [email protected]: www.thermofluidprop.com

Kretzschmar

Consulting Engineers
http://www.thermofluidprop.com/http://www.thermofluidprop.com/http://www.thermofluidprop.com/


8/246


9/246

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 FluidEXLGraphics

Add-In for use in Excel

ASHRAE_LibHuAirProp_Users_Guide.pdf Users Guide

ZIP file " CD_FluidLAB_ASHRAE_LibHuAirProp.zip" for MATLAB

"


FluidLAB_LibHuAirProp_Setup.exe Installation program for the FluidLAB Add-In

for use in MATLAB


ZIP file " CD_FluidMAT_ASHRAE_LibHuAi rProp.zip" for Mathcad

"


FluidMAT_LibHuAirProp_Setup.exe Installation program for the FluidMAT Add-In

for use in Mathcad


ZIP file " CD_FluidEES_ASHRAE_LibHuAi rProp.zip" for Engineering Equation Solver

"


FluidEES_LibHuAirProp_Setup.exe Installation program for the FluidEES Add-In

for use in Engineering Equation Solver




10/246


11/246

Part I-P Units


12/246

I-P 1/2

1 Property Library ASHRAE-LibHuAirProp-IP

1.1 Function Overview

1.1.1 Function Overview for Real Moist Air

FunctionalDependence

Function Name Property or Function

= f( , , )a p t W a_ptW_HAP_IP Thermal diffusivity

=p f( , , )p t W alphap_ptW_HAP_IP Relative pressure coefficient

=p f( , , )p t W betap_ptW_HAP_IP Isothermal stress coefficient

= f( , , )c p t W c_ptW_HAP_IP Speed of sound

= f( , , )pc p t W cp_ptW_HAP_IP Specific isobaric heat capacity

= f( , , )vc p t W cv_ptW_HAP_IP Specific isochoric heat capacity

= f( , )f p t f_pt_HAP_IP Enhancement factor (decimal ratio)

= f( , , )h p t W h_ptW_HAP_IP Air-specific enthalpy

= f( , , )p t W Eta_ptW_HAP_IP Dynamic viscosity

= f( , , )p t W Kappa_ptW_HAP_IP Isentropic exponent

= f( , , )p t W Lambda_ptW_HAP_IP Thermal conductivity

= f( , , )p t W Ny_ptW_HAP_IP Kinematic viscosity

= f( , , )p t s W p_tsW_HAP_IP Pressure of humid air

p zelef( )= p_zele_HAP_IP Pressure of humid air from elevation

p p t WAir f( , , )= pAIR_ptW_HAP_IP Partial pressure of dry air in moist air

p p t WH2O f( , , )= pH2O_ptW_HAP_IP Partial pressure of water vapor in moist air

=H2Os f( , )p p t pH2Os_pt_HAP_IP Partial saturation pressure of water vapour in moist air



13/246



= f( , , )p t W phi_ptW_HAP_IP Relative humidity (decimal ratio)

= f( , , )Pr p t W Pr_ptW_HAP_IP PRANDTL number

=Air f( )W PsiAir_W_HAP_IP Mole fraction of dry air in moist air =H2O f( )W PsiH2O_W_HAP_IP Mole fraction of water vapor in moist air

= f( , , )p t W Rho_ptW_HAP_IP Density

= f( , , )s p t W s_ptW_HAP_IP Air-specific entropy

f( , , )t p h = t_phphi_HAP_IP Backward function: temperature from total pressure, air-specificenthalpy and relative humidity

= f( , , )t p h W t_phW_HAP_IP Backward function: temperature from total pressure, enthalpy andhumidity ratio

= f( , , )t p s W t_psW_HAP_IP Backward function: temperature from total pressure, entropy andhumidity ratio

= wbf( , , )t p t W t_ptwbW_HAP_IP Backward function: temperature from total pressure, wet-bulbtemperature and humidity ratio

=d f( , )t p W td_pW_HAP_IP Dew-point/frost-point temperature

s H Of( , )t p p= 2 ts_ppH2O_HAP_IP Backward function: saturation temperature of water from total pressand partial pressure of water vapor

=wb f( , , )t p t W twb_ptW_HAP_IP Wet-bulb/ice-bulb temperature

= f( , , )u p t W u_ptW_HAP_IP Air-specific internal energy

= f( , , )v p t W v_ptW_HAP_IP Air-specific volume

=H2O

f( , , )W p t p W_ptpH2O_HAP_IP Humidity ratio from total pressure, temperature, and partial pressure

water vapor

= f( , , )W p t W_ptphi_HAP_IP Humidity ratio from total pressure, temperature, and relative humidi

= df( , )W p t W_ptd_HAP_IP Humidity ratio from total pressure and dew-point temperature

H.-J. Kretzschmar, S. Herrmann, I. Stoecker, M. Kunick, M. Nicke, D


14/246

I-P 1/4



= wbf( , , )W p t t W_pttwb_HAP_IP Humidity ratio from total pressure, (dry bulb) temperature, and wet-bulb temperature

=s f( , )W p t Ws_pt_HAP_IP Saturation humidity ratio

=Air f( )W XiAir_W_HAP_IP Mass fraction of dry air in moist air

=H2O f( )W XiH2O_W_HAP_IP Mass fraction of water vapor in moist air

= f( , , )Z p t W Z_ptW_HAP_IP Compression factor (decimal ratio)



15/246

Range of Validity of Thermodynamic Properties

Property Range of Validity

Pressure: 0.00145 p 1450.4 psi

Temperature: 225.67 t 662 F

Humidity ratio: 0 W 10 lbw/lba

Relative humidity: 0 1 (decimal ratio)

Dew-point temperature: 225.67 td 662 F

Wet-bulb temperature: 225.67 t wb 662 F

Range of Validity of Transport Properties




Humidity ratio: 0 W 10 lbw/lba

Relative humidity: 0 1 (decimal ratio)

Molar Masses

Component Molar Mass Reference

Dry Air 63.859 lb/kmol [17]

Water 39.7168998 lb/kmol [5], [6]

Reference States

Property Dry Air Steam, Water, and Ice

Pressure 14.6959 psi ps(32.018F) = 0.088714 psi

Temperature 32F 32.018F

Enthalpy 0 Btu/lb 0.00026301926 Btu/lb

Entropy 0 Btu/(lb*R) 0 Btu/(lb*R)

Units

Symbol Quantity

p Pressure

t Temperature

W Humidity ratio

Relative humidity

td Dew point temperature

twb Wet bulb temperature



16/246

I-P 1/6

1.1.2 Function Overview for Steam and Water for Temperatures t32F


Function Name Property or Function Unit of theResult

Page

=liq f( , )h p t hliq_pt_97_IP Specific enthalpy of liquid water Btu/lb 3/43

=liq,s f( )h t hliqs_t_97_IP Specific enthalpy of saturated liquid water Btu/lb 3/44

=vap,s f( )h t hvaps_t_97_IP Specific enthalpy of saturated water vapor Btu/lb 3/45

=s f( )p t ps_t_97_IP Saturation pressure of water psi 3/46

=liq f( , )s p t sliq_pt_97_IP Specific entropy of liquid water Btu/(lbR) 3/47

=liq,s f( )s t sliqs_t_97_IP Specific entropy of saturated liquid water Btu/(lbR) 3/48

=vap,s f( )s t svaps_t_97_IP Specific entropy of saturated water vapor Btu/(lbR) 3/49

=s f( )t p ts_p_97_IP Saturation temperature of water F 3/50

=liq f( , )v p t vliq_pt_97_IP Specific volume of liquid water ft/lb 3/51

=liq,s f( )v t vliqs_t_97_IP Specific volume of saturated liquid water ft/lb 3/52

=vap,s f( )v t vvaps_t_97_IP Specific volume of saturated water vapor ft/lb 3/53



17/246

Range of Validity



Temperature: 32 t 662 F

Reference State

Property Water Vapor and Liquid Water

Pressure ps(32.018F) = 0.088714 psi

Temperature 32.018F

Enthalpy 0.00026301926 Btu/lb

Entropy 0 Btu/(lb*R)

Units

Symbol Quantity Unit

p Pressure psi

t Temperature F



18/246

I-P 1/8

1.1.3 Function Overview for Steam and Ice for Temperatures t32F


Function Name Property Unit of theResult

Pag

=ice,sub f( )h t hicesub_t_06_IP Specific enthalpy of saturated ice Btu/lb 3/5

=vap,sub f( )h t hvapsub_t_95_IP Specific enthalpy of saturated water vapor Btu/lb 3/5

=mel f( )p t pmel_t_08_IP Melting pressure of ice psi 3/5

=sub f( )p t psub_t_08_IP Sublimation pressure of ice psi 3/5

=ice,sub f( )s t sicesub_t_06_IP Specific entropy of saturated ice Btu/(lbR) 3/5

=vap,sub f( )s t svapsub_t_95_IP Specific entropy of saturated water vapor Btu/(lbR) 3/6

=mel f( )t p tmel_p_08_IP Melting temperature of ice F 3/6

=sub f( )t p tsub_p_08_IP Sublimation temperature of ice F 3/6

v tice,sub f( )= vicesub_t_06_IP Specific volume of saturated ice ft/lb 3/6

=vap,sub f( )v t vvapsub_t_95_IP Specific volume of saturated water vapor ft/lb 3/6



19/246

Range of Validity


Pressure: psub(225.67F) = 1.7407E-12 p 1450.4 psi


Reference State

Property Water Vapor and Ice

Pressure ps(32.018F) = 0.088714 psi

Temperature 32.018F

Enthalpy 0.00026301926 Btu/lb

Entropy 0 Btu/(lb*R)

Units

Symbol Quantity Unit

p Pressure psi

t Temperature F



20/246

I-P 1/10

1.2 Conversion of SI and I-P Units

Property Conversion: SI Units I-P Units Conversion: I-P Units

SI Unit

Thermal diffusivity a = SIIP 10.76391042

ft m

s s

aa SI IP 0.0929304

m ft

s s

a a=

Relative pressure

coefficient

p

,IP ,SI 9

1 1 5

R K

p p =

,SI ,IP 5

1 1 9

K R

p p =

Isothermal stress

coefficient

p

,IP ,SI0.062428

lb kg

ft m

p p =

,SI ,IP16.018463

kg lb

m ft

p p =

Speed of sound cSIIP 3.2808399

ft m

s s

cc= SI IP 0.3048

m ft

s s

c c=

Specific isobaric

heat capacity

pc

,IP ,SI0.2388459

Btu kJ

lb R kg K

p pc c=

,SI ,IP4.1868

kJ Btu

kg K lb R

p pc c=

Specific isochoric

heat capacityvc

,IP ,SI0.2388459

Btu kJ

lb R kg K

v vc c=

,SI ,IP4.1868

kJ Btu

kg K lb R

v vc c=

Dynamic viscosity

SIIP 0.02088543

lb s Paft s

= SI IP 47.880259

Pa lb ss ft

=

Enhancement

factorf IP SIf f= SI IPf f=



21/246


SI Unit

Air-specific

enthalpy

(moist air)

h

SIIP

a a

0.4299226 7.68565365666Btu kJ

lb kg

hh= +

=

SI IP

a a

7.68565365666 2.326kJ Btu

kg lb

h h

Specific enthalpy

(water, water

vapor, ice)

hw SIIP 0.4299226

Btu kJ

lb kg

hh= SI IP 2.326

kJ Btu

kg lb

h h=

Isentropic

exponent IP SI = SI IP =

Thermal

conductivity

SIIP 0.57778932Btu W

h ft R m K

= SI IP 1.73073467

W Btu

m K h ft R

=

Kinematic

viscosity

SIIP 10.763910417ft m

s s

= SI IP 0.092903040m ft

s s

=

Pressure p SIIP 0.14503774

psi kPa

pp= SI IP 6.894757

kPa psi

p p=

Relative humidity IP SI = SI IP =

Prandtl number Pr IP IPPr Pr = SI IPPr Pr =

Mole fraction IP SI = SI IP =

Density SIIP

0.062428lb kg

ft m

=

SI IP

16.018463kg lb

m ft

=

Air-specific

entropy

(moist air)

s

SIIP

a a

0.2388459 0.01616365106Btu kJ

lb R kg K

ss= +

=

SI IP

a a

kJ Btu

kg K lb R

40.01616365106s s



22/246

I-P 1/12



SI Unit

Specific entropy

(water, water

vapor, ice)

sw SIIP

a a

0.23884589Btu kJ

lb R kg K

ss= SI IP

a a

4.1868kJ Btu

kg K lb R

s s=

Temperature tSIIP 9 32

F C 5

tt= + SI IP

532

C F 9

t t =

Air-specific

internal energy

(moist air)

u

SIIP

a a

SI SI

a

( )

0.4299226 7.68565365666Btu kJ

lb kg

0.145037738 16.018453mkPa

kg

u h pv

hu

p

=

= +

SI IP

a a

SIPIP

a

( )

7.68565365666 2.236kJ Btu

kg lb

6.894757293 0.06ftpsi

lb

u h pv

u h

p

=

=

Air-specific

volume

(moist air)

v

SIIP

a a

16.018453ft m

lb kg

= SI IP

a a

0.062428m ft

kg lb

=

Specific volume

(water, water

vapor, ice)

wv

SIIP 16.018453ft m

lb kg

= SI IP 0.062428

m ft

kg lb

=

Humidity ratio W IP SIW W= SI IPW W=

Mass fraction IP SI = SI IP =

Compression

factorZ IP SIZ Z= SI IPZ Z=


23/246

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 fromthe fundamental equation of Lemmon et al. [14]

the calculation of the ideal-gas parts of the heat capacity, enthalpy, and entropy for watervapor from IAPWS-IF97 [7], [8], [9] for 32 Ft and from IAPWS-95 [5], [6] for 32 Ft

the calculation of the vapor-pressure enhancement factor from the equation given by themodels of Hyland and Wexler [21]

the calculation of the second and third molar virial coefficientsaa

B andaaa

C for dry air from

the fundamental equation of Lemmon et al. [14]

the calculation of the second and third molar virial coefficients wwB and wwwC for water and

steam from IAPWS-95 [5], [6]

the calculation of the air-water second molar cross-virial coefficient awB from Harvey and

Huang [15]

the calculation of the air-water third molar cross-virial coefficients aawC and awwC from Nelson

and Sauer [12], [13]

the calculation of the saturation pressure of water from IAPWS-IF97 [7], [8], [9] forand of the sublimation pressure of water from IAPWS-08 [11] for

32 Ft 32 Ft

the calculation of the isothermal compressibility of saturated liquid water from IAPWS-IF97 [7],[8], [9] for 32 Ft and that of ice from IAPWS-06 [10] for 32 Ft in the determination of thevapor-pressure enhancement factor

the calculation of Henry's constant from the IAPWS Guideline 2004 [16] in the determination ofthe enhancement factor. The mole fractions for the three main components of dry air weretaken from Lemmon et al. [14]. Argon was not considered in the calculation of Henrys constantin the former research projects, but it is now the third component of dry air.



24/246

I-P 1/14


1.3.2 Algorithms for Steam and Water for Temperatures t32F

Thep-Tdiagram in Fig. 1 shows the formulations used for water and water vapor. The temperaturerange above 32F is covered by IAPWS-IF97 [7], [8], [9]:

The saturation line is calculated from the IAPWS-IF97 saturation pressure equation 97s ( )p t

and saturation temperature equation 97s ( )t p .

The properties in the liquid region including saturated-liquid line are calculated from thefundamental 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 t32F

The sublimation curve is covered by the IAPWS-08 sublimation pressure equation 08subl( )p 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 followingp-Tdiagram shows the used IAPWS Formulations and the ranges where they areapplied.

1E-12

1E-11

1E-10

1E-9

1E-8

1E-7

1E-6

1E-5

1E-4

1E-3

1E-2

1E-1

1E+0

1E+1

1E+2

1E+3

1E+4

1E+5

1E+6

-200 -150 -100 -50 0 50 100 150 200 250 300 350 400

1450.4 psip=

12741 x 10 psip =

t

=

-225.6

7

F

t

=

32

F

t

=

662

F

tc

=7

05.

103

F

IceIAPWS-06

LiquidIAPWS-IF97

Region 1

VaporIAPWS-IF97

Region 2

VaporIAPWS-95

( )08sublp t

( )97sp t

0.08865 psip=

c 3278.4 psip = c

t/ C

10

10

10

10

10

10

10

10

10

10

10

10

1010

10

10

10

10

p/ kPa

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


25/246

I-P 2/1

2 Add-Ins for ASHRAE-LibHuAirProp-IP


for Excel

The FluidEXLGraphicsAdd-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.


including LibHuAirProp

In this section, the installation of FluidEXLGraphicsand 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 FluidEXLGraphicsincluding 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 FluidEXLGraphicsis

C:\Program Files\FluidEXL_Graphics_Eng

By clicking the "Browse" button, you can change the installation directory before installation (see

figure below).



26/246

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 FluidEXLGraphicshas been completed.

During the installation process the following files

advapi32.dll

Dformd.dll

Dforrt.dllFluidEXL_Graphics_Eng.xla

FluidGraph.ocx

INSTALL_EXL.LOG

LC.dll

LCKCE.dll

LibHuAirProp_IP.dll

LibHuAirProp_IP.hlp

LibHuAirProp_SI.dll

LibHuAirProp_SI.hlpmsvcp60.dll

msvcrt.dll

UNWISE.EXE

have been copied into the chosen destination folder, in the standard case

C:\Program Files\FluidEXL_Graphics_Eng.



27/246

I-P 2/3

Registering FluidEXLGraphicsas an add-in in Excelversions 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 clickingon it again.

In order to register "FluidEXL Graphics Eng" as an Add-In click "OK" in the "Add-Ins" dialog box.

Now, the new FluidEXLGraphicsmenu 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).



28/246


29/246

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.



30/246

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 check-

mark is removed from the box by clicking on it again.)


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



31/246

I-P 2/7

In order to use FluidEXLGraphicsin 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 FluidEXLGraphicsmenu bar will appear as marked with the

red circle in the next image.

Figure 2.1.8:FluidEXLGraphicsmenu bar

The installation of FluidEXLGraphics in Excel

version 2007 (or later) is now finished.

FluidEXLGraphicscan be used analogous to the description of Excel

until version 2007.

The FluidEXLGraphics

Help System

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

information in Excel:

- Click on "?" and then "Help" in the FluidEXLGraphicsmenu bar.

Information on individual property functions may be accessed via the following steps:

- Click "Calculate" in the FluidEXLGraphicsmenu 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 FluidEXLGraphicsin the window which is opened, in the standard case


and click "Yes" in order to complete the search.



32/246

I-P 2/8

Licensing the LibHuAirProp Property Library

The licensing procedure must be carried out when Excelstarts up and a FluidEXLGraphicsprompt

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

FluidEXLGraphicsaccording 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 filesLibHuAirProp_IP.dll LibHuAirProp_SI.dll

LibHuAirProp_IP.hlp LibHuAirProp_SI.hlp

in the installation folder of FluidEXLGraphics(the standard being

C:\Program Files\FluidEXL_Graphics_Eng)

using an appropriate program such as Exploreror Norton Commander

.

With this procedure both the LibHuAirProp-SI and LibHuAirProp-IP property libraries have beenlicensed.



33/246

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

pressurep, temperature tand 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 forpin 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 tin 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 Win lbw/lba(lb waterper 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/lbais to be displayed

e.g.: Click the cell D2

- Click "Calculate" in the FluidEXLGraphicsmenu bar

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

Figure 2.1.11:Choosing the library and function name



34/246

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 pressurepeither by clicking the cell with the value forp, by entering the name of the

cell, or by entering the value forpdirectly into the line next to "p in psi".

e. g.: Click the cell A2

- Situate the cursor on the line next to "tin F" and enter the value for teither by clicking the

cell with the value for t, by entering the name of the cell, or by entering the value for tdirectly

into the line next to "tin F".

e. g.: Type B2 into the line next to "t in F"

- Situate the cursor on the line next to "Win lbw/lba" and enter the value for the humidity ratio

Weither by clicking the cell with the value for W, by entering the name of the cell, or by

entering the value for Wdirectly into the line next to "Win lbw/lba.

e. g.: Click the cell C2

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



35/246

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 isopened, in the standard case


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 hin lb/lbaappears 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.



36/246

I-P 2/12

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

enthalpy his 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 therange 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 FluidEXLGraphicssee the function table in Chapter 1.



37/246


38/246

I-P 2/14

UnregisteringFluidEXLGraphics

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

In order to unregister the FluidEXLGraphicsAdd-In in Excel 2007 start Excel

and carry out the

following commands:

- Click the Windows Officebutton 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



39/246

I-P 2/15

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


- 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.



40/246

I-P 2/16



In order to remove FluidEXLGraphicsfrom 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 FluidEXLGraphicshas been completely removed from your computer.


41/246


42/246

I-P2/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.


43/246

I-P2/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 LCKCE.dll

Dformd.dll msvcp60.dll

Dforrt.dll msvcrt.dll

INSTALL.LOG Unwise.exeLibHuAirProp_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


44/246

I-P2/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_SIpAIR_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_SIt_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


45/246

I-P2/21



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).



Consulting Engineers. If you do not have this, or have any questions, you will find contact




If you do not enter a valid license it is still possible to use MATLABby clicking "Cancel". In this


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, youcan 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.


46/246

I-P2/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

pressurep, temperature tand humidity ratio Wusing 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 Explorershould 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 Explorermenu, 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:


47/246

I-P2/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 functionh= 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".


48/246

I-P2/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).


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 to open the folder

"\LibHuAirProp_IP_Example" in the "Current Directory" window.

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).


49/246

I-P2/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 by

clicking the insertion arrow (see next figure) in order to obtain a better view.

Figure 2.2.9:Embedding the "Editor" window

- In the following figure you will see the "EditorUntitled" window.


50/246

I-P2/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 file name as comment

%% paragraph separationp=14.6959; % pressure in psi declaration of the

variables pressure,

temperature, art and

composition of mixture

t=68; % temperature in F

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

%% paragraph separationh=h_ptW_HAP_IP(p,t,W) function call

%% paragraph separation

- 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 foryour overview and to make the process more easily understood.

Omit the semicolons after the numerical values if you wish to see the result for hand

the input parameters.

The values of the function parameters in their corresponding units stand for:

- First operand: Value forp= 14.6959 psi

(Range of validity: p= 0.00145 1450.4 psi)


51/246

I-P2/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 waterper 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 errormessage 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).


52/246

I-P2/28


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


Figure 2.2.13:MATLABwith calculated result


53/246

I-P2/29


The result for happears 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 MATLABcan 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


54/246

I-P2/30


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


Figure 2.2.16:MATLABwith 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 forp= 14.6959 psi

(Range of validity: p= 0.00145 1450.4 psi)

- Second operand: Value for t= 68 F


- Third operand: Value for W= 0.01 lbw/lba (lb waterper lb air)


- Confirm your entry by pressing the "ENTER" button.



55/246

I-P2/31


Figure 2.2.17:MATLABwith 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 beremoved as well.


56/246

I-P2/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 .


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",


CD_FluidMAT_ASHRAE_LibHuAirProp

in your Windows Explorer

, Norton Commander

etc.


Within this folder you will see the following files:


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.


57/246

I-P2/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 Windowsprograms

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


58/246

I-P2/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 Mathcadversion 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 registration in the dialog window "Insert

Function" for LibHuAirProp-SI (Mathcad

version

11 or lower)

MAT_LibHuAirProp_SI_DE.xml Function registration in the dialog window "Insert

Function" for LibHuAirProp-SI (German Mathcad


MAT_LibHuAirProp_SI_EN.xml Function registration in the dialog window "Insert

Function" for LibHuAirProp-SI (English Mathcad


From within Mathcad

you can now select the ASHRAE-LibHuAirProp property functions.


59/246

I-P2/35



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

LibHuAirProp in Mathcadand a FluidMAT prompt message appears. In this case, you will see the

"License Information" window for LibHuAirProp (see figure below).



Consulting Engineers If you do not have this, or have any questions, you will find contact




If you do not enter a valid license it is still possible to use Mathcad

by clicking "Cancel". In this


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.


60/246

I-P2/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 tand humidity ratio Wof moist air using FluidMAT.

Please carry out the following steps:

- Start Mathcad

.

Type "p:" and enter the value for pressurepin 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. "inpsi". 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 tin 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 Win lbw/lba(lb waterper lb air)


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 colone.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


61/246

I-P2/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).


sheet with formula and placeholders

- The cursor is now situated on the first operand. You can now enter the value forpeither 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 tdirectly or by typing the name of the variable in which the value

of the temperature has been saved.

e.g.: Enter "t".


62/246

I-P2/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 Wdirectly 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 hwhich we have just calculated, or you can havethe 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 hin Btu/lbaappears. 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 inMathcad.


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 Mathcaddata flow and the DLL

calculations are working together successfully.


63/246

I-P2/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.


64/246

I-P2/40



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.


applications you may have open, since

Windowsmay need to be rebooted during the installation process.

After you have downloaded and extracted the zip-file "CD_FluidEES_ASHRAE_LibHuAirProp.zip",


CD_FluidEES_ASHRAE_LibHuAirProp

in your Windows Explorer, Norton Commanderor other similar program you are using.


Within this folder you will see the following two files:


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 Windowsprograms 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."


65/246

I-P2/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 Windowsprograms

Dformd.dll - Dynamic link library for use in Windowsprograms

Dforrt.dll - Dynamic link library for use in Windowsprograms

INSTALL.LOG - Log file

LCKCE.dll - Dynamic link library for use in Windowsprograms

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 Windowsprograms

msvcrt.dll - Dynamic link library for use in Windowsprograms

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.


66/246


67/246

I-P2/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

pressurep, temperature tand humidity ratio Wfor 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 EESsheet, as shown in Figure 2.4.4.

Note: the units ofp, t, and Wmust correspond to those in Chapter 1.

Figure 2.4.4:Preparing an EESsheet for the calculation

- The function parameters values stand for:

- First operand: Total pressurep= 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 waterper 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 EESmenu 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 EESmenu bar and select "Function Info".


68/246

I-P2/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).


69/246


70/246

I-P2/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, select

"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 Pr

ashrae_libhuairprop_users_guide.pdf

Documents