← Observatory home
Compare · 1 of 1

Model comparison

How do matched models differ on the same evidence?

Start of familyimage_pattern_cnn2d · Open result image ↗
Model comparison result for the image_pattern_cnn2d fixture
Real output from the small deterministic CNN-2D documentation fixture.

What it shows

A matched comparison of model outputs and internal evidence.

Claim boundary

A fair claim requires matched inputs, targets, preprocessing, and compatible capture points.

Run this with the installed CLI

Point VRAVEN at a validated model bundle. This produces one focused HTML report and works after a normal PyPI installation.

vraven analyse ./my-model \
  --task explain \
  --preset standard \
  --format html \
  --output vraven-report.html

Start with the model-folder guide if your bundle is not prepared yet. The larger documentation fixture is a contributor workflow described in Develop from source.

Generate this view

# Use the typed result object returned by the matching analysis.
figure = comparison.figure("model_comparison", mode="publication_light")
figure.write_html("result.html")
InputModel bundle, one reference input, selected target
Display modepublication_light
Evidence levelObservational or descriptive
Machine outputcompare/model_comparison_publication_light.html
Related APIvraven.ModelComparison
Fixtureimage_pattern_cnn2d

How to read the result

  1. Start with the title and target metadata in the generated report.
  2. Read the strongest structures first, then inspect weaker or opposing evidence.
  3. Check the stated evidence level and status before treating a relationship as causal or formal.
  4. Retain the trace, model version, preprocessing, and VRAVEN version with any published claim.
Reproducibility noteThe screenshot is public documentation evidence. The source run remains local-first; raw provenance files are not published because they can contain machine paths.