diff --git a/docs/VisualTensorView.md b/docs/VisualTensorView.md new file mode 100644 index 00000000..922ad154 --- /dev/null +++ b/docs/VisualTensorView.md @@ -0,0 +1,55 @@ +# Visual Tensor View + +## Table of Contents +- [About](#about) +- [How to use](#how-to-use) + +## About + +Visual Tensor View is a tool that alows to visualize tensor data as a 2D-heatmap. + + + +## How to use + +Currently Visual Tensor View is integrated into property sidebar of Circle Graph View. +The visualizer is shown for all node properties that are tensors of 2 or more dimentions: + + + +In order to visualize tensor data: +- we need a *.circle model that contains at least one node with tensor properties with 2 or more dimentions like 'weights', 'filter', etc. +- open a folder that contains such model. +- click on the model file in Explorer. +- click on such node (Conv2D, for example). + + +- in 'NODE PROPERTIES' sidebar find 'INPUTS' containing the tensor property ('filter' in case of Conv2D). +- expand it with '+' button. + + +- the visualizer should appear. + + +- you can modify the heatmap scale or swap 'x' and 'y' using respective UI elements. + + +- the heatmap colors correspond to respective tensor values, the higher wavelength, the higher value: + * 'blue' - the lowest value in the current heatmap + * 'green' - the value is about (min + max) / 2 + * 'red' - the highest value in the current heatmap + +- hover the mouse over the heatmap pixel to see the actual value in the tooltip. + + +- if the tensor is 2D all tensor data is shown as a 2D-heatmap at once. + +- if the tensor is 3D, 4D...: + * exactly two axes should be selected with the checkboxes, the selected axes correspond to 'x' and 'y' of the heatmap. + + + * for all other axes fixed values should be set. + + + * in this example the heatmap point (x, y) corresponds to tensor[5][y][2][x]. + diff --git a/docs/images/VisualTensorViewAxes.jpg b/docs/images/VisualTensorViewAxes.jpg new file mode 100644 index 00000000..a441d134 Binary files /dev/null and b/docs/images/VisualTensorViewAxes.jpg differ diff --git a/docs/images/VisualTensorViewExample.jpg b/docs/images/VisualTensorViewExample.jpg new file mode 100644 index 00000000..91a56d5d Binary files /dev/null and b/docs/images/VisualTensorViewExample.jpg differ diff --git a/docs/images/VisualTensorViewExpand.jpg b/docs/images/VisualTensorViewExpand.jpg new file mode 100644 index 00000000..d58d1a39 Binary files /dev/null and b/docs/images/VisualTensorViewExpand.jpg differ diff --git a/docs/images/VisualTensorViewExpanded.jpg b/docs/images/VisualTensorViewExpanded.jpg new file mode 100644 index 00000000..e30e7e60 Binary files /dev/null and b/docs/images/VisualTensorViewExpanded.jpg differ diff --git a/docs/images/VisualTensorViewHeatmap.jpg b/docs/images/VisualTensorViewHeatmap.jpg new file mode 100644 index 00000000..7f10e90f Binary files /dev/null and b/docs/images/VisualTensorViewHeatmap.jpg differ diff --git a/docs/images/VisualTensorViewNode.jpg b/docs/images/VisualTensorViewNode.jpg new file mode 100644 index 00000000..57e27308 Binary files /dev/null and b/docs/images/VisualTensorViewNode.jpg differ diff --git a/docs/images/VisualTensorViewOverview.jpg b/docs/images/VisualTensorViewOverview.jpg new file mode 100644 index 00000000..5cfbafe0 Binary files /dev/null and b/docs/images/VisualTensorViewOverview.jpg differ diff --git a/docs/images/VisualTensorViewScale.jpg b/docs/images/VisualTensorViewScale.jpg new file mode 100644 index 00000000..58d104bb Binary files /dev/null and b/docs/images/VisualTensorViewScale.jpg differ diff --git a/docs/images/VisualTensorViewValues.jpg b/docs/images/VisualTensorViewValues.jpg new file mode 100644 index 00000000..35fe424d Binary files /dev/null and b/docs/images/VisualTensorViewValues.jpg differ diff --git a/media/CircleGraph/index.html b/media/CircleGraph/index.html index 9072ea67..146195b7 100644 --- a/media/CircleGraph/index.html +++ b/media/CircleGraph/index.html @@ -72,6 +72,8 @@