← Observatory home
Proof · 7 of 19

Decision Flow

How does evidence move toward the final decision?

image_pattern_cnn2d · Open result image ↗
Decision Flow result for the image_pattern_cnn2d fixture
Real output from the small deterministic CNN-2D documentation fixture.

What it shows

A directed summary of evidence flow across the trace.

Claim boundary

This is evidence for this input and model state, not a universal statement about every input.

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 = report.figure("decision_flow", mode="publication_light")
figure.write_html("result.html")
InputModel bundle, one reference input, selected target
Display modepublication_light
Evidence levelObservational or descriptive
Machine outputproof/decision_flow.html
Related APIvraven.VRavenReport
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.