Geoscientific Model Development Discussions www.geosci-model-dev-discuss.net 1991-9611 1991-962X 2 2 2009 10.5194/gmdd-2-1299-2009 http://www.geosci-model-dev-discuss.net/2/1299/2009/ http://www.geosci-model-dev-discuss.net/2/1299/2009/gmdd-2-1299-2009.html http://www.geosci-model-dev-discuss.net/2/1299/2009/gmdd-2-1299-2009.pdf 1299 1333 2009-11-17 Tracers and traceability: implementing the cirrus parameterisation from LACM in the TOMCAT/SLIMCAT chemistry transport model as an example of the application of quality assurance to legacy models A. M. Horseman a.horseman@computer.org A. R. MacKenzie M. P. Chipperfield Lancaster Environment Centre, Lancaster University, Lancaster, UK School of Earth and Environment, University of Leeds, Leeds, UK A new modelling tool for the investigation of large-scale behaviour of cirrus clouds has been developed. This combines two existing models, the TOMCAT/SLIMCAT chemistry transport model (nupdate library version 0.80, script mpc346_l) and cirrus parameterisation of Ren and MacKenzie (LACM implementation not versioned). The development process employed a subset of best-practice software engineering and quality assurance processes, selected to be viable for small-scale projects whilst maintaining the same traceability objectives. The application of the software engineering and quality control processes during the development has been shown to be not a great overhead, and their use has been of benefit to the developers as well as the end users of the results. We provide a step-by-step guide to the implementation of traceability tailored to the production of geo-scientific research software, as distinct from commercial and operational software. Our recommendations include: maintaining a living "requirements list"; explicit consideration of unit, integration and acceptance testing; and automated revision/configuration control, including control of analysis tool scripts and programs. <br><br> Initial testing of the resulting model against satellite and in-situ measurements has been promising. The model produces representative results for both spatial distribution of the frequency of occurrence of cirrus ice, and the drying of air as it moves across the tropical tropopause. The model is now ready for more rigorous quantitative testing, but will require the addition of a vertical wind velocity downscaling scheme to better represent extra-tropical continental cirrus. Bouzereau, E., Musson-Genon, L., and Carissimo, B.: On the Definition of the Cloud Water Content Fluctuations and Its Effects on the Computation of a Second-Order Liquid Water Correlation, J. Atmos. Sci., 64(2), 665~pp., 2007. Chipperfield, M. P.: New version of the TOMCAT/SLIMCAT off-line chemical transport model: Intercomparison of stratospheric tracer experiments, Q. J. Roy. Meteor. Soc., 132, 1179~pp., 2006. Crout, N., Tarsitano, D., and Wood, A. T.: Is my model too complex? Evaluating model formulation using model reduction, Environ. Modell. Softw., 24(1), 1–7, 2009. Feng, W., Chipperfield, M. P., Davies, S., Sen, B., Toon, G., Blavier, J. F., Webster, C. R., Volk, C. M., Ulanovsky, A., Ravegnani, F., von der Gathen, P., Jost, H., Richard, E. C., and Claude, H.: Three-dimensional model study of the Arctic ozone loss in 2002/2003 and comparison with 1999/2000 and 2003/2004, Atmos. Chem. Phys., 5, 139–152, 2005. Haag, W. and Kärcher, B.: The impact of aerosols and gravity waves on cirrus clouds at midlatitudes, J. Geophys. Res., 109, D12202, doi:10.1029/2004JD004579, 2004. Hoyle, C. R., Luo, B. P., and Peter, T.: The Origin of High Ice Crystal Number Densities in Cirrus Clouds, J. Atmos. Sci., 62, 2568–2579, 2005. Huo, M., Verner, J., Zhu, L., and Babar, M. A.: Software Quality and Agile Methods, Computer Software and Applications Conference, 2004. COMPSAC 2004. Proceedings of the 28th Annual International, 1, 520–525, 2004. Jakeman, A. J., Letcher, R. A., and Norton, J. P.: Ten iterative steps in development and evaluation of environmental models, Environ. Modell. Softw., 21(5), 602~pp., 2006. Jensen, E. J., Toon, O. B., Pfister, L., and Selkirk, H. B.: Dehydration of the Upper Troposphere and Lower Stratosphere by Subvisible Cirrus Clouds near the Tropical Tropopause, Geophys. Res. Lett., 23(8), 825–828, 1996. Jensen, E. J., Ackerman, A. S., and Smith, J. A.: Can overshooting convection dehydrate the tropical tropopause layer?, J. Geophys. Res., 112, D11209, doi:10.1029/2006JD007943, 2007. Jones, C.: Strategies for managing requirements creep, Computer, 29(6), 92~pp., 1996. Kärcher, B. and Lohmann, U.: A Parameterization of cirrus cloud formation: Homogeneous freezing including effects of aerosol size, J. Geophys. Res., 107(D2), 4010, AAC 9–1, 2002a. Kärcher, B. and Lohmann, U.: A Parameterization of cirrus cloud formation: Homogeneous freezing of supercooled aerosols, J. Geophys. Res., 107(D23), 4698, AAC 4–1, 2002b. Kilbane-Dawe, I., Harris, N. R. P., Pyle, J. A., Lee, A. M., Rex, M., and Chipperfield, M. P.: A comparison of match ozonesonde-derived and 3D model ozone loss rates in the Arctic polar vortex during the winters of 1994/95 and 1995/96, J. Atmos. Chem., 39(2), 123–138, 2001. Kley, D., Russell, J. M., and Phillips, C.: SPARC Assessment of Upper Tropospheric and Stratospheric Water Vapour, SPARC Report No 2, Stratospheric Processes and Their Role in Climate (SPARC) project of the World Climate Research Programme, 312~pp., avail1able at http://www.atmosp.physics.utoronto.ca/SPARC/WAVASFINAL_000206/WWW_wavas/Cover.html, December 2000. Krug, E. G., Kresnow, M.-J., Peddicord, J. P., Dahlberg, L. L., Powell, K. E., Crosby, A. E. and Annest, J. L., Suicide after natural disasters, New Engl. J. Med., 338(6), 373–378, 1998. Krug, E. G., Kresnow, M.-J., Peddicord, J. P., Dahlberg, L. L., Powell, K. E., Crosby, A. E., and Annest, J. L.: Retraction: Suicide after natural disasters, New Engl. J. Med., 340(2), 148–149, 1999. Lin, R.-F., Starr, D. O'C., Demott, P. J., Cotton, R., Sassen, K., Kärcher, B., Jensen, E., and Liu, X.: Cirrus Parcel Model Comparison Project. Phase~1: The Critical Components to Simulate Cirrus Initiation Explicitly, J. Atmos. Sci., 59(15), 2305–2329, 2002. Liou, K. N.: Influence of Cirrus Clouds on Weather and Climate Processes: A Global Perspective, Mon. Weather Rev., 114, 1167–1199, 1986. Liu, X. and Penner, J. E.: Ice nucleation parameterization for global models, Meteorol. Z., 14(4), 499–514, 2005. Liu, X., Penner, J. E., Ghan, S. J. and Wang, M., Inclusion of Ice Microphysics in the NCAR Community Atmospheric Model Version 3 (CAM3), J. Climate, 20(18), 4526~pp., 2007. Lohmann, U., Feichter, J., and Chuang, C. C.: Prediction of the number of cloud droplets in the ECHAM GCM, J. Geophys. Res., 104(D8), 9169–9198, 1999. Lohmann, U., Feichter, J., and Chuang, C. C.: Correction to "Prediction of the number of cloud droplets in the ECHAM GCM", J. Geophys. Res., 104(D20), 24557–24563, 1999. Lohmann, U. and Kärcher, B.: First interactive simulations of cirrus clouds formed by homogeneous freezing in the ECHAM general circulation model, J. Geophys. Res., 107(D10), AAC 8–1, 2002. Lohmann, U., Spichtinger, P., Jess, S., Peter, T., and Smit, H.: Cirrus cloud formation and ice supersaturated regions in a global climate model, Environ. Res. Lett., 3(4), 045022~pp., 2008. Luo, B. P., Peter, T., Fueglistaler, S., Wernli, H., Wirth, M., Kiemle, C., Flentje, H., Yushkov, V. A., Khattatov, V., Rudakov, V., Thomas, A., Borrmann, S., Toci, G., Mazzinghi, P., Beuermann, J., Schiller, C., Cairo, F., DiDonfrancesco, G., Adriani, A., Volk, C. M., Strom, J., Noone, K., Mitev, V., MacKenzie, A. R., Carslaw, K. S., Trautmann, T., Santacesaria, V., and Stefanutti, L.: Dehydration potential of ultrathin clouds at the tropical tropopause, Geophys. Res. Lett., 30(11), 1557~pp., 2003. Lynch, D. K.: Cirrus clouds: Their role in climate and global change, Acta Astronaut., 38(11), 859–863, 1996. Lynch, D. K.: Cirrus, 1st edn., Oxford University Press, 2002. MacKenzie, A. R., Kroger, C., Schiller, C., Beuermann, J., Bujok, O., Gensch, I., Kramer, M., Rohs, S., Peter, T., Corti, T., Adriani, A., Cairo, F., DiDonfrancesco, G., Kiemle, C., Merkulov, S., Oulanovsky, A., Rudakov, V., Yushkov, V., Ravegnani, F., Salter, P., Santacesaria, V., and Stefanutti, L.: Tropopause and hygropause variability over the equatorial Indian Ocean during February and March 1999, J. Geophy. Res., 111, D18112, doi:10.1029/2005JD006639, 2006. Marti, J. and Mauersberger, K.: A survey and new measurements of ice vapor pressure at temperatures between 170 and 250 K, Geophys. Res. Lett., 20(5), 363–366, 1993. Meerkötter, R., Schumann, U., Doelling, D. R., Minnis, P., Nakajima, T., and Tsushima, Y.: Radiative forcing by contrails, Ann. Geophys., 17, 1080–1094, 1999. Murphy, D. M. and Koop, T.: Review of the vapour pressures of ice and supercooled water for atmospheric applications, Q. J. Roy. Meteor. Soc., 131, 1539–1565, 2005. Nof, D.: Simple Versus Complex Climate Modeling, EOS T. Am. Geophys. Un., 89(52), 544–545, 2008. Petty, G. W.: A First Course in Atmospheric Radiation, Sundog Publishing, Madison, Wisconsin, USA, 2004. Prather, M. J.: Numerical Advection by Conservation of Second Order Moments, J. Geophys. Res., 91(D6), 6671–6681, 1986. Pruppacher, H. R. and Klett, J. D.: Microphysics of Clouds and Precipitation, 2nd edn., Kluwer Academic Publishers, Dordrecht, 1998. Ren, C. and MacKenzie, A. R.: Cirrus Parameterisation and the Role of Ice Nuclei, Q. J. Roy. Meteor. Soc., 131, 1585–1605, 2005. Ren, C., MacKenzie, A. R., Schiller, C., Shur, G., and Yushkov, V.: Diagnosis of processes controlling water vapour in the tropical tropopause layer by a Lagrangian cirrus model, Atmos. Chem. Phys., 7, 5401–5413, 2007. Risbey, J., Kandlikar, M., and Patwardhan, A.: Assessing Integrated Assessments, Climatic Change, 34(3–4), 369–395, 1996. Robinson, G. D.: The transport of minor atmospheric constituents between troposphere and stratosphere, Q. J. Roy. Meteor. Soc, 106(448), 227–253, 1980. Rossow, W. B. and Schiffer, R. A.: Advances in Understanding Clouds from ISCCP, B. Am. Meteorol. Soc., 80, 2261–2288, 1999. Santacesaria, V., Carla, R., MacKenzie, A. R., Adriani, A., Cairo, F., DiDonfrancesco, G., Kiemle, C., Redaelli, G., Beuermann, J., Schiller, C., Peter, T., Luo, B., Wernli, H., Ravegnani, F., Ulanovsky, A., Yushkov, V., Sitnikov, N., Balestri, S., and Stefanutti, L.: Clouds at the tropical tropopause: A case study during the APE-THESEO campaign over the western Indian Ocean, J. Geophys. Res., 108(D2), 4044, AAC 1–1, doi:10.1029/2002JD002166, 2003. Sassen, K. and Cho, B. S.: Subvisual-thin cirrus lidar dataset for satellite verification and climatological research, J. Appl. Meteorol., 31(11), 1275–1285, 1992. Schiller, C., Grooß, J.-U., Konopka, P., Plöger, F., Silva dos Santos, F. H., and Spelten, N.: Hydration and dehydration at the tropical tropopause, Atmos. Chem. Phys. Discuss., 9, 17495–17529, 2009. Sherwood, S. C. and Dessler, A. E.: On the control of stratospheric humidity, Geophys. Res. Lett., 27(16), 2513–2516, 2000. Stephens, G. L.: Radiation Profiles in Extended Water Clouds~II: Parameterization Schemes, J. Atmos. Sci., 35, 2123–2132, 1978. Stephens, G. L. and Kummerow, C. D.: The Remote Sensing of Clouds and Precipitation from Space: A Review, J. Atmos. Sci., 6411, 3742~pp., 2007. Storelvmo, T., Kristjánsson, J. E., Lohmann, U., Iversen, T., Kirkev\aa g, A., and Seland, \O.: Modeling of the Wegener-Bergeron-Findeisen process – implications for aerosol indirect effects, Environ. Res. Lett., 3(4), 045001~ pp., 2008. Timmermann, R. and Beckmann, A.: Parameterization of vertical mixing in the Weddell Sea, Ocean Model., 6(1), 83~pp., 2004. Timmermann, R. and Losch, M.: Using the Mellor-Yamada mixing scheme in seasonally ice-covered seas – Corrigendum to: Parameterization of vertical mixing in the Weddell Sea [Ocean Model., 6(2004), 83–100], Ocean Model., 10(3–4), 369–372, 2005. Tompkins, A. M., Gierens, K., and Rädel, G.: Ice supersaturation in the ECMWF integrated forecast system, Q. J. Roy. Meteor. Soc., 133(622), 53~pp., 2007. Uppala, S. M., K&aring;llberg, P. W., Simmons, A. J., Andrae, U., da Costa Bechtold, V., Fiorino, M., Gibson, J. K., Haseler, J., Hernandez, A., Kelly, G. A., Li, X., Onogi, K., Saarinen, S., Sokka, N., Allan, R. P., Andersson, E., Arpe, K., Balmaseda, M. A., Beljaars, A. C. M., Van De Berg, L., Bidlot, J., Bormann, N., Caires, S., Chevallier, F., Dethof, A., Dragosavac, M., Fisher, M., Fuentes, M., Hagemann, S., Hólm, E., Hoskins, B. J., Isaksen, L., Janssen, P. A. E. M., Jenne, R., McNally, A. P., Mahfouf, J.-F., Morcrette, J.-J., Rayner, N. A., Saunders, R. W., Simon, P., Sterl, A., Trenberth, K. E., Untch, A., Vasiljevic, D., Viterbo, P., and Woollen, J.: The ERA-40 re-analysis, Q. J. Roy. Meteor. Soc., 131(612), 2961~pp., 2005. Vaughan, G., Schiller, C., MacKenzie, A. R., Bower, K., Peter, T., Schlager, H., Harris, N. R. P., and May, P. T.: SCOUT-O3/ACTIVE: High-altitude aircraft measurements around deep tropical convection, B. Am. Meteorol. Soc., 89(5), 647–662, 2008. Weaver, C. J., Douglass, A. R., and Rood, R. B.: Thermodynamic Balance fo Three-Dimensional Stratospheric Winds Derived from a Data Assimilation Procedure, J. Atmos. Sci., 5(17), 2987–2993, 1993. Windle, D. R. and Abreo, L. R.: Software requirements using the unified process: a practical approach, Prentice Hall Ptr, 2002. Yu, T-T., Rundle, J. B., and Fernandez, J.: Corrigendum to "Deformation produced by a rectangular dipping fault in a viscoelastic-gravitational layered earth model. Part II: strike-slip fault FSTRGRV and STRGRH FORTRAN programs", Comput. Geosci., 28, 89–91, 2002. Zhang, Y., Macke, A. and Albers, F., Effect of crystal size spectrum and crystal shape on stratiform cirrus radiative forcing, Atmos. Res., 52, 59–75, 1999. Zhang, Z., Yang, P., Kattawar, G., Riedi, J., C.-Labonnote, L., Baum, B. A., Platnick, S., and Huang, H.-L.: Influence of ice particle model on satellite ice cloud retrieval: lessons learned from MODIS and POLDER cloud product comparison, Atmos. Chem. Phys., 9, 7115–7129, 2009.