-
Notifications
You must be signed in to change notification settings - Fork 5
Home
LIVVkit (Land Ice Verification & Validation) is a python based V&V toolkit for computational ice sheet models. It aims to provide the following capabilities:
- Numerical verification
- Physical validation
- Code verification
- Performance validation
Within LIVVkit, these capabilities are broken into four components:
Model V&V | Software V&V |
---|---|
Numerics | Verification |
Validation | Performance |
Currently, LIVVkit is being developed and used in conjunction with the Community Ice Sheet Model (CISM), but is designed to be extensible to other models.
Get a copy of LIVVkit by cloning this repo:
git clone https://github.com/LIVVkit/LIVVkit.git
LIVVkit was designed to be used with Python 2.7. If
you are using any other version of Python by default, use the command for
Python 2.7 in place of any calls to python
in this document (or any other
LIVVkit Documentation). If you are not sure what version of Python you are
running try running python --version
from a terminal.
LIVVkit has some python package dependencies and some external package dependencies. The required packages to use LIVVkit are:
Python Packages | External Packages |
---|---|
python-numpy | NetCDF 4.3.0+ |
python-netCDF4 | NCO (NetCDF Operators) 4.4.0 |
python-matplotlib | HDF5 1.8.6 |
python-jinja2 | NCL (NCAR Command Language + graphics library) 6.1.2 |
If you have a working install of CISM, you'll likely already have everything you need
besides NCL, which you must install manually. LIVVkit will automatically
install any missing python packages in your $HOME/.local
directory.
For more information about installing any of these dependencies, check the links for each specific package. You may also be able to refer to the installation instructions found in the CISM manual.
If you are having any troubles with dependencies, open an issue on the issue tracker!
LIVVkit is primarily controlled via options specified at the command line. To see the full list of options, run:
./livv.py -h
or
python livv.py -h
The are three main use cases for LIVV:
- User -- verification of an install against a set of benchmark data
- Developer -- verification and validation of model changes over time
- Scientist -- validation of model results against observational and model generated data
Click the above links to see their workflows. The usage page has a discussion of LIVVkits options, advanced usage, and workflows.
LIVVkit is currently under active development. See our development roadmap.
For feature request, questions, bug reporting, or other issues, use the Issue Tracker.
Use the Issue Tracker.