pyXSteam is a port of the Matlab/Excel Package XSteam by Magnus Holmgren, www.xeng.com to Python
Project description
XSteam
======
Original Released by Magnus Holmgren for Matlab and Excel: http://xsteam.sourceforge.net and/or http://www.xeng.com
XSteam provides (mostly) accurate steam and water properties from 0  1000 bar and from
0  2000 °C according to the IAPWS release IF97.
(www.iapws.org) http://www.iapws.org/relguide/IF97Rev.pdf
For accuracy of the functions in different regions see IF97 Page 4
Also includes thermal conductivity and viscosity, wich are not part of the IF97 release.
Thermal Conductivity:(IAPWS 1998) http://www.iapws.org/relguide/ThCond.pdf
Viscosity: (2003)
Requirements
============
Tests require numpy, Demos require numpy and matplotlib
Install
=======
run "python setup.py" install
To test is setup was successful, run bin/pyXSteamDemo.py from the command line.
There are still (as of v0.3.2) some Errors in Thermal Conductivity and Speed of sound functions,
so be warned that they exceed the Error Range.
Apart form accuracy errors, there should be no warnings.
to run unittests: "python setup.py test" but make sure numpy is installed
Nomenclature
============
All Functions follow the same naming schema:
First the wanted property, then a underscore "_", then the wanted input properties
Example: t_ph is temperature as a function of pressure and enthalpy.
For a list of valid functions se bellow:
t Temperature (°C or °F)
p Pressure (bar or psi)
h Enthalpy (kJ/kg or btu/lb)
v Specific volume (m3/kg or ft^3/lb)
rho Density (kg/m3 or lb/ft^3)
s Specific entropy (kJ/(kg °C) or btu/(lb °F))
u Specific internal energy (kJ/kg or btu/lb)
Cp Specific isobaric heat capacity (kJ/(kg °C) or btu/(lb °F))
Cv Specific isochoric heat capacity (kJ/(kg °C) or btu/(lb °F))
w Speed of sound (m/s or ft/s)
my Viscosity (N s/m^2 or lbm/ft/hr)
tc Thermal Conductivity (W/(m °C) or btu/(h ft °F))
st Surface Tension (N/m or lb/ft)
x Vapour fraction
vx Vapour Volume Fraction
Usage
=====
Simple Example:
from pyXSteam.XSteam import XSteam
steamTable = XSteam(XSteam.UNIT_SYSTEM_MKS)
print steamTable.hL_p(220.0)
By using the unitSystem Parameter, you can tell XSteam witch Unit System you are using.
steamTable = XSteam(XSteam.UNIT_SYSTEM_MKS): m/kg/sec/°C/bar/W
steamTable = XSteam(XSteam.UNIT_SYSTEM_FLS): ft/lb/sec/°F/psi/btu
steamTable = XSteam(XSteam.UNIT_SYSTEM_BARE): m/kg/sec/K/MPa/W
To enable logging, add the following lines to your code:
import logging
logger = logging.getLogger('pyXSteam')
logger.setLevel(logging.DEBUG)
sh = logging.StreamHandler()
sh.setFormatter(logging.Formatter('%(name)s  %(levelname)s  %(message)s'))
logger.addHandler(sh)
Available Functions
===================
Temperature

tsat_p Saturation temperature
t_ph Temperature as a function of pressure and enthalpy
t_ps Temperature as a function of pressure and entropy
t_hs Temperature as a function of enthalpy and entropy
Pressure

psat_t Saturation pressure
p_hs Pressure as a function of h and s.
p_hrho Pressure as a function of h and rho. Very unaccurate for solid water region since it's almost incompressible!
Enthalpy

hV_p Saturated vapour enthalpy
hL_p Saturated liquid enthalpy
hV_t Saturated vapour enthalpy
hL_t Saturated liquid enthalpy
h_pt Entalpy as a function of pressure and temperature.
h_ps Entalpy as a function of pressure and entropy.
h_px Entalpy as a function of pressure and vapour fraction
h_prho Entalpy as a function of pressure and density. Observe for low temperatures (liquid) this equation has 2 solutions.
h_tx Entalpy as a function of temperature and vapour fraction
Specific volume

vV_p Saturated vapour volume
vL_p Saturated liquid volume
vV_t Saturated vapour volume
vL_t Saturated liquid volume
v_pt Specific volume as a function of pressure and temperature.
v_ph Specific volume as a function of pressure and enthalpy
v_ps Specific volume as a function of pressure and entropy.
Density

rhoV_p Saturated vapour density
rhoL_p Saturated liquid density
rhoV_t Saturated vapour density
rhoL_t Saturated liquid density
rho_pt Density as a function of pressure and temperature.
rho_ph Density as a function of pressure and enthalpy
rho_ps Density as a function of pressure and entropy.
Specific entropy

sV_p Saturated vapour entropy
sL_p Saturated liquid entropy
sV_t Saturated vapour entropy
sL_t Saturated liquid entropy
s_pt Specific entropy as a function of pressure and temperature (Returns saturated vapour entalpy if mixture.)
s_ph Specific entropy as a function of pressure and enthalpy
Specific internal energy

uV_p Saturated vapour internal energy
uL_p Saturated liquid internal energy
uV_t Saturated vapour internal energy
uL_t Saturated liquid internal energy
u_pt Specific internal energy as a function of pressure and temperature.
u_ph Specific internal energy as a function of pressure and enthalpy
u_ps Specific internal energy as a function of pressure and entropy.
Specific isobaric heat capacity

CpV_p Saturated vapour heat capacity
CpL_p Saturated liquid heat capacity
CpV_t Saturated vapour heat capacity
CpL_t Saturated liquid heat capacity
Cp_pt Specific isobaric heat capacity as a function of pressure and temperature.
Cp_ph Specific isobaric heat capacity as a function of pressure and enthalpy
Cp_ps Specific isobaric heat capacity as a function of pressure and entropy.
Specific isochoric heat capacity

CvV_p Saturated vapour isochoric heat capacity
CvL_p Saturated liquid isochoric heat capacity
CvV_t Saturated vapour isochoric heat capacity
CvL_t Saturated liquid isochoric heat capacity
Cv_pt Specific isochoric heat capacity as a function of pressure and temperature.
Cv_ph Specific isochoric heat capacity as a function of pressure and enthalpy
Cv_ps Specific isochoric heat capacity as a function of pressure and entropy
Speed of sound

wV_p Saturated vapour speed of sound
wL_p Saturated liquid speed of sound
wV_t Saturated vapour speed of sound
wL_t Saturated liquid speed of sound
w_pt Speed of sound as a function of pressure and temperature
w_ph Speed of sound as a function of pressure and enthalpy
w_ps Speed of sound as a function of pressure and entropy
Viscosity

my_pt Viscosity as a function of pressure and temperature.
my_ph Viscosity as a function of pressure and enthalpy
my_ps Viscosity as a function of pressure and entropy
Thermal Conductivity

tcL_p Saturated vapour thermal conductivity
tcV_p Saturated liquid thermal conductivity
tcL_t Saturated vapour thermal conductivity
tcV_t Saturated liquid thermal conductivity
tc_pt Thermal conductivity as a function of pressure and temperature
tc_ph Thermal conductivity as a function of pressure and enthalpy
tc_hs Thermal conductivity as a function of enthalpy and entropy
Surface tension

st_t Surface tension for two phase water/steam as a function of T
st_p Surface tension for two phase water/steam as a function of T
Vapour fraction

x_ph Vapour fraction as a function of pressure and enthalpy
x_ps Vapour fraction as a function of pressure and entropy
Vapour volume fraction

vx_ph Vapour volume fraction as a function of pressure and enthalpy
vx_ps Vapour volume fraction as a function of pressure and entropy
## v0.3.3b, 21.01.2018
* fix for typo
## v0.3.3, 21.01.2018
* change changelog to markdown
* add gitignore
* remove unnecessary files
* reworked setup.py for more sanity
* cleanup and better logging
## v0.3.1, 18.02.2014
* logging capability's
## v0.3, 08.02.2014
* User can now use ft/lb/sec/°F/psi/btu, m/kg/sec/°C/bar/W or m/kg/sec/K/MPa/W
## v0.2, 03.02.2014
* demos, changes to unitTests and some minor fixes  8 Tests fail
## v0.1, 11.02.2014
* Initial release.  26 Tests fail
======
Original Released by Magnus Holmgren for Matlab and Excel: http://xsteam.sourceforge.net and/or http://www.xeng.com
XSteam provides (mostly) accurate steam and water properties from 0  1000 bar and from
0  2000 °C according to the IAPWS release IF97.
(www.iapws.org) http://www.iapws.org/relguide/IF97Rev.pdf
For accuracy of the functions in different regions see IF97 Page 4
Also includes thermal conductivity and viscosity, wich are not part of the IF97 release.
Thermal Conductivity:(IAPWS 1998) http://www.iapws.org/relguide/ThCond.pdf
Viscosity: (2003)
Requirements
============
Tests require numpy, Demos require numpy and matplotlib
Install
=======
run "python setup.py" install
To test is setup was successful, run bin/pyXSteamDemo.py from the command line.
There are still (as of v0.3.2) some Errors in Thermal Conductivity and Speed of sound functions,
so be warned that they exceed the Error Range.
Apart form accuracy errors, there should be no warnings.
to run unittests: "python setup.py test" but make sure numpy is installed
Nomenclature
============
All Functions follow the same naming schema:
First the wanted property, then a underscore "_", then the wanted input properties
Example: t_ph is temperature as a function of pressure and enthalpy.
For a list of valid functions se bellow:
t Temperature (°C or °F)
p Pressure (bar or psi)
h Enthalpy (kJ/kg or btu/lb)
v Specific volume (m3/kg or ft^3/lb)
rho Density (kg/m3 or lb/ft^3)
s Specific entropy (kJ/(kg °C) or btu/(lb °F))
u Specific internal energy (kJ/kg or btu/lb)
Cp Specific isobaric heat capacity (kJ/(kg °C) or btu/(lb °F))
Cv Specific isochoric heat capacity (kJ/(kg °C) or btu/(lb °F))
w Speed of sound (m/s or ft/s)
my Viscosity (N s/m^2 or lbm/ft/hr)
tc Thermal Conductivity (W/(m °C) or btu/(h ft °F))
st Surface Tension (N/m or lb/ft)
x Vapour fraction
vx Vapour Volume Fraction
Usage
=====
Simple Example:
from pyXSteam.XSteam import XSteam
steamTable = XSteam(XSteam.UNIT_SYSTEM_MKS)
print steamTable.hL_p(220.0)
By using the unitSystem Parameter, you can tell XSteam witch Unit System you are using.
steamTable = XSteam(XSteam.UNIT_SYSTEM_MKS): m/kg/sec/°C/bar/W
steamTable = XSteam(XSteam.UNIT_SYSTEM_FLS): ft/lb/sec/°F/psi/btu
steamTable = XSteam(XSteam.UNIT_SYSTEM_BARE): m/kg/sec/K/MPa/W
To enable logging, add the following lines to your code:
import logging
logger = logging.getLogger('pyXSteam')
logger.setLevel(logging.DEBUG)
sh = logging.StreamHandler()
sh.setFormatter(logging.Formatter('%(name)s  %(levelname)s  %(message)s'))
logger.addHandler(sh)
Available Functions
===================
Temperature

tsat_p Saturation temperature
t_ph Temperature as a function of pressure and enthalpy
t_ps Temperature as a function of pressure and entropy
t_hs Temperature as a function of enthalpy and entropy
Pressure

psat_t Saturation pressure
p_hs Pressure as a function of h and s.
p_hrho Pressure as a function of h and rho. Very unaccurate for solid water region since it's almost incompressible!
Enthalpy

hV_p Saturated vapour enthalpy
hL_p Saturated liquid enthalpy
hV_t Saturated vapour enthalpy
hL_t Saturated liquid enthalpy
h_pt Entalpy as a function of pressure and temperature.
h_ps Entalpy as a function of pressure and entropy.
h_px Entalpy as a function of pressure and vapour fraction
h_prho Entalpy as a function of pressure and density. Observe for low temperatures (liquid) this equation has 2 solutions.
h_tx Entalpy as a function of temperature and vapour fraction
Specific volume

vV_p Saturated vapour volume
vL_p Saturated liquid volume
vV_t Saturated vapour volume
vL_t Saturated liquid volume
v_pt Specific volume as a function of pressure and temperature.
v_ph Specific volume as a function of pressure and enthalpy
v_ps Specific volume as a function of pressure and entropy.
Density

rhoV_p Saturated vapour density
rhoL_p Saturated liquid density
rhoV_t Saturated vapour density
rhoL_t Saturated liquid density
rho_pt Density as a function of pressure and temperature.
rho_ph Density as a function of pressure and enthalpy
rho_ps Density as a function of pressure and entropy.
Specific entropy

sV_p Saturated vapour entropy
sL_p Saturated liquid entropy
sV_t Saturated vapour entropy
sL_t Saturated liquid entropy
s_pt Specific entropy as a function of pressure and temperature (Returns saturated vapour entalpy if mixture.)
s_ph Specific entropy as a function of pressure and enthalpy
Specific internal energy

uV_p Saturated vapour internal energy
uL_p Saturated liquid internal energy
uV_t Saturated vapour internal energy
uL_t Saturated liquid internal energy
u_pt Specific internal energy as a function of pressure and temperature.
u_ph Specific internal energy as a function of pressure and enthalpy
u_ps Specific internal energy as a function of pressure and entropy.
Specific isobaric heat capacity

CpV_p Saturated vapour heat capacity
CpL_p Saturated liquid heat capacity
CpV_t Saturated vapour heat capacity
CpL_t Saturated liquid heat capacity
Cp_pt Specific isobaric heat capacity as a function of pressure and temperature.
Cp_ph Specific isobaric heat capacity as a function of pressure and enthalpy
Cp_ps Specific isobaric heat capacity as a function of pressure and entropy.
Specific isochoric heat capacity

CvV_p Saturated vapour isochoric heat capacity
CvL_p Saturated liquid isochoric heat capacity
CvV_t Saturated vapour isochoric heat capacity
CvL_t Saturated liquid isochoric heat capacity
Cv_pt Specific isochoric heat capacity as a function of pressure and temperature.
Cv_ph Specific isochoric heat capacity as a function of pressure and enthalpy
Cv_ps Specific isochoric heat capacity as a function of pressure and entropy
Speed of sound

wV_p Saturated vapour speed of sound
wL_p Saturated liquid speed of sound
wV_t Saturated vapour speed of sound
wL_t Saturated liquid speed of sound
w_pt Speed of sound as a function of pressure and temperature
w_ph Speed of sound as a function of pressure and enthalpy
w_ps Speed of sound as a function of pressure and entropy
Viscosity

my_pt Viscosity as a function of pressure and temperature.
my_ph Viscosity as a function of pressure and enthalpy
my_ps Viscosity as a function of pressure and entropy
Thermal Conductivity

tcL_p Saturated vapour thermal conductivity
tcV_p Saturated liquid thermal conductivity
tcL_t Saturated vapour thermal conductivity
tcV_t Saturated liquid thermal conductivity
tc_pt Thermal conductivity as a function of pressure and temperature
tc_ph Thermal conductivity as a function of pressure and enthalpy
tc_hs Thermal conductivity as a function of enthalpy and entropy
Surface tension

st_t Surface tension for two phase water/steam as a function of T
st_p Surface tension for two phase water/steam as a function of T
Vapour fraction

x_ph Vapour fraction as a function of pressure and enthalpy
x_ps Vapour fraction as a function of pressure and entropy
Vapour volume fraction

vx_ph Vapour volume fraction as a function of pressure and enthalpy
vx_ps Vapour volume fraction as a function of pressure and entropy
## v0.3.3b, 21.01.2018
* fix for typo
## v0.3.3, 21.01.2018
* change changelog to markdown
* add gitignore
* remove unnecessary files
* reworked setup.py for more sanity
* cleanup and better logging
## v0.3.1, 18.02.2014
* logging capability's
## v0.3, 08.02.2014
* User can now use ft/lb/sec/°F/psi/btu, m/kg/sec/°C/bar/W or m/kg/sec/K/MPa/W
## v0.2, 03.02.2014
* demos, changes to unitTests and some minor fixes  8 Tests fail
## v0.1, 11.02.2014
* Initial release.  26 Tests fail
Project details
Release history Release notifications  RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pyXSteam0.3.3b1.zip
(65.5 kB
view hashes)
Built Distributions
pyXSteam0.3.3b1py2.7.egg
(104.8 kB
view hashes)
pyXSteam0.3.3b1py2noneany.whl
(52.7 kB
view hashes)
Close
Hashes for pyXSteam0.3.3b1py2noneany.whl
Algorithm  Hash digest  

SHA256  56529106876fa0998b4786b4082904fa4423a7df3e3ec870c0c1bcfc61f7a56b 

MD5  6e75c0eac2f75221e63dd7bf78b94592 

BLAKE2b256  3f942499e2bb8b7541515ef522d6c7500e1a02f48ef9bd141890d6b7d15a3aa9 