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:
- MAJOR version: when changes are included that are not backward compatible,
- MINOR version: when features and new functionality are added in a backwards-compatible manner, and
- 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.
- Identification of features and fixes to be included in the release. This is coordinated through the VIC github page.
- Features and fixes are added to the appropriate branch (
develop
orhotfix
) via Github pull requests. - 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
- 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.
- Update the version string for classic and image drivers (
- Make the release!
- Merge the
release
branch into themaster
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. ).
- Update the
develop
branch with the changes from themaster
branch. - Reset the version strings in the
develop
branch.
- Merge the