Output

Visualization

Supported Output Formats

The workflow manager nextnanomat can display the following output formats:

.txt

The file is displayed as a text.

.dat

The file is displayed as a graph, e.g. scalar field f(x) or vector field F(x)

\(x_1\)

\(f(x_1)\)

\(x_2\)

\(f(x_2)\)

\(x_n\)

\(f(x_n)\)

or

\(x_1\)

\(f_1(x_1)\)

\(f_2(x_1)\)

\(f_m(x_1)\)

\(x_2\)

\(f_1(x_2)\)

\(f_2(x_2)\)

\(f_m(x_2)\)

\(x_n\)

\(f_1(x_n)\)

\(f_2(x_n)\)

\(f_m(x_n)\)

.mtx or .mat

Matrix format for e.g. a matrix, a table, a f(x,y) graph. The x and y axes are labeled with integer numbers.

\[ \begin{align}\begin{aligned}\begin{bmatrix} A_{11} & A_{12} & A_{13} & ... & A_{1n}\\ A_{21} & A_{22} & A_{23} & ... & A_{2n}\\ ...\\ A_{m1} & A_{m2} & A_{m3} & ... & A_{mn} \end{bmatrix}\end{aligned}\end{align} \]
.vtr - 2D/3D

VTK format for rectilinear grid - scalar field f(x,y,z) or vector field F(x,y,z). They can be viewed using the ParaView software which is a full 3D visualization software while nextnanomat only displays 2D slices of 3D data files.

.fld - 1D/2D/3D

AVS format for rectilinear grid - scalar field f(x,y,z) or vector field F(x,y,z)

If a file extension is unknown it is treated as if it were a .txt file.

Text view

If text view is toggled, the content of the selected file is displayed. This view is read-only. For editing, the file can be exported to a custom texteditor. (We do not recommend to edit data files!)

1D View

Within graph view, one-dimensional data is displayed as curves. Whether data values are represented as points or lines is up to the user. Antialiasing can be switched on or off via Output settings. Additionally, the line thickness, background color or the usage of a grid can be customized.

If a data file contains multiple columns, each column is represented by its own curve. The list of available columns is shown within the column view panel. Only checked curves will be displayed. Selected curves are highlighted to allow fast recognition of related data.

Helpful features for one-dimensional data visualization are:

2D View

Two-dimensional data is displayed as a heat map, also known as pseudo-coloring. Each value of the two-dimensional grid is mapped to a distinct color. The color difference perceived allows the visual interpretation of value differences. Therefore the change of the color gradient needs to be perceived linearly by the human eye. Some color maps, like the rainbow map, introduce artefacts and have misleading visual perception, which increases the risk for misinterpretaion of scientific data. Find more information about Color maps.

Helpful features for two-dimensional data visualization are:

3D View

Real three-dimensional plots are not supported by nextnanomat. Instead 2D planes of the 3D data are visualized through heat maps, same as for 2D data. An additional panel allows the selection of the displayed plane (xy, xz or yz) and the position of the slice. This panel can be seen in Figure 1.1.29. If three-dimensional visualization is aimed for, we recommend exporting data to ParaView.

Helpful features for three-dimensional data visualization are:

Features

Overlay

For the best experience when visually analyzing the results of the simulation, it is sometimes necessary to look at different files at the same time. We call this the Overlay feature.

  1. Select the plots you want to memorize in the column view panel.

  2. Click the Add to Overlay button, see Figure 1.1.20. Alternatively, use the keys a (add) or + (Numpad only).

  3. Select another output file.

  4. (optional) add plots of multiple files to the overlay list.

\(\Rightarrow\) Your memorized plots will be displayed in gray on top of the currently selected file.

You can check and edit the content of your overlay in the overlay list panel, this panel can be shown or hidden by clicking the Show list of overlays button. Remove selected curves with the Remove from Overlay button, shown in Figure 1.1.20, or use the Del/Entf or d (delete) key on your keyboard.

You can also export the overlay graphs to one combined image file, for further information refer to Gnuplot export.

../../../_images/nnmat_TABS_OUTPUT_addRemoveOverlay.PNG

Figure 1.1.20 Workflow to add or remove files from Overlay.

Hide constant values

Note

Be careful when using this feature. We recommend to always disable it after usage.

This feature hides any parts of the curves where the value does not change within 5 grid points (two to the left and right). Its purpose is for visualizing wave functions and probability densities on top of band edges. The constant part which represents the energy level will be hidden. This allows to focus on the changing parts as well as for the underlying band edge to be seen. The influence of this feature can be seen in Figure 1.1.21 and Figure 1.1.22.

../../../_images/nnmat_TABS_OUTPUT_HideConstantV_on1.PNG

Figure 1.1.21 Hide constant values on.

../../../_images/nnmat_TABS_OUTPUT_HideConstantV_off.PNG

Figure 1.1.22 Hide constant values off.

Show differences

Whenever exactly two columns are selected in the column view panel, the value difference between these two curves is shown while the mouse is hovered over the data , see Figure 1.1.23.

../../../_images/nnmat_TABS_OUTPUT_valueDiff.PNG

Figure 1.1.23 Arrow showing value difference of two data curves.

Snap to gridpoints

If snap to grid points button is toggled (default: on) a small cursor cross follows the nearest data curve while the mouse cursor is hovered over the data. The coordinates and value displayed in the upper right corner of nextnanomat match the data values of the curve, see Figure 1.1.24.

../../../_images/nnmat_TABS_OUTPUT_SnapToGrid.PNG

Figure 1.1.24 Snap to grid points feature enabled.

Special fullsize

By using this feature, the view of the output diagram will be matched perfectly to a single graph. Either the selected graph of the column view, or it is iterating through all available columns of the currently displayed file. This feature is useful for example if a file contains multiple columns with a highly different range of values. Displaying all graphs at the same time (normal fullsize mode) can lead to certain curves appearing to be zero. By selecting such curve and clicking the special fullsize button, the y-axis limits are set to its respective minimum and maximum and the curve is displayed correctly. An example for this use-case can be seen in Figure 1.1.25.

../../../_images/GIF_specialFullsize_ROV.gif

Figure 1.1.25 Special fullsize for a diverging range of values.

Furthermore this feature is also useful for any other file containing more than one column. Iterating through the columns and displaying each curve in its optimal frame, allows for fast and convenient data evaluation, see Figure 1.1.26. .. example one high number of curves

../../../_images/GIF_specialFS_curves2.gif

Figure 1.1.26 Special fullsize for a high number of curves.

Auto select color map

If auto selection of a color map is active, a diverging color map is selected for data files spanning from negative to positive values. Else a linear color map is chosen.

Fix middle color to specific value

This feature is aimed for the visualization of diverging data in combination with a diverging color map. It fixes the mapping of the neutral middle color to a specific value and thus ensures a symmetric color representation of diverging data.

Note

To be able to support custom color maps, this feature is not limited to predefined diverging color maps. To avoid unintentional usage we recommend to enable this feature on demand only.

The feature is enabled by checking the corresponding check box. If enabled, it is active whenever a diverging color map is assumed (error prone to enable flexibility) and the data file contains the specified value. Else it is inactive and grayed out. The visual feedback on the activity of the feature can be seen in Figure 1.1.27 and Figure 1.1.28

Example usage of the feature can be seen in Figure 1.1.29.

../../../_images/nnmat_TABS_OUTPUT_fm_enabledActive.PNG

Figure 1.1.27 Enabled and active

../../../_images/nnmat_TABS_OUTPUT_fm_enabledInactive.PNG

Figure 1.1.28 Enabled but inactive

../../../_images/nnmat_TABS_OUTPUT_Panel3D_fixMiddle.PNG

Figure 1.1.29 Visualization of diverging data with fix middle color feature enabled and active.

Export functionality

Most of the export options are available from the context menu (right-click on the visualization). Some specific options can be accessed from the output menu button Export and Open in specific Format. For the latter option the custom defined paths to installed applications are used (with exception of the Gnuplot application). These paths need to be defined in the Output settings.

You can find a detailed description of the various export mechanism in the section Export Functionalities

Further information

References, you might find helpful…

Output settings

Clean up output folder

Color maps