General purpose alphanumerical display module. Vectorial numerical data are displayed as a list. The width of the module controls the precision with which the numbers are displayed. You may resize this module to change the precision or make room for other data.

The samples of a vector are displayed as a column :

If the data depend on more than one variable, the result is still displayed as a vector and the dimensions are interlaced. You cannot control in which order the elements are listed :

If the amount of data to display is such that there is not enough room on your screen, you may either select portions of data (see Changing the length of a variable), or select the ?????? module and hit Alt+M to change it into a macro. Then, double-click on the module : a new window featuring scroll bars opens and allows to view all the data.

The ?????? module should not be used to view a huge amount of data : select a portion of the data before, or use the graphic display macros instead.

Formatted vectorial numerical display macro. Displays the elements of a vector in a separate window with scroll bars, beside the indices. Allows to view a larger number of data, like in the program below :

Displays a 2D signal as a matrix. In the example below, the display window has been included into the front panel for convenience (see Creating images of macros).

Displays a 2D signal as a formatted matrix. In the example below, the display window has been included into the front panel for convenience (see Creating images of macros). The display format can be changed by double-clicking on the module.

Displays a 2D complex signal as a matrix.

Vertical normalization

Sets the extreme values on the vertical axis. You may change them and click on Manual to validate them. You may come back to automatic normalization by clicking on Auto back again.

Note : Automatic normalizations should not be used to view infinite signals (use specific macros from the Outputs / Real Time section of the Library instead).

Horizontal normalization

Sets the extreme values on the horizontal axis

Axes names

Puts labels along the axes of the graph (default = no labels)

Curve name

Changes the name of the graphical window (default = "Curve")

Color of curve

Sets the color of the curve when the Simple color line option is on. Must be a real number between 0 (transparent) and 1 (black) :

Color of back

Color of the graphical window background. Same scale as for the curve color.

Axes parameters

Sets the type of axes and the scale (linear or logarithmic) on both axes. Default configuration is standard axes and linear scales on both axes.

Axes…

Double-clicking on this image box opens a new window from which you may change the colors of the grid (default=0.2) and of the curve display zone (default=0), the maximum number of graduations (default=20), etc.

Drawing choice…

Simple color line (default)

Displays the curve with a thin color line

Allows to set the type, color and thickness of the line by double-clicking on the Choice of composite lines image box. Also allows to display symbols of various types, sizes and thickness at each data point. Very useful when viewing small vectors.

Displays only the axes. You may want to check this option to comfortably adjust the axes if your signal is very large and takes a long time to display.

Same as View/t macro, except that elements are available on the top output pin for combining several curves.

Displays a vector of complex numbers (the real and imaginary parts are superimposed)

Superimposes two input signals (the length and attributes of the signals must be the same)

Displays two input signals X(t) and Y(t) as a cloud of points in a (X,Y) plane

Allows to view signals much longer than the number of pixels on the horizontal axis.

Displays the histogram of the values contained in a vector. The number of intervals can be set by double-clicking on the box.

Displays the signal in a sliding graph, as done by cardiographs. This module is able to display infinite signals (length = -1). The larger the window, the slower the display process.

Macro for displaying clusters of signals : the length of variable /x is supposed to be smaller than that of variable /t.

Available display types are : vertical division, horizontal division, false colors, isocontours, superimposed curves, shifted curves, shifted curves with hidden surfaces. Examples are shown below.

Macro for displaying large matrices : the length of both variables /t and /x are of the same order of magnitude.

Available display types are : false colors, isocontours, shifted curves, shifted curves with hidden surfaces. Examples are shown below.

Displays a matrix using a color scale. A rectangle reticule appears when the mouse cursor is over the window. It may be moved or resized to frame the zone you want to zoom in. You may then ask for a zoomed view, and so on (see Using the View-Zoom/t macro).

Displays a matrix as a three-dimensional curve. The point of view, colors, axes and graduations are adjustable (mostly by mouse-sensitive cursors and buttons) by double-clicking on the box.

Note : A test signal is available to adjust the viewing parameters without having to recalculate the whole curve each time a parameter is changed.

The default line used for drawing curves is a thin, continuous color line. The color of the line and of the background are adjusted from the control panel.

Reminder : Colors are entered as real numbers ranging from 0 (transparent)) to 1 (black). Intermediate values are shown below :

An example a 2D view using this default drawing mode and the Vertical division display mode is shown on the right.

Double-click on the Auto choice box in the control panel : a new window opens to allow selecting the options of this mode :

In this mode, MUSTIG uses three features to distinguish one curve from the others : Style or symbol referred to by letter /s, Width referred to by letter /l and Color referred to by letter /c.

MUSTIG performs automatic permutations of these three features to display the curves. The number of elements and the values of a feature may be modified.

An order of priority is defined on the top bow : here, /s/c/l indicates that MUSTIG first permutes the style (i.e. it uses curves of same color and same width, with different symbols).

Then, if the number of curves to display is larger than the number of styles, it permutes the color of the curves, and so on.

You may change the order into /c/s/l for instance, to permute the color first, then the style and only then the width of the curves.

For instance, by choosing 2 styles, 2 width and 2 colors, and setting a /l/c/s priority, the six curves above can be displayed as shown on the left.

/l (line width) is the first priority, and two line width features have been selected : MUSTIG displays the first two curves by changing the line width.

/c (color) is the second priority and there are two selected colors : MUSTIG changes the color for the next two curves

/s (style) is the last priority : MUSTIG changes the data point symbol for the last two curves.

Double-click on the Individual choice box to set the parameters of each curve.

On the left of the window, check boxes allow to select a curve. The number of check boxes is equal to the length of variable x (6 in our example).

1. Click on the check box corresponding to the curve you want to change the look of. Your selection appears in red (first signal in the example on the right).

2. Change the parameters of the curve : symbols, colors, style, etc. so that the curve looks exactly as you want.

3. Repeat 1. and 2. until all the curves look exactly as you want.

An example of custom graph for the six signals of our example is shown on the left. The look of each curve has been set following the technique described above.

Curve 1 : Orange thick line, no symbol

Curve 2 : Light-blue dotted line, small square symbols

Curve 3 : No line, medium diamond-shaped symbols

Curve 4 : Thin continuous green line, thin + symbols

Curve 5 : Thick dash-dotted red line, no symbol

Curve 6 : Thick spaced dotted blue line, thick O symbols

Manual or automatic composite lines are also available in the Shifted curves, Horizontal division and Superimposition modes.

Here are the same curves with the same display parameters in superimposition mode (right).

With default line style

With manual composite lines option : no symbols, thin lines of different colors.

With default line style

Commonly used for displaying large sparse matrices, time-frequency representations, etc.

3D view

Commonly used for displaying large sparse matrices, time-frequency representations, etc.

Takes more time to calculate than a "flat" false colors 2D view.

May not be well readable if the values of the samples are homogeneous.

Each block is displayed as a BitMap color "slice". The color of a sample is proportional to its value. A scroll is made from one block to another, so that the display looks as a sonogram.

Displays each block as a continuous curve, right under the previous one, so that the displays looks as a 3D spectrogram.

Each block is displayed on one graph only and replaces the previous one. The result is an "animated" curve.

Handling graphical windows and planes

Curve source macro : generates a graphical window, also called a graphical plane. The points inside this plane are located using a normalized Cartesian coordinates system (abscissa and ordinate are real number ranging from 0 to 1) :

Note 1 : If the numbers used for passing a position to the graphical window have an integer type, then the position is calculated in pixels instead of relative coordinates. i10 = 10 pixels from the left side, i-10 = 10 pixels from the right side, etc.

Note 2 : The graphical window may be moved or resized just like any window. Once it has an appropriate size, it may be included into front panels or Image window as usual (see Creating front panels and Creating Image windows).

Divides an initial graphical plane into 4 graphical sub-planes. Each sub-planes has its own coordinates system.

Divides a graphical plane into successive horizontal sub-planes. The number of generated sub-planes is equal to the length of variable /u (the name can be changed as usual).

One drawing will be made in each sub-plane, corresponding to the different values along variable /u. This module allows to easily change a 1D view into a 2D view, or a 2D view into a 3D view, etc.

Same as above, but divides the initial graphical plane vertically.

Sets the color of the background of a graphical plane.

Creates two identical superimposed graphical planes : allows to set the order in which different drawings should be made.

Scrolls a graphical plane

Creates a vector of graphical sub-planes depending on variable /t.

Elementary drawing modules

Draws a line between two points of the graphical window

Draws a rectangle

Draws a cross

Draws a triangle

Displays a number at a given position in the graphical plane. The size of the module sets the number of digits of the displayed number.

Mouse-sensitive reticules (see reticule options below)

Draws a cross-like reticule in a graphical plane (see reticule options below).

A reticule is a mouse-sensitive cursors which returns one or several numbers depending on its position in the graphical plane (between 0 and 1).

It can then be moved by the user by just clicking on it and using either the mouse or the arrow keys. The selected reticule is redrawn in red. All the results that depend on the returned coordinate(s) are automatically recalculated if possible.

Although reticules are not macros, they may be documented like macros : Ctrl+U to create an online help, Ctrl+H to see the online help.

Draws a horizontal reticule (see reticule options below). Returns a real scalar.

Draws a vertical reticule (see reticule options below). Returns a real scalar.

Draws a rectangle reticule (see reticule options below). Returns two complex numbers. Rectangle reticules may be moved by dragging a border, or resized by keeping the Shift key pressed while moving a border.

Example program

Graphical window

Comments

Due to the O option, the reticule becomes visible only when the user hits Shift+Ctrl while the mouse cursor is over the graphical window.

The reticule becomes visible as soon as the mouse cursor is over the graphical window (no O option specified).

Mixed coordinates system : The position of the reticule is -25 pixels from the right border ¾ that is 25 pixels inside the window, and 80% of the height of the window.

The initial position of this 2D rectangle mouse-sensitive reticule is set by mixing relative and absolute positions : one corner is located 20 pixels from the left border and 40% of the height. The other corner is located -30 pixels from the right border (that is, 30 pixels left from that border) and 60% of the height.

This simple program draws a green line (green color code = 0.6) between two points of a graphical window. If you right-click on the C module to calculate it, a graphical window named "C" opens and displays the result :

Suppose you now want to draw a set of lines between points which coordinates are known. A solution is to use several Line elementary drawing modules, but there is a simpler solution.

A good starting point is the program in example 1. Thanks to MUSTIG's multidimensional facilities, you do not have to explicitly write a loop : just change the scalar input values into vectors depending on a given variable (/x here).

As both the variable name and its length are the same, MUSTIG automatically loops three times and displays the result as shown below.

Note : Take a look at the two other examples below. They illustrate the effect of changing a scalar into a vector, or changing the variable names : very informative !

This program is adapted from the previous one. The only difference is that only two coordinates of the lines (Y1 and Y2) plus the color code input are vectorial, the two other inputs being scalar (X1 and X2).

As a result, the horizontal position of the extreme points is the same for all the lines : MUSTIG loops only on the ordinates.

This time, the name of the variables on the two vectorial input pins is different. Thus MUSTIG knows that he must loop on all the existing combinations of samples from both vectors :

This program draws a red line (color code = 0.99) between a fixed point named "origin" and a mouse-sensitive reticule included in the window. Right-click on the C curve module to launch the calculation : a graphical window opens and displays the result :

You may move the reticule : the line will automatically be redrawn.

This program divides an initial graphical plane into 4 sub-planes. The division point is entered as a complex number.

Three sub-planes are then used individually to draw a line, a rectangle, display a value.

The fourth sub-plane (upper left part of the window) is left unplugged as it is not used.

The result is shown below :

As an exercise, you could start from this example and modify it so that the division point is set by a mouse-sensitive reticule.

Suppose your data consist of a set of 1D signals (depending on variable /t for instance), each signal being referred to by two other variables (/x and /y for instance).

A good way of viewing these data is to display a matrix of 1D signals. Thanks to the modularity of MUSTIG, you may do this very easily from the standard View/t macro :

1. Slide a View/t macro from the Library into your program window
2. Double-click on the macro, then on its control panel to see the program (a). Click on it and unlock it (Alt+W)
3. All we have to do to take both other variables /x and /y into account is divide the initial graphical plane horizontally according to variable /x for instance, and vertically according to variable /y. In order to do this, just modify the graph as shown on the right (b)
4. MUSTIG then knows it must divide the graphical window into a matrix of graphical planes, and display a 1D curve in each sub-plane : one curve for each sample on variable /x and /y.
5. Rename the macro into MatView/t/x/y, so that the variable names can be changed from the front panel to adapt to other situations.

Thus, it is very easy to modify an existing viewing macro to add one or two dimension and create custom viewing macros.

(a)

Original View/t macro

(b)

Modified View/t macro

(c) - Result : a matrix of 1D signals

(d) - Renamed module

You may connect several drawing operators to the same graphical plane. However, as the order in which the different drawings are made cannot be enforced, the obtained results may not be what you expected.

The first program on the right (a) draws a rectangle and displays a value. As the order is not specified, the value may as well be hidden by the rectangle if the latter is drawn after displaying the value.

If you want a drawing to explicitly be made over the other ones, you must specify it by including the Over module in your program.

In the modified version of the program (b), the value is explicitly drawn over the rectangle :

Note : Following the same principle, you may define a vector of ordered, superimposed graphical planes according to a variable, using the Superimpose/t elementary drawing module. This allows to create animated views.(a) - No order specified

(b) - Modified version