skip to main content
DOE PAGES title logo U.S. Department of Energy
Office of Scientific and Technical Information

Title: 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 routinelymore » 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.« less

Authors:
ORCiD logo [1]; ORCiD logo [2];  [3];  [2];  [2]
  1. Univ. of Washington, Seattle, WA (United States); National Center for Atmospheric Research, Boulder, CO (United States)
  2. Univ. of Washington, Seattle, WA (United States)
  3. Arizona State Univ., Tempe, AZ (United States)
Publication Date:
Research Org.:
Univ. of Washington, Seattle, WA (United States)
Sponsoring Org.:
National Science Foundation (NSF), Science, Engineering, and Education for Sustainability (SEES); Air Force Research Lab. (AFRL); Army Engineer Research and Development Center (ERDC); USDOE Office of Science (SC), Biological and Environmental Research (BER) (SC-23)
OSTI Identifier:
1511030
Grant/Contract Number:  
[FG02-07ER64460; SC0006856; 1216037]
Resource Type:
Accepted Manuscript
Journal Name:
Geoscientific Model Development (Online)
Additional Journal Information:
[Journal Name: Geoscientific Model Development (Online); Journal Volume: 11; Journal Issue: 8]; Journal ID: ISSN 1991-9603
Publisher:
European Geosciences Union
Country of Publication:
United States
Language:
English
Subject:
42 ENGINEERING

Citation Formats

Hamman, Joseph J., Nijssen, Bart, Bohn, Theodore J., Gergel, Diana R., and Mao, Yixin. The Variable Infiltration Capacity model version 5 (VIC-5): infrastructure improvements for new applications and reproducibility. United States: N. p., 2018. Web. doi:10.5194/gmd-11-3481-2018.
Hamman, Joseph J., Nijssen, Bart, Bohn, Theodore J., Gergel, Diana R., & Mao, Yixin. The Variable Infiltration Capacity model version 5 (VIC-5): infrastructure improvements for new applications and reproducibility. United States. doi:10.5194/gmd-11-3481-2018.
Hamman, Joseph J., Nijssen, Bart, Bohn, Theodore J., Gergel, Diana R., and Mao, Yixin. Thu . "The Variable Infiltration Capacity model version 5 (VIC-5): infrastructure improvements for new applications and reproducibility". United States. doi:10.5194/gmd-11-3481-2018. https://www.osti.gov/servlets/purl/1511030.
@article{osti_1511030,
title = {The Variable Infiltration Capacity model version 5 (VIC-5): infrastructure improvements for new applications and reproducibility},
author = {Hamman, Joseph J. and Nijssen, Bart and Bohn, Theodore J. and Gergel, Diana R. and Mao, Yixin},
abstractNote = {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.},
doi = {10.5194/gmd-11-3481-2018},
journal = {Geoscientific Model Development (Online)},
number = [8],
volume = [11],
place = {United States},
year = {2018},
month = {8}
}

Journal Article:
Free Publicly Available Full Text
Publisher's Version of Record

Citation Metrics:
Cited by: 13 works
Citation information provided by
Web of Science

Save / Share:

Works referenced in this record:

Application of regional parameter estimation schemes to simulate the water balance of a large continental river
journal, October 1997


Application of New Precipitation and Reconstructed Streamflow Products to Streamflow Trend Attribution in Northern Eurasia
journal, April 2008


BioEarth: Envisioning and developing a new regional earth system model to inform natural and agricultural resource management
journal, April 2014

  • Adam, Jennifer C.; Stephens, Jennie C.; Chung, Serena H.
  • Climatic Change, Vol. 129, Issue 3-4
  • DOI: 10.1007/s10584-014-1115-2

Assimilating remotely sensed snow observations into a macroscale hydrology model
journal, June 2006


Modeling snow accumulation and ablation processes in forested environments: VIC SNOW MODEL
journal, May 2009

  • Andreadis, Konstantinos M.; Storck, Pascal; Lettenmaier, Dennis P.
  • Water Resources Research, Vol. 45, Issue 5
  • DOI: 10.1029/2008WR007042

Strategies for measuring and modelling carbon dioxide and water vapour fluxes over terrestrial ecosystems
journal, June 1996


Potential impacts of a warming climate on water availability in snow-dominated regions
journal, November 2005

  • Barnett, T. P.; Adam, J. C.; Lettenmaier, D. P.
  • Nature, Vol. 438, Issue 7066
  • DOI: 10.1038/nature04141

Hydrologic impacts of climate change on the Nile River Basin: implications of the 2007 IPCC scenarios
journal, October 2009


Process‐based characterization of evapotranspiration sources over the North American monsoon region
journal, January 2016

  • Bohn, Theodore J.; Vivoni, Enrique R.
  • Water Resources Research, Vol. 52, Issue 1
  • DOI: 10.1002/2015WR017934

Global evaluation of MTCLIM and related algorithms for forcing of ecological and hydrological models
journal, July 2013


Modeling the Effects of Lakes and Wetlands on the Water Balance of Arctic Environments
journal, April 2010

  • Bowling, Laura C.; Lettenmaier, Dennis P.
  • Journal of Hydrometeorology, Vol. 11, Issue 2
  • DOI: 10.1175/2009JHM1084.1

Simulation of high-latitude hydrological processes in the Torne–Kalix basin: PILPS Phase 2(e)
journal, July 2003


Virtual laboratories: new opportunities for collaborative water science
journal, January 2015


Hydrologic effects of frozen soils in the upper Mississippi River basin
journal, August 1999

  • Cherkauer, Keith A.; Lettenmaier, Dennis P.
  • Journal of Geophysical Research: Atmospheres, Vol. 104, Issue D16
  • DOI: 10.1029/1999JD900337

Variable infiltration capacity cold land process model updates
journal, July 2003

  • Cherkauer, Keith A.; Bowling, Laura C.; Lettenmaier, Dennis P.
  • Global and Planetary Change, Vol. 38, Issue 1-2
  • DOI: 10.1016/S0921-8181(03)00025-0

A multimodel ensemble approach to assessment of climate change impacts on the hydrology and water resources of the Colorado River Basin
journal, January 2007

  • Christensen, N. S.; Lettenmaier, D. P.
  • Hydrology and Earth System Sciences, Vol. 11, Issue 4
  • DOI: 10.5194/hess-11-1417-2007

A new flexible coupler for earth system modeling developed for CCSM4 and CESM1
journal, November 2011

  • Craig, Anthony P.; Vertenstein, Mariana; Jacob, Robert
  • The International Journal of High Performance Computing Applications, Vol. 26, Issue 1
  • DOI: 10.1177/1094342011428141

OpenMP: an industry standard API for shared-memory programming
journal, January 1998

  • Dagum, L.; Menon, R.
  • IEEE Computational Science and Engineering, Vol. 5, Issue 1
  • DOI: 10.1109/99.660313

The importance of warm season warming to western U.S. streamflow changes: WARM SEASON WARMING STREAMFLOW CHANGES
journal, December 2011

  • Das, Tapash; Pierce, David W.; Cayan, Daniel R.
  • Geophysical Research Letters, Vol. 38, Issue 23
  • DOI: 10.1029/2011GL049660

HESS Opinions: Repeatable research: what hydrologists can learn from the Duke cancer research scandal
journal, January 2016


Evaluating climate change over the Colorado River basin using regional climate models
journal, January 2011

  • Gao, Yanhong; Vano, Julie A.; Zhu, Chunmei
  • Journal of Geophysical Research, Vol. 116, Issue D13
  • DOI: 10.1029/2010JD015278

How Much Can A Priori Hydrologic Model Predictability Help in Optimal Merging of Satellite Precipitation Products?
journal, December 2011


Effects of climate change on snowpack and fire potential in the western USA
journal, February 2017


Toward the Geoscience Paper of the Future: Best practices for documenting and sharing research from data to software to provenance
journal, October 2016

  • Gil, Yolanda; David, Cédric H.; Demir, Ibrahim
  • Earth and Space Science, Vol. 3, Issue 10
  • DOI: 10.1002/2015EA000136

A high-performance, portable implementation of the MPI message passing interface standard
journal, September 1996


Effects of irrigation on the water and energy balances of the Colorado and Mekong river basins
journal, June 2006


Effects of Climate Change on Hydrology and Water Resources in the Columbia River Basin
journal, December 1999


Effects of 20th century warming and climate variability on flood risk in the western U.S.: EFFECTS OF 20TH CENTURY WARMING ON FLOOD
journal, June 2007

  • Hamlet, Alan F.; Lettenmaier, Dennis P.
  • Water Resources Research, Vol. 43, Issue 6
  • DOI: 10.1029/2006WR005099

Effects of Temperature and Precipitation Variability on Snowpack Trends in the Western United States
journal, November 2005

  • Hamlet, Alan F.; Mote, Philip W.; Clark, Martyn P.
  • Journal of Climate, Vol. 18, Issue 21
  • DOI: 10.1175/JCLI3538.1

Twentieth-Century Trends in Runoff, Evapotranspiration, and Soil Moisture in the Western United States
journal, April 2007

  • Hamlet, Alan F.; Mote, Philip W.; Clark, Martyn P.
  • Journal of Climate, Vol. 20, Issue 8
  • DOI: 10.1175/JCLI4051.1

Land Surface Climate in the Regional Arctic System Model
journal, September 2016


The coastal streamflow flux in the Regional Arctic System Model: COASTAL STREAMFLOW FLUX IN RASM
journal, March 2017

  • Hamman, Joseph; Nijssen, Bart; Roberts, Andrew
  • Journal of Geophysical Research: Oceans, Vol. 122, Issue 3
  • DOI: 10.1002/2016JC012323

The Community Earth System Model: A Framework for Collaborative Research
journal, September 2013

  • Hurrell, James W.; Holland, M. M.; Gent, P. R.
  • Bulletin of the American Meteorological Society, Vol. 94, Issue 9
  • DOI: 10.1175/BAMS-D-12-00121.1

Most computational hydrology is not reproducible, so is it really science?: REPRODUCIBLE COMPUTATIONAL HYDROLOGY
journal, October 2016

  • Hutton, Christopher; Wagener, Thorsten; Freer, Jim
  • Water Resources Research, Vol. 52, Issue 10
  • DOI: 10.1002/2016WR019285

Reply to comment by Melsen et al. on “Most computational hydrology is not reproducible, so is it really science?”: REPLY TO COMMENT BY MELSEN ET AL.
journal, March 2017

  • Hutton, Christopher; Wagener, Thorsten; Freer, Jim
  • Water Resources Research, Vol. 53, Issue 3
  • DOI: 10.1002/2017WR020476

Reply to comment by Añel on “Most computational hydrology is not reproducible, so is it really science?”: REPLY TO COMMENT BY AÑEL
journal, March 2017

  • Hutton, Christopher; Wagener, Thorsten; Freer, Jim
  • Water Resources Research, Vol. 53, Issue 3
  • DOI: 10.1002/2017WR020480

The case for open computer programs
journal, February 2012

  • Ince, Darrel C.; Hatton, Leslie; Graham-Cumming, John
  • Nature, Vol. 482, Issue 7386
  • DOI: 10.1038/nature10836

Land information system: An interoperable framework for high resolution land surface modeling
journal, October 2006


The Model Coupling Toolkit: A New Fortran90 Toolkit for Building Multiphysics Parallel Coupled Models
journal, August 2005

  • Larson, Jay; Jacob, Robert; Ong, Everest
  • The International Journal of High Performance Computing Applications, Vol. 19, Issue 3
  • DOI: 10.1177/1094342005056115

The role of initial conditions and forcing uncertainties in seasonal hydrologic forecasting
journal, January 2009

  • Li, Haibin; Luo, Lifeng; Wood, Eric F.
  • Journal of Geophysical Research, Vol. 114, Issue D4
  • DOI: 10.1029/2008JD010969

A simple hydrologically based model of land surface water and energy fluxes for general circulation models
journal, January 1994

  • Liang, Xu; Lettenmaier, Dennis P.; Wood, Eric F.
  • Journal of Geophysical Research, Vol. 99, Issue D7
  • DOI: 10.1029/94JD00483

One-dimensional statistical dynamic representation of subgrid spatial variability of precipitation in the two-layer variable infiltration capacity model
journal, September 1996

  • Liang, Xu; Lettenmaier, Dennis P.; Wood, Eric F.
  • Journal of Geophysical Research: Atmospheres, Vol. 101, Issue D16
  • DOI: 10.1029/96JD01448

Modeling ground heat flux in land surface parameterization schemes
journal, April 1999

  • Liang, Xu; Wood, Eric F.; Lettenmaier, Dennis P.
  • Journal of Geophysical Research: Atmospheres, Vol. 104, Issue D8
  • DOI: 10.1029/98JD02307

A spatially comprehensive, hydrometeorological data set for Mexico, the U.S., and Southern Canada 1950–2013
journal, August 2015

  • Livneh, Ben; Bohn, Theodore J.; Pierce, David W.
  • Scientific Data, Vol. 2, Issue 1
  • DOI: 10.1038/sdata.2015.42

A large-scale horizontal routing model to be coupled to land surface parametrization schemes
journal, October 1996


A framework for benchmarking land models
journal, January 2012


Effects of land cover change on streamflow in the interior Columbia River Basin (USA and Canada)
journal, April 2000


Predictability of seasonal runoff in the Mississippi River basin
journal, January 2003


Evaluation of the land surface water budget in NCEP/NCAR and NCEP/DOE reanalyses using an off-line hydrologic model
journal, August 2001

  • Maurer, Edwin P.; O'Donnell, Greg M.; Lettenmaier, Dennis P.
  • Journal of Geophysical Research: Atmospheres, Vol. 106, Issue D16
  • DOI: 10.1029/2000JD900828

A Long-Term Hydrologically Based Dataset of Land Surface Fluxes and States for the Conterminous United States*
journal, November 2002


Comment on “Most computational hydrology is not reproducible, so is it really science?” by Christopher Hutton et al.: REPRODUCING COMPUTATIONAL STUDIES
journal, March 2017

  • Melsen, Lieke A.; Torfs, Paul J. J. F.; Uijlenhoet, Remko
  • Water Resources Research, Vol. 53, Issue 3
  • DOI: 10.1002/2016WR020208

Are we unnecessarily constraining the agility of complex process-based models?
journal, January 2015

  • Mendoza, Pablo A.; Clark, Martyn P.; Barlage, Michael
  • Water Resources Research, Vol. 51, Issue 1
  • DOI: 10.1002/2014WR015820

Declining Mountain Snowpack in Western North America*
journal, January 2005

  • Mote, Philip W.; Hamlet, Alan F.; Clark, Martyn P.
  • Bulletin of the American Meteorological Society, Vol. 86, Issue 1
  • DOI: 10.1175/BAMS-86-1-39

Streamflow simulation for continental-scale river basins
journal, April 1997

  • Nijssen, Bart; Lettenmaier, Dennis P.; Liang, Xu
  • Water Resources Research, Vol. 33, Issue 4
  • DOI: 10.1029/96WR03517

Predicting the Discharge of Global Rivers
journal, August 2001


Global Retrospective Estimation of Soil Moisture Using the Variable Infiltration Capacity Land Surface Model, 1980–93
journal, April 2001


A Prototype Global Drought Information System Based on Multiple Land Surface Models
journal, August 2014

  • Nijssen, Bart; Shukla, Shraddhanand; Lin, Chiyu
  • Journal of Hydrometeorology, Vol. 15, Issue 4
  • DOI: 10.1175/JHM-D-13-090.1

Data Assimilation for Estimating the Terrestrial Water Budget Using a Constrained Ensemble Kalman Filter
journal, June 2006

  • Pan, Ming; Wood, Eric F.
  • Journal of Hydrometeorology, Vol. 7, Issue 3
  • DOI: 10.1175/JHM495.1

Assessing the skill of satellite-based precipitation estimates in hydrologic applications: SATELLITE PRECIPITATION SKILL
journal, September 2010

  • Pan, Ming; Li, Haibin; Wood, Eric
  • Water Resources Research, Vol. 46, Issue 9
  • DOI: 10.1029/2009WR008290

NetCDF: an interface for scientific data access
journal, July 1990

  • Rew, R.; Davis, G.
  • IEEE Computer Graphics and Applications, Vol. 10, Issue 4
  • DOI: 10.1109/38.56302

Multimodel assessment of water scarcity under climate change
journal, December 2013

  • Schewe, Jacob; Heinke, Jens; Gerten, Dieter
  • Proceedings of the National Academy of Sciences, Vol. 111, Issue 9
  • DOI: 10.1073/pnas.1222460110

Characteristics of global and regional drought, 1950–2000: Analysis of soil moisture data from off-line simulation of the terrestrial hydrologic cycle
journal, January 2007

  • Sheffield, Justin; Wood, Eric F.
  • Journal of Geophysical Research, Vol. 112, Issue D17
  • DOI: 10.1029/2006JD008288

Development of a 50-Year High-Resolution Global Dataset of Meteorological Forcings for Land Surface Modeling
journal, July 2006

  • Sheffield, Justin; Goteti, Gopi; Wood, Eric F.
  • Journal of Climate, Vol. 19, Issue 13
  • DOI: 10.1175/JCLI3790.1

A Drought Monitoring and Forecasting System for Sub-Sahara African Water Resources and Food Security
journal, June 2014

  • Sheffield, Justin; Wood, Eric F.; Chaney, Nathaniel
  • Bulletin of the American Meteorological Society, Vol. 95, Issue 6
  • DOI: 10.1175/BAMS-D-12-00124.1

The role of surface energy fluxes in pan-Arctic snow cover changes
journal, July 2011


Drought Monitoring for Washington State: Indicators and Applications
journal, February 2011

  • Shukla, Shraddhanand; Steinemann, Anne C.; Lettenmaier, Dennis P.
  • Journal of Hydrometeorology, Vol. 12, Issue 1
  • DOI: 10.1175/2010JHM1307.1

Streamflow simulations of the terrestrial Arctic domain
journal, January 2005


Evaluation of TRMM Multisatellite Precipitation Analysis (TMPA) and Its Utility in Hydrologic Prediction in the La Plata Basin
journal, August 2008

  • Su, Fengge; Hong, Yang; Lettenmaier, Dennis P.
  • Journal of Hydrometeorology, Vol. 9, Issue 4
  • DOI: 10.1175/2007JHM944.1

Change in spring snowmelt timing in Eurasian Arctic rivers
journal, January 2011

  • Tan, Amanda; Adam, Jennifer C.; Lettenmaier, Dennis P.
  • Journal of Geophysical Research, Vol. 116, Issue D3
  • DOI: 10.1029/2010JD014337

An improved algorithm for estimating incident daily solar radiation from measurements of temperature, humidity, and precipitation
journal, March 1999


Soil Moisture Drought in China, 1950–2006
journal, July 2011

  • Wang, Aihui; Lettenmaier, Dennis P.; Sheffield, Justin
  • Journal of Climate, Vol. 24, Issue 13
  • DOI: 10.1175/2011JCLI3733.1

A distributed hydrology-vegetation model for complex terrain
journal, June 1994

  • Wigmosta, Mark S.; Vail, Lance W.; Lettenmaier, Dennis P.
  • Water Resources Research, Vol. 30, Issue 6
  • DOI: 10.1029/94WR00436

Best Practices for Scientific Computing
journal, January 2014


Long-range experimental hydrologic forecasting for the eastern United States
journal, January 2002


The Project for Intercomparison of Land-surface Parameterization Schemes (PILPS) Phase 2(c) Red–Arkansas River basin experiment:
journal, December 1998


Evaluating the influence of antecedent soil moisture on variability of the North American monsoon precipitation in the Coupled MM5/VIC Modeling System
journal, November 2009

  • Zhu, Chunmei; Leung, L. Ruby; Gochis, David
  • Journal of Advances in Modeling Earth Systems, Vol. 2
  • DOI: 10.3894/JAMES.2009.1.13

    Works referencing / citing this record:

    DECIPHeR v1: Dynamic fluxEs and ConnectIvity for Predictions of HydRology
    journal, January 2019

    • Coxon, Gemma; Freer, Jim; Lane, Rosanna
    • Geoscientific Model Development, Vol. 12, Issue 6
    • DOI: 10.5194/gmd-12-2285-2019

    A Python-enhanced urban land surface model SuPy (SUEWS in Python, v2019.2): development, deployment and demonstration
    journal, January 2019