summaryrefslogtreecommitdiff
path: root/doc/model-visual.md
blob: 55433b574b8ce592969598fd395d8ea5daa31547 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# Model Visualization

## Textual Output

In low- to medium-complexity applications, the simplest way of examining the
performance models generated by dfatool is textual output: `--show-model=param`.
This is implemented for most modeling methods.

## Graphical Output via dot(1)

`--export-dot PREFIX` exports the generated performance models for each pair of
name (state/transition/…) and performance attribute to
`PREFIX(name)-(attribute).dot`. The dot(1) program is capable of transforming
those into images. For instance, if feh(1) is available, a visual model is
accessible via `dot -Tpng filename.dot | feh -`.

In case of regression forests (XGBoost), dfatool exports the individual trees to
`PREFIX(name)-(attribute).(index).dot`.

## Plotting Model Predictions for Individual Configurations

`--plot-param name:attribute:parameter` displays both raw readings (as points,
see [[analysis-visual.md]]) and the corresponding performance model (as lines).
The plot is saved to (name)-(attribute)-(parameter).pdf and shown interactively
unless `--non-interactive` has been specified.

## JSON Export

Use `--export-json FILENAME` to export the performance model to FILENAME.
The model for NAME ATTRIBUTE is located in .name.NAME.ATTRIBUTE.modelFunction.