Ocean Science www.ocean-sci.net 1812-0784 1812-0792 6 3 2010 10.5194/os-6-695-2010 http://www.ocean-sci.net/6/695/2010/ http://www.ocean-sci.net/6/695/2010/os-6-695-2010.html http://www.ocean-sci.net/6/695/2010/os-6-695-2010.pdf 695 718 2010-07-16 Numerical implementation and oceanographic application of the thermodynamic potentials of liquid water, water vapour, ice, seawater and humid air – Part 2: The library routines D. G. Wright R. Feistel rainer.feistel@io-warnemuende.de J. H. Reissmann K. Miyagawa D. R. Jackett W. Wagner U. Overhoff C. Guder A. Feistel G. M. Marion Bedford Institute of Oceanography, Dartmouth, NS, B2Y 4A2, Canada Leibniz-Institut für Ostseeforschung, Seestraße 15, 18119 Warnemünde, Germany Bundesamt für Seeschifffahrt und Hydrographie, Bernhard-Nocht-Straße 78, 20359 Hamburg, Germany 4-12-11-628, Nishiogu, Arakawa-ku, Tokyo, 116-0011, Japan CSIRO Marine and Atmospheric Research, P.O. Box 1538, Hobart, TAS 7001, Australia Ruhr-Universität Bochum, Lehrstuhl für Thermodynamik, 44780 Bochum, Germany Technische Universität Berlin, Einsteinufer 25, 10587 Berlin, Germany Desert Research Institute, Reno, NV, USA Dan Wright passed away on 8 July 2010 The SCOR/IAPSO¹ Working Group 127 on Thermodynamics and Equation of State of Seawater has prepared recommendations for new methods and algorithms for numerical estimation of the the thermophysical properties of seawater. As an outcome of this work, a new International Thermodynamic Equation of Seawater (TEOS–10) was endorsed by IOC/UNESCO² in June 2009 as the official replacement and extension of the 1980 International Equation of State, EOS-80. As part of this new standard a source code package has been prepared that is now made freely available to users via the World Wide Web. This package includes two libraries referred to as the SIA (Sea-Ice-Air) library and the GSW (Gibbs SeaWater) library. Information on the GSW library may be found on the TEOS-10 web site (<a href="http://www.TEOS-10.org" target="_blank">http://www.TEOS-10.org</a>). This publication provides an introduction to the SIA library which contains routines to calculate various thermodynamic properties as discussed in the companion paper. The SIA library is very comprehensive, including routines to deal with fluid water, ice, seawater and humid air as well as equilibrium states involving various combinations of these, with equivalent code developed in different languages. The code is hierachically structured in modules that support (i) almost unlimited extension with respect to additional properties or relations, (ii) an extraction of self-contained sub-libraries, (iii) separate updating of the empirical thermodynamic potentials, and (iv) code verification on different platforms and between different languages. Error trapping is implemented to identify when one or more of the primary routines are accessed significantly beyond their established range of validity. The initial version of the SIA library is available in Visual Basic and FORTRAN as a supplement to this publication and updates will be maintained on the TEOS-10 web site. <br><br> ¹SCOR/IAPSO: Scientific Committee on Oceanic Research/International Association for the Physical Sciences of the Oceans<br> ²IOC/UNESCO: Intergovernmental Oceanographic Commission/United Nations Educational, Scientific and Cultural Organization Dauphinee, T. M.: Introduction to the special issue on the Practical salinity Scale 1978, IEEE J. Oceanic Eng., OE-5, 1–2, 1980. Feistel, R.: A new extended Gibbs thermodynamic potential of seawater, Progr. Oceanogr., 58, 43–115, 2003. Feistel, R.: Numerical implementation and oceanographic application of the Gibbs thermodynamic potential of seawater, Ocean Sci., 1, 9–16, doi:10.5194/os-1-9-2005, 2005. Feistel, R.: A Gibbs Function for Seawater Thermodynamics for −6~to 80 °C and Salinity up to 120 g/kg, Deep-Sea Res. Pt I, 55, 1639–1671, 2008. Feistel, R.: Extended Equation of State for Seawater at Elevated Temperature and Salinity, Desalination, 250, 14–18, 2010. Feistel, R. and Wagner, W.: High-pressure thermodynamic Gibbs functions of ice and sea ice, J. Mar. Res., 63, 95–139, 2005. Feistel, R. and Wagner, W.: A new equation of state for H₂O ice Ih, J. Phys. Chem. Ref. Data, 35, 1021–1047, 2006. Feistel, R. and Wagner, W.: Sublimation pressure and sublimation enthalpy of H₂O ice Ih between 0~and 273.16 K, Geochim. Cosmochim. Ac., 71, 36–45, 2007. Feistel, R., Wagner, W., Tchijov, V., and Guder, C.: Numerical implementation and oceanographic application of the Gibbs potential of ice, Ocean Sci., 1, 29–38, doi:10.5194/os-1-29-2005, 2005. Feistel, R., Weinreben, S., Wolf, H., Seitz, S., Spitzer, P., Adel, B., Nausch, G., Schneider, B., and Wright, D. G.: Density and Absolute Salinity of the Baltic Sea 2006-2009, Ocean Sci., 6, 3–24, doi:10.5194/os-6-3-2010, 2010a. Feistel, R., Wright, D. G., Jackett, D. R., Miyagawa, K., Reissmann, J. H., Wagner, W., Overhoff, U., Guder, C., Feistel, A., and Marion, G. M.: Numerical implementation and oceanographic application of the thermodynamic potentials of liquid water, water vapour, ice, seawater and humid air - Part~1: Background and equations, Ocean Sci., 6, 633–677, doi:10.5194/os-6-633-2010, 2010b. Feistel, R., Wright, D. G., Kretzschmar, H.-J., Hagen, E., Herrmann, S., and Span, R.: Thermodynamic properties of sea air, Ocean Sci., 6, 91–141, doi:10.5194/os-6-91-2010, 2010c. Feistel, R., Wright, D. G., Miyagawa, K., Harvey, A. H., Hruby, J., Jackett, D. R., McDougall, T. J., and Wagner, W.: Mutually consistent thermodynamic potentials for fluid water, ice and seawater: a new standard for oceanography, Ocean Sci., 4, 275–291, doi:10.5194/os-4-275-2008, 2008. Harvey, A. H. and Huang, P. H.: First-Principles Calculation of the Air-Water Second Virial Coefficient, Int. J. Thermophys., 28, 556–565, 2007. Hyland, R. W. and 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 up to 5 MPa, ASHRAE Transact., 89, 520–535, 1983. IAPWS: Revised Release on the IAPWS Industrial Formulation 1997 for the Thermodynamic Properties of Water and Steam, The International Association for the Properties of Water and Steam, August~2007, available at: http://www.iapws.org, last access: 15~July~2010, Lucerne, Switzerland, 2007. IAPWS: Release on the IAPWS Formulation 2008 for the Thermodynamic Properties of Seawater, The International Association for the Properties of Water and Steam, September~2008, available at: http://www.iapws.org, last access: 15~July~2010, Berlin, Germany, 2008a. IAPWS: Revised Release on the Pressure along the Melting and Sublimation Curves of Ordinary Water Substance, The International Association for the Properties of Water and Steam, September~2008, available at: http://www.iapws.org, last access: 15~July~2010, Berlin, Germany, 2008b. IAPWS: Revised Release on the IAPWS Formulation 1995 for the Thermodynamic Properties of Ordinary Water Substance for General and Scientific Use, The International Association for the Properties of Water and Steam, September~2009, available at: http://www.iapws.org, last access: 15~July~2010, Doorwerth, The Netherlands, 2009a. IAPWS: Revised Release on the Equation of State 2006 for H₂O Ice~Ih, The International Association for the Properties of Water and Steam, September~2009, available at: http://www.iapws.org, last access: 15~July~2010, Doorwerth, The Netherlands, 2009b. IAPWS: Supplementary Release on a Computationally Efficient Thermodynamic Formulation for Liquid Water for Oceanographic Use, The International Association for the Properties of Water and Steam, September~2009, available at: http://www.iapws.org, last access: 15~July~2010, Doorwerth, The Netherlands, 2009c. IAPWS: Guideline on an Equation of State for Humid Air in Contact with Seawater and Ice, Consistent with the IAPWS Formulation 2008 for the Thermodynamic Properties of Seawater, The International Association for the Properties of Water and Steam, Niagara Falls, Canada, 18–23~July 2010, to be adopted, 2010. IOC, SCOR and IAPSO: The international thermodynamic equation of seawater - 2010: Calculation and use of thermodynamic properties. Intergovernmental Oceanographic Commission, available from http://www.TEOS-10.org, last access: 15~July~2010, Manuals and Guides No 56, UNESCO (English), Paris, 2010. Jackett, D. R., McDougall, T. J., Feistel, R., Wright, D. G., and Griffies, S. M.: Algorithms for density, potential temperature, conservative temperature and freezing temperature of seawater, J. Atmos. Ocean. Tech., 23, 1709–1728, 2006. Lemmon, E. W., Jacobsen, R. T., Penoncello, S. G., and Friend, D. G.: Thermodynamic Properties of Air and Mixtures of Nitrogen, Argon and Oxygen From 60~to 2000 K at Pressures to 2000 MPa, J. Phys. Chem. Ref. Data, 29, 331–362, 2000. Lewis, E. L.: The Practical Salinity Scale and its antecedents, IEEE J. Oceanic Eng., OE-5, 3–8, 1980. Marion, G. M., Millero, F. J., and Feistel, R.: Precipitation of solid phase calcium carbonates and their effect on application of seawater $S_A–T–P$ models, Ocean Sci., 5, 285–291, doi:10.5194/os-5-285-2009, 2009. McDougall, T. J., Jackett, D. R., and Millero, F. J.: An algorithm for estimating Absolute Salinity in the global ocean, Ocean Sci. Discuss., 6, 215–242, doi:10.5194/osd-6-215-2009, 2009. Millero, F. J. and Huang, F.: The density of seawater as a function of salinity (5~to 70 g kg^−1) and temperature (273.15~to 363.15 K), Ocean Sci., 5, 91–100, doi:10.5194/os-5-91-2009, 2009. Millero, F. J., Feistel, R., Wright, D. G., and McDougall, T. J.: The composition of Standard Seawater and the definition of the Reference-Composition Salinity Scale, Deep-Sea Res. Pt I, 55, 50–72, 2008. Poisson, A. and Gadhoumi, M. H.: An extension of the Practical Salinity Scale 1978 and the Equation of State 1980 to high salinities, Deep-Sea Res. Pt I, 40, 1689–1698, 1993. Safarov, J., Millero, F., Feistel, R., Heintz, A., and Hassel, E.: Thermodynamic properties of standard seawater: extensions to high temperatures and pressures, Ocean Sci., 5, 235–246, doi:10.5194/os-5-235-2009, 2009. Saunders, P. M.: Practical Conversion of Pressure to Depth, J. Phys. Oceanogr., 11, 573–574, 1981. UNESCO Technical Papers in Marine Science, #37:"Background papers and supporting data on the practical salinity scale, 1978", UNESCO Division of Marine Science, Paris, 144~pp., 1981. Wagner, W. and 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. Wright, D. G., Pawlowicz, R., McDougall, T. J., Feistel, R., and Marion, G. M.: Absolute Salinity, "Density Salinity" and the Reference Composition Salinity Scale: Present and Future Use in the Seawater Standard TEOS-10, Ocean Sci., in press, 2010.