livvkit 2.1.0

Verification

In verification mode, LIVVkit analyzes and compares a regression testing dataset to a reference dataset, both of which are produced by CISM’s built and test structure (BATS). For example, LIVVkit may analyze the dataset produced from a proposed CISM 2.0.6 release (~400MB; download here) and compare it to the dataset produced from the CISM 2.0.0 release (~400MB; download here):

export TEST=cism-2.0.6-tests/titan-gnu/CISM_glissade/
export REF=cism-2.0.0-tests/titan-gnu/CISM_glissade/

livv -v $TEST $REF -o cism206v200

This will produce a portable website in the cism206v200 directory, which can be viewed by pointing your preferred browser to cism206v200/index.html.

Note: recently we’ve been getting reports that Chrome will not display the javascript elements of our output website when viewed on the local file system. If you’re not seeing any elements on the ``cism206v200/index.html`` page, try viewing with another browser (Firefox and Safari appear to be working; IE untested).

Validation

LIVVkit’s validation option allows you to execute validation extensions (internal or external) by pointing to one or more extension config file. LIVVkit ships with a extension template located in livvkit/components/validation_tests/template/. If you don’t know the location of livvkit, run this command:

python -c 'import livvkit; print(livvkit.__file__)'

which will output something like:

/home/joe/anaconda/envs/LIVVkit/lib/python3.6/site-packages/livvkit/__init__.py

Then, you can execute the extensions template like:

export LIVVKIT=/home/joe/anaconda/envs/LIVVkit/lib/python3.6/site-packages/livvkit

livv -V $LIVVKIT/components/validation_tests/template/template.json -o val_test

This will produce a portable website in the val_test directory, which can be viewed by pointing your preferred browser to val_test/index.html.

*Note: recently we’ve been getting reports that Chrome will not display the javascript elements of our output website when viewed on the local file system. See our FAQ for a work-around.

More

For more information about using LIVVkit see the documentation.