scrib/doc/regression.html

# ~cvs/scrib ("script lib")

`scrib' is a cvs module of scripts and TCL procs for scripting med with an easily-configurable Wish/Tk application.

## regression

    I have checked in a prototype of the ic_* regression-test gui. You can take a look at it on *nix at:
        scrib/run_ic_regression
    or in Windoze:
        scrib/run_ic_regression.bat

    The files defining the app are in the dir:
        scrib/app_ic_regression/

    It's not even close to hooked up, but you can make suggsestions on how you want it to work (buttons, options, etc.).

    The Testing DB directory structure for "Regression G" currently looks like this:

    >ls -l ic_regression/

    total 32
    1 jason    games         385 Nov 26 13:46 app_ic_regression_settings.bsm
    2 jason    games        4096 Nov 25 15:03 hex/
    3 jason    games        4096 Nov 25 16:33 prism/
    2 jason    games        4096 Nov 25 15:03 proj/
    1 jason    games         544 Nov 26 17:08 regression_setup.tcl
    4 jason    games        4096 Nov 25 17:01 tetra/
    2 jason    games        4096 Nov 25 15:03 uncouple/

    where each directory looks something like:

    >ls -Rl tetra/

    tetra/:
    total 8
    drwxrwxr-x    2 jason    games        4096 Nov 26 17:10 test_model_001/
    drwxrwxr-x    2 jason    games        4096 Nov 26 12:50 test_model_002/

    tetra/test_model_001:
    total 252
    1 jason    games         446 Nov 25 15:01 med.replay
    1 jason    games          13 Nov 25 14:39 representative_cmds
    1 jason    games        7699 Nov 24 17:16 rotational_period.tin
    1 jason    games        3882 Nov 24 17:16 std.output
    1 jason    games      210207 Nov 26 12:50 tetra_mesh.uns
    ...

    Right now, the replay file *has* to be called:
        med.replay
    If you want to specify the commands *definitive* of a model, put the ic_* commands in the:
        representative_cmds
    file. Without this file in a test_model directory, all ic_* commands in it's replay file will be harvested in deciding that model's relevance. Later I will add a single metadata-file there to describe a test_model directory better.

    Also, in the top level directory, you will see:
        app_ic_regression_settings.bsm
    and:
        regression_setup.tcl

    "regression_setup.tcl" is a metadata file which described things about the regression-db, or how to behave in it anyway. I have attached an example. "app_ic_regression_settings.bsm" is a settings file for the GUI. I have attahed examples of each.

    It's all still very far from hooked up (is only three days into development), so feel free to make suggestions (rather than complaints).

    We can talk about fuzzy-comparison of meshes with xml-reports later.

    ------------------------------------------------------
    author: jason k. aftosmis (jason at icemcfd dot com), november 2003