The Variable Infiltration Capacity model version 5 (VIC-5): infrastructure improvements for new applications and reproducibility

Abstract. The Variable Infiltration Capacity (VIC) model is a macroscale semi-distributed hydrologic model. VIC development began in the early 1990s and the model has since been used extensively for basin- to global-scale applications that include hydrologic dataset construction, trend analysis of hydrologic fluxes and states, data evaluation and assimilation, forecasting, coupled climate modeling, and climate change impact assessment. Ongoing operational applications of the VIC model include the University of Washington's drought monitoring and forecasting systems and NASA's Land Data Assimilation System. This paper documents the development of VIC version 5 (VIC-5), which includes a major reconfiguration of the legacy VIC source code to support a wider range of modern hydrologic modeling applications. The VIC source code has been moved to a public GitHub repository to encourage participation by the broader user and developer communities. The reconfiguration has separated the core physics of the model from the driver source code, whereby the latter is responsible for memory allocation, preprocessing and post-processing, and input–output (I–O). VIC-5 includes four drivers that use the same core physics modules, but which allow for different methods for accessing this core to enable different model applications. Finally, VIC-5 is distributed with robust test infrastructure, components of which routinely run during development using cloud-hosted continuous integration. The work described here provides an example to the model development community for extending the life of a legacy model that is being used extensively. The development and release of VIC-5 represents a significant step forward for the VIC user community in terms of support for existing and new model applications, reproducibility, and scientific robustness.

[1]  D. Lettenmaier,et al.  Assimilating remotely sensed snow observations into a macroscale hydrology model , 2006 .

[2]  Rolf Hut,et al.  Comment on “Most computational hydrology is not reproducible, so is it really science?” by Christopher Hutton et al.: Let hydrologists learn the latest computer science by working with Research Software Engineers (RSEs) and not reinvent the waterwheel ourselves , 2017 .

[3]  D. Lettenmaier,et al.  Effects of 20th century warming and climate variability on flood risk in the western U.S. , 2006 .

[4]  Thorsten Wagener,et al.  Reply to comment by Añel on “Most computational hydrology is not reproducible, so is it really science?”: REPLY TO COMMENT BY AÑEL , 2017 .

[5]  J. Abatzoglou,et al.  Effects of climate change on snowpack and fire potential in the western USA , 2017, Climatic Change.

[6]  Rolf Hut,et al.  Let hydrologists learn the latest computer science by working with Research Software Engineers (RSEs) and not reinvent the waterwheel ourselves. A comment to “Most Computational Hydrology is not Reproducible, so is it Really Science?” , 2017 .

[7]  Dennis P. Lettenmaier,et al.  Variable infiltration capacity cold land process model updates , 2003 .

[8]  W. Oechel,et al.  FLUXNET: A New Tool to Study the Temporal and Spatial Variability of Ecosystem-Scale Carbon Dioxide, Water Vapor, and Energy Flux Densities , 2001 .

[9]  Arun Kumar,et al.  Long‐range experimental hydrologic forecasting for the eastern United States , 2002 .

[10]  Eric F. Wood,et al.  Global and Continental Drought in the Second Half of the Twentieth Century: Severity–Area–Duration Analysis and Temporal Variability of Large-Scale Events , 2009 .

[11]  Enrique R. Vivoni,et al.  Process‐based characterization of evapotranspiration sources over the North American monsoon region , 2016 .

[12]  G. Powers,et al.  A Description of the Advanced Research WRF Version 3 , 2008 .

[13]  E. Wood,et al.  Global Trends and Variability in Soil Moisture and Drought Characteristics, 1950–2000, from Observation-Driven Simulations of the Terrestrial Hydrologic Cycle , 2008 .

[14]  Zong-Liang Yang,et al.  The Project for Intercomparison of Land-surface Parameterization Schemes (PILPS) Phase 2(c) Red–Arkansas River basin experiment:: 1. Experiment description and summary intercomparisons , 1998 .

[15]  Juan A. Añel,et al.  Comment on “Most computational hydrology is not reproducible, so is it really science?” by Christopher Hutton et al. , 2017 .

[16]  D. Lettenmaier,et al.  Streamflow simulation for continental‐scale river basins , 1997 .

[17]  Eric F. Wood,et al.  Modeling ground heat flux in land surface parameterization schemes , 1999 .

[18]  E. Wood,et al.  Characteristics of global and regional drought, 1950–2000: Analysis of soil moisture data from off‐line simulation of the terrestrial hydrologic cycle , 2007 .

[19]  Faisal Hossain,et al.  How Much Can A Priori Hydrologic Model Predictability Help in Optimal Merging of Satellite Precipitation Products , 2011 .

[20]  Eric F. Wood,et al.  One-dimensional statistical dynamic representation of subgrid spatial variability of precipitation in the two-layer variable infiltration capacity model , 1996 .

[21]  S. Running,et al.  Global evaluation of MTCLIM and related algorithms for forcing of ecological and hydrological models , 2013 .

[22]  Dennis P. Lettenmaier,et al.  Soil Moisture Drought in China, 1950–2006 , 2011 .

[23]  Steven W. Running,et al.  Strategies for measuring and modelling carbon dioxide and water vapour fluxes over terrestrial ecosystems , 1996 .

[24]  Balaji Rajagopalan,et al.  Are we unnecessarily constraining the agility of complex process‐based models? , 2015 .

[25]  D. Lettenmaier,et al.  Evaluation of the land surface water budget in NCEP/NCAR and NCEP/DOE reanalyses using an off‐line hydrologic model , 2001 .

[26]  D. Mocko,et al.  Simulation of high-latitude hydrological processes in the Torne-Kalix basin: PILPS phase 2(e) - 1: Experiment description and summary intercomparisons , 2003 .

[27]  R. Dickinson,et al.  The Project for Intercomparison of Land Surface Parameterization Schemes (PILPS): Phases 2 and 3 , 1993 .

[28]  E. Wood,et al.  Data Assimilation for Estimating the Terrestrial Water Budget Using a Constrained Ensemble Kalman Filter , 2006 .

[29]  Eric F. Wood,et al.  Predicting the Discharge of Global Rivers , 2001, Journal of Climate.

[30]  Dennis P. Lettenmaier,et al.  Drought Monitoring for Washington State: Indicators and Applications , 2011 .

[31]  Martyn P. Clark,et al.  DECLINING MOUNTAIN SNOWPACK IN WESTERN NORTH AMERICA , 2005 .

[32]  Joseph Hamman,et al.  The coastal streamflow flux in the Regional Arctic System Model , 2017 .

[33]  E. Wood,et al.  Development of a 50-Year High-Resolution Global Dataset of Meteorological Forcings for Land Surface Modeling , 2006 .

[34]  Philippe Ciais,et al.  A framework for benchmarking land models , 2012 .

[35]  D. Lettenmaier,et al.  Application of New Precipitation and Reconstructed Streamflow Products to Streamflow Trend Attribution in Northern Eurasia , 2008 .

[36]  Dennis P. Lettenmaier,et al.  A multimodel ensemble approach to assessment of climate change impacts on the hydrology and water resources of the Colorado River Basin , 2006 .

[37]  Christopher Hutton,et al.  Most computational hydrology is not reproducible, so is it really science? , 2016, Water Resources Research.

[38]  Dennis P. Lettenmaier,et al.  Effects of irrigation on the water and energy balances of the Colorado and Mekong river basins , 2006 .

[39]  E. Wood,et al.  The role of initial conditions and forcing uncertainties in seasonal hydrologic forecasting , 2009 .

[40]  Jay Walter Larson,et al.  The Model Coupling Toolkit: A New Fortran90 Toolkit for Building Multiphysics Parallel Coupled Models , 2005, Int. J. High Perform. Comput. Appl..

[41]  D. Lettenmaier,et al.  Effects of land cover change on streamflow in the interior Columbia River Basin (USA and Canada) , 2000 .

[42]  Bart Nijssen,et al.  BioEarth: Envisioning and developing a new regional earth system model to inform natural and agricultural resource management , 2014, Climatic Change.

[43]  Dennis P. Lettenmaier,et al.  Parameterization of Blowing-Snow Sublimation in a Macroscale Hydrology Model , 2004 .

[44]  E. Wood,et al.  A Drought Monitoring and Forecasting System for Sub-Sahara African Water Resources and Food Security , 2014 .

[45]  Darrel C. Ince,et al.  The case for open computer programs , 2012, Nature.

[46]  Dennis P. Lettenmaier,et al.  Modeling the Effects of Lakes and Wetlands on the Water Balance of Arctic Environments , 2010 .

[47]  Eric F. Wood,et al.  Assessing the skill of satellite‐based precipitation estimates in hydrologic applications , 2010 .

[48]  D. Lettenmaier,et al.  Change in spring snowmelt timing in Eurasian Arctic rivers , 2011 .

[49]  Russ Rew,et al.  NetCDF: an interface for scientific data access , 1990, IEEE Computer Graphics and Applications.

[50]  L. Dagum,et al.  OpenMP: an industry standard API for shared-memory programming , 1998 .

[51]  W. Collins,et al.  The Community Earth System Model: A Framework for Collaborative Research , 2013 .

[52]  Felipe J. Colón-González,et al.  Multimodel assessment of water scarcity under climate change , 2013, Proceedings of the National Academy of Sciences.

[53]  D. Lettenmaier,et al.  Streamflow simulations of the terrestrial Arctic domain , 2005 .

[54]  J. Cassano,et al.  Land Surface Climate in the Regional Arctic System Model , 2016 .

[55]  Martyn P. Clark,et al.  Effects of Temperature and Precipitation Variability on Snowpack Trends in the Western United States , 2005 .

[56]  T. Barnett,et al.  Potential impacts of a warming climate on water availability in snow-dominated regions , 2005, Nature.

[57]  D. Lettenmaier,et al.  A Long-Term Hydrologically Based Dataset of Land Surface Fluxes and States for the Conterminous United States* , 2002 .

[58]  Sujay V. Kumar,et al.  Land information system: An interoperable framework for high resolution land surface modeling , 2006, Environ. Model. Softw..

[59]  Yang Hong,et al.  Evaluation of TRMM Multisatellite Precipitation Analysis (TMPA) and Its Utility in Hydrologic Prediction in the La Plata Basin , 2008 .

[60]  Mariana Vertenstein,et al.  A new flexible coupler for earth system modeling developed for CCSM4 and CESM1 , 2012, Int. J. High Perform. Comput. Appl..

[61]  Dag Lohmann,et al.  A large‐scale horizontal routing model to be coupled to land surface parametrization schemes , 1996 .

[62]  D. Cayan,et al.  A spatially comprehensive, hydrometeorological data set for Mexico, the U.S., and Southern Canada 1950–2013 , 2015, Scientific Data.

[63]  Dennis P. Lettenmaier,et al.  Evaluating the Influence of Antecedent Soil Moisture on Variability of the North American Monsoon Precipitation in the Coupled MM5/VIC Modeling System , 2009 .

[64]  P. Mote,et al.  Twentieth-Century Trends in Runoff, Evapotranspiration, and Soil Moisture in the Western United States* , 2007 .

[65]  Michael N. Fienen,et al.  HESS Opinions: Repeatable research: what hydrologists can learn from the Duke cancer research scandal , 2016 .

[66]  Eric F. Wood,et al.  A Prototype Global Drought Information System Based on Multiple Land Surface Models , 2014 .

[67]  Ian M. Mitchell,et al.  Best Practices for Scientific Computing , 2012, PLoS biology.

[69]  D. Lettenmaier,et al.  A simple hydrologically based model of land surface water and energy fluxes for general circulation models , 1994 .

[70]  Dennis P. Lettenmaier,et al.  Hydrologic effects of frozen soils in the upper Mississippi River basin , 1999 .

[71]  Bart Nijssen,et al.  Effect of precipitation sampling error on simulated hydrological fluxes and states: Anticipating the Global Precipitation Measurement satellites , 2004 .

[72]  Suzanne A. Pierce,et al.  Toward the Geoscience Paper of the Future: Best practices for documenting and sharing research from data to software to provenance , 2016 .

[73]  Bart Nijssen,et al.  Global Retrospective Estimation of Soil Moisture Using the Variable Infiltration Capacity Land Surface Model, 1980–93 , 2001 .

[74]  Göran Lindström,et al.  Virtual laboratories: new opportunities for collaborative water science , 2014, Hydrology and Earth System Sciences.

[75]  D. Lettenmaier,et al.  Evaluating climate change over the Colorado River basin using regional climate models , 2011 .

[76]  Remko Uijlenhoet,et al.  Comment on “Most computational hydrology is not reproducible, so is it really science?” by Christopher Hutton et al. , 2017 .

[77]  Dennis P. Lettenmaier,et al.  EFFECTS OF CLIMATE CHANGE ON HYDROLOGY AND WATER RESOURCES IN THE COLUMBIA RIVER BASIN 1 , 1999 .

[78]  D. Cayan,et al.  The importance of warm season warming to western U.S. streamflow changes , 2011 .

[79]  D. Lettenmaier,et al.  The role of surface energy fluxes in pan-Arctic snow cover changes , 2011 .

[80]  Dennis P. Lettenmaier,et al.  Hydrologic impacts of climate change on the Nile River Basin: implications of the 2007 IPCC scenarios , 2010 .

[81]  S. Running,et al.  An improved algorithm for estimating incident daily solar radiation from measurements of temperature, humidity, and precipitation , 1999 .

[82]  Dennis P. Lettenmaier,et al.  Modeling snow accumulation and ablation processes in forested environments , 2009 .

[83]  D. Lettenmaier,et al.  Hydrologic Sensitivity of Global Rivers to Climate Change , 2001 .

[84]  Dennis P. Lettenmaier,et al.  Predictability of seasonal runoff in the Mississippi River basin , 2003 .

[85]  M. Wigmosta,et al.  A distributed hydrology-vegetation model for complex terrain , 1994 .

[86]  Dennis P. Lettenmaier,et al.  Application of regional parameter estimation schemes to simulate the water balance of a large continental river , 1997 .

[87]  Anthony Skjellum,et al.  A High-Performance, Portable Implementation of the MPI Message Passing Interface Standard , 1996, Parallel Comput..