Open Source

We encourage any users who have modified (or would like to modify) VIC, either to fix bugs or develop new features, to contact us and coordinate development work with us. The VIC model source code is archived in Git and is publicly available through GitHub. To access the source code, visit GitHub, create an account, and visit github.com/UW-Hydro/VIC. The routing model will soon be added to the archive as well.

VIC is an open source development model and is released under the terms of the MIT License.

Instructions for using Git and GitHub to access the VIC code and contribute changes are here:

Model Development

Information about the VIC codebase:

All development activity is coordinated via the VIC github page, where you can also find all archived, current, beta, and development versions of the model.

Release Naming Convention

Beginning with the release of VIC 4.2, a release naming convention of VIC.MAJOR.MINOR.PATCH has been formally adopted. This naming system was introduced by Semantic Versioning and defined as:

  1. MAJOR version: when changes are included that are not backward compatible,
  2. MINOR version: when features and new functionality are added in a backwards-compatible manner, and
  3. PATCH version: when backwards-compatible bug fixes are made.

Release Roadmap

Regardless of the release type (major, minor, patch), the VIC model release process follows this roadmap.

  1. Identification of features and fixes to be included in the release. This is coordinated through the VIC github page.
  2. Features and fixes are added to the appropriate branch (develop or hotfix) via Github pull requests.
  3. The model is tested using the VIC test framework. Each of the following tests should be run and verified for any release.
    • Unit tests
    • System tests
    • Example tests
    • Science tests
    • Release tests
  4. Once all tests have been run and the release is ready, a few minor changes need to be made to the source code prior to a release:
    • Update the version string for classic and image drivers (vic_version.h)
    • Update the version string for the python driver (setup.py)
    • Update the documentation. At a minimum this means updating ReleaseNotes.md.
  5. Make the release!
    • Merge the release branch into the master branch.
    • Create the tag. This is best done on the command line as git tag -f -a VIC.5.1.2 -m 'release tag of VIC 5.1.2, bug fix update for this example.
    • Publish the release on Github.
    • Update the VIC documentation and Readme files with the releases Zenodo DOI (e.g. DOI).
    • Update the develop branch with the changes from the master branch.
    • Reset the version strings in the develop branch.