Subsections


Plotting in 2D

This section explains the 2D plotting functionality in SciCraft.

Plot window
is the whole window. This window will appear whenever you double click on a plot node in the module diagram.
(Plot 2D node
is a node located under the ``Plots'' part of the node list in the main SciCraft window. When you double click a Plot2D node in the node list, a green node will appear in your workspace. Double clicking this green node again will result in the plot window appearing.)
Render window
or Plot renderer is the area in which a plot is drawn and displayed. As you can see, a plot window can contain several render windows and a render window can contain several plots.
Plot
is a graphical representation and display of some data. In SciCraft a plot must reside inside a render window to be displayed.
Plot window control
is the part of the plot window that controls what kind of plots that should be displayed, and how they should be displayed. We will come back with a detailed description of the plot window control later.

Plot 2D Window

The plot 2D window is the whole node window. It contains other elements like render windows and window controllers. The render windows are located at the top of the plot 2D window, and the window controller at the bottom. Figure 2.20 shows an example of a plot 2D window.

Figure 2.20: Plot 2D Window
\begin{figure}\begin{center}
\includegraphics[scale=0.6]{plot_main.eps}\end{center}\end{figure}

From the menubar at the top left corner of the plot 2D window, various features of the plot 2D window can be controlled. Table 2.1 shows the different options available.


Table 2.1: Plot 2D menubar
Menu Menu item Shortcut key Description
File Save Custom Plot As None Saves a custom plot
File Print Selected Ctrl + P Prints the plot in the plot window that is selected
File Print All None Prints all plots in the plot window on the same sheet
File Export None Submenu with options to export the current plot, or all plots, to the EPS format
File Close Window Ctrl + W Closes the plot window
Edit Settings Ctrl + S Open the plot setup dialog 2.5.4
View Toggle Administrative Toolbar None Shows or hides the toolbar
View Toggle Configuration Window Ctrl + T Shows or hides the window controller 2.5.1
View Refresh F5 Updates plot data, i.e. after running the modulediagram


The render window

The render window contains the 2D plots. Each render window has a pair of x- and y-axis. A plot window can contain several render windows. The number of render windows can be controlled from the settings option in the pull down menu at the top left corner of the plot 2D window. See 2.5.4 for a more detailed description. Figure 2.21 show the render windows for the previous example.

Figure 2.21: Render Window
\begin{figure}\begin{center}
\rotatebox{0}{
\includegraphics[scale=0.6]{plot_main_wo_settings.eps}}\end{center}\end{figure}

A red border around the render window indicates that this window is active. To activate a render window, you can either click on the render window or select the tab corresponding to the correct render window in the window controller. When a render window is active it means that you can add and remove plots to the window and change settings for the render window and the plots it contains. Only one render windows can be in the active state simultaneously.


Window controller

The window controller is central to the control of the different render windows and plots in a plot window. The window controller consists of several tabs, one for each render window in the plot window. Figure 2.22 show the window controller for the previous example.

Figure 2.22: Window controller
\begin{figure}\begin{center}
\rotatebox{0}{
\includegraphics[scale=0.6]{plot_settings.eps}}\end{center}\end{figure}

A window controller tab consists of two main groups of controllers. The control options for the entire render window is placed to the left, and the control options for each plot in the render window is placed to the right in the window controller.

The left side of the window controller contains a list of all plots in the current render window. It also contains options for adding and deleting plots from the render window. Push the ``Add'' button to add a new plot to the window. From the ``Add plot'' dialog box, select which plot type to add to the render window. For a detailed description of the different plot types, see 2.5.2. The new plot will appear in the plot list. To delete a plot from the plot window, highlight the correct plot in the plot list and push the ``Delete'' button.

You can highlight one of the plots in the plot-list, and the plot setup dialog will appear to the right in the window controller. The plot setup dialog makes it possible to set the name of the selected plot. Default name is the name of the plot type. To specify which port x- and y- axis data comes from, select the correct ports from the ``X-axis data'' and ``Y-axis data'' drop down lists. Which column or row in the dataset to plot, is specified in a similar way. Default is to plot column 1 at both x- and y- axis. For a more detailed description of plot settings, see 2.5.5.

Picking

Picking is a feature that allows a user to ``pick'' one or more objects from a plot and perform operations on them. When a object is ``picked'', it will change colour.

There are two ways to perform picking: Picking a single element, and picking a group of elements. To pick a single element, place the cursor over the object and push the left mouse button. To pick a group of elements, push the left mouse button and drag the mouse. A rectangle will now appear in the render window. When the left mouse button is released, all objects within the rectangle will be marked.

To unmark the marked objects simply place the cursor in the render window and push the left mouse button. If a new point or area is selected, the old selection will be unmarked. To make a new selection without unmark the old selection, push the ``Shift'' button. When the ``Shift'' button is used, marked objects will be unmarked if the user tries to mark them again.

Zooming

Scicraft allows users to zoom in and inspect details of a renderwindow. To zoom in, push the right mouse button and drag the mouse. As with picking, a rectangle will appear in the render window. The area within the rectangle will be zoomed in. It is possible to zoom in several times. To zoom out, push ``Shift'' + right mouse button to zoom one level out, or push the middle mouse button to zoom out to the original plotimage.

Printing and exporting plots

When a plot window has been set up, SciCraft allows its users to print the plots in the plot window, or export them as an Encapsulated PostScript (EPS) file.

Figure 2.23: The Figure shows the Print dialog in which the user may choose which printer to print to, with or without colours, print to file and so on.
\begin{figure}\begin{center}
\rotatebox{0}{
\includegraphics[scale=0.5]{print_plots_dialog.eps}}\end{center}\end{figure}

In the File menu there is four options that allow the user to export or print the plots:

Print Selected...
When this option is selected, the plot that is selected (i.e. the plot with the red line around it, and the plot with the corresponding tab in the configuration dock window selected) gets printed through the Print Plot dialog. The Print Plot dialog is shown in Figure 2.23, in which the user may choose between various standard options for printing documents. The selected plot will be printed so that it fills out the sheet of paper in the best way, without loosing its plot's aspect ratio.
Print All...
When this option is selected, the plots in the Plot Window gets printed through the Print Plot dialog. The Print Plot dialog is shown in Figure 2.23, in which the user may choose between various standard options for printing documents. All plots will be printed so that it fills out the sheet of paper in the best way, without loosing its plots' aspect ratio.
Export $\to$ Selected Plot to EPS...
When this option is selected, the plot that is selected (i.e. the plot with the red line around it, and the plot with the corresponding tab in the configuration dock window selected) gets exported to an EPS file. The file name is chosen through a simple file browser dialog. The selected plot will be exported without loosing its plot's aspect ratio.
Export $\to$ All Plots to EPS...
When this option is selected, the plots in the Plot Window gets exported to an EPS file. The file name is chosen through a simple file browser dialog. All plots will be exported without loosing its plots' aspect ratio.

Saving and using custom plots

Table 2.1 says that it is possible to save a custom plot to a file. This saves a fully set up plot window, with all its settings including input ports, the plots and all the properties of the different plots. The one thing that is not saved is the data on the input ports, so that it is possible to reuse the configured plot windows with different data on the input ports.

When the Save Custom Plot As... option from the File menu is chosen the dialog of Figure 2.24 shows up.

Figure 2.24: Saving Custom Plots. Type in the name of the new Custom Plot here.
\begin{figure}\begin{center}
\rotatebox{0}{
\includegraphics[scale=0.6]{save_customplot.eps}}\end{center}\end{figure}

In this dialog the name of the new Custom Plot is written and will be saved to disk as this name. When Ok has been pressed the Custom Plot is saved to disk and shows up in the tree view in the SciCraft main window as shown in Figure 2.25. Now the Custom Plot may be used in a Module Diagram as any other plot node.

Figure 2.25: When a Custom Plot has been saved, the name of the new Custom Plot shows up in the Tree View in SciCraft.
\begin{figure}\begin{center}
\rotatebox{0}{
\includegraphics[scale=0.7]{view_customplot.eps}}\end{center}\end{figure}


Plot types

This section describes on a general level the different plot types that is included in SciCraft. For a more thorough description of how to set the settings on the different plots, see section 2.5.5.


Scatter Plot

Figure 2.26: Scatter Plot
\begin{figure}\begin{center}
\includegraphics[scale=0.8]{scatterplot}\end{center}\end{figure}

Figure 2.26 shows a sample Scatter Plot. A Scatter Plot takes a set of coordinates and sets markers on each coordinate's location in a coordinate system. The coordinate sets can be configured by selecting rows and/or columns from one of the input data matrices. The appearance of the markers are highly configurable, as it is possible to change the colour, size, and shape of all markers.


Line Plot

Figure 2.27: Line Plot
\begin{figure}\begin{center}
\includegraphics[scale=0.8]{lineplot}\end{center}\end{figure}

Figure 2.27 shows a sample Line Plot. Just as a Scatter Plot, a Line Plot takes a set of coordinates and sets markers on each coordinate's location in a coordinate system. In addition, lines are drawn between the markers in the same order as the coordinates are ordered. An additional option on the Line Plot is that it is possible to use the order in which the Y-coordinates are ordered as the X-coordinate of each coordinate pair. The appearance of the markers and lines between the markers are highly configurable, as it is possible to change the colour, size, and shape of all markers, and the colour, width, and style of the lines.


Dendrogram Plot

Dendrogram plot is a hierarchical, binary cluster tree plot. This tree is generated with the help of a matrix that describes the clusters and an order list which states in what order the objects appear. The current data format for drawing a dendrogram plot in SciCraft is Agnes (Agglomerative nesting). This format looks like this:

matrix = 
   1.00000  -2.00000  -3.00000   0.50000
   2.00000  -6.00000  -4.00000   0.70000
   3.00000   1.00000  -7.00000   1.00000
   4.00000  -1.00000  -5.00000   1.30000
   5.00000   3.00000   2.00000   1.50000
   6.00000   5.00000   4.00000   2.00000
order =
  2  3  7  6  4  1  5
The matrix data set tell us how the clusters relates to each other and the order set tells us in which order the objects appear in. In later edition we hope to support other data formats as well.

An example of a dendrogram plot can be seen in Figure [*].

Figure 2.28: Dendrogram plot
\begin{figure}\begin{center}
\includegraphics[scale=0.8]{dendrogram.eps}\end{center}\end{figure}


Histogram Plot

Histogram plot is a statistical plot which is used to graphically summarise and display the distribution of a data set. The histogram plot needs two inputs, a vector containing the data that will be counted and segmented and a scalar that defines how many bins/buckets will be used.

An example can be seen in Figure 2.29.

Figure 2.29: Histogram plot
\begin{figure}\begin{center}
\includegraphics[scale=0.8]{histogram.eps}\end{center}\end{figure}


Image Plot

The image plot displays a two dimensional matrix of values as a color mapped image. The values are mapped linearly from lowest to highest value against one of the color maps.


Multi Line Plot

The multi line plot is a plot capable of showing several line plots, based on rows on columns in a matrix. Which rows or columns you want to see can be decided by entering a range specification in the Matrix range field. The resulting rows/columns can also be manipulated through a range in the Vector range field.


Density Plot

Density plot is a plot that illustrates the distribution of data inside a region. The plot will count the number of data objects found and show the population as a colour that grows more and more white as the density increases. The density plot has an option for blurring the plot--averaging the density values using a mask with customisable size. In a blurred density plot, the colour of one density is influenced by the densities of all its neighbours. The number of neighbours that influences a density colour, is specified by the size of the averaging mask.


Plot Main Settings

This section describes how to set settings that applies to the entire plot node, eg. setting the input ports and choosing how many plot windows to use.

To display the settings dialog choose 'Settings' under the 'Edit' menu, or simply press 'Ctrl+S'.

Please notice that the new settings will not be valid until after you press the 'Apply' or the 'Ok' button. Pressing the 'Cancel' button at any time will discard the new settings and keep the old ones.

Input Ports

The 'Input ports' section of the main settings window is shown in figure 2.30.

Figure 2.30: Plot main settings section
\begin{figure}\begin{center}
\scalebox{0.5}{\includegraphics{settings_ports.eps}}\end{center}\end{figure}

Adding an input port:
Type a name and optionally, a type and description, and click the 'Add' button. A new input port has now been added to the plot node.
Updating an input port:
Select a port from the port list to alter the settings of this port. Type the new information in the 'Name', 'Type' and/or 'Description' field and click 'Update' to update the port settings.
Delete an input port:
Select a port from the port list and click the 'Delete' button to remove this port.

Render Windows

The 'Render windows' section is shown in figure 2.31.

Figure 2.31: Render windows section
\begin{figure}\begin{center}
\includegraphics[scale=0.5]{settings_render_windows.eps}\end{center}\end{figure}

Select how many plot windows you would like to view in the Plot Node view.

Plot Mapping

The 'Plot Mappings' section is shown in figure 2.32.

Figure 2.32: Plot mapping section
\begin{figure}\begin{center}
\scalebox{0.5}{\includegraphics{settings_mapping.eps}}\end{center}\end{figure}

Plot mapping works as follows: If two plots are mapped, selection in one of the two plots will also lead to a selection in the other plot. The mapping can be done automatically based on the dimension of the data set, or manually by simply selecting which two plots that should be mapped. Automatic mapping is switched off by default.

Enable plot mapping:
The plot mapping feature can be switched on and off by clicking the 'Enable plot mapping' check box.
Automatic mapping:
When this feature is enabled, any pair of plots with the same dimension will be mapped to each other. A dialog box will ask if you would like to map all your existing plots. Selecting 'Yes' will map all existing plots as well as any new plots when they are added. Selecting 'No' will only map new plots.

Figure 2.33: Add plot map dialogue
\begin{figure}\begin{center}
\scalebox{0.5}{\includegraphics{settings_add_mapping.eps}}\end{center}\end{figure}

Manually add a mapping:
By clicking 'Add...' the dialog shown in figure 2.33 will appear. You will now be able to manually map any two plots to each other regardless of their dimension. Select two different plots and click 'Map selected plots' to map these plots. Click 'Done' to return to the 'Plot Mappings' section of the plot settings window.
Manually delete a mapping:
Selecting a plot mapping and then 'Delete' will remove this mapping. Please notice that the 'Automatic mapping' feature will be disabled when deleting a mapping.


Render Window Settings

This section describes how to set settings that applies to one render window at a time.

General settings

The 'General' section of the render window settings window is shown in figure 2.34.

Figure 2.34: General section
\begin{figure}\begin{center}
\scalebox{0.6}{\includegraphics{window_general.eps}}\end{center}\end{figure}

Background colour:
Allows you to set the background colour of the render window.

Label settings

The 'Label' section of the render window settings window is shown in figure 2.35.

Figure 2.35: Label section
\begin{figure}\begin{center}
\scalebox{0.6}{\includegraphics{window_labels.eps}}\end{center}\end{figure}

Window title:
Sets this text as the title of the render window.
X-axis label:
Sets this text as the title of the X-axis.
Y-axis label:
Sets this text as the title of the Y-axis.

Grid settings

The 'Grid' section of the render window settings window is shown in figure 2.36.

Figure 2.36: Grid section
\begin{figure}\begin{center}
\scalebox{0.6}{\includegraphics{window_grid.eps}}\end{center}\end{figure}

Enabling/disabling major/minor grid:
With major grid enabled, a line will be drawn for each axis value. With minor grid enabled, a line will be drawn for each axis submarker.
Enabling/disabling X/Y grid:
The major and minor grid can be enabled and disabled for the x and/or y axes.
Colour:
Sets the grid line colour.
Width:
Sets grid line width.
Style:
Sets grid line style.

Axis settings

The 'Axis' section of the render window settings window is shown in figure 2.37.

Figure 2.37: Axis section
\begin{figure}\begin{center}
\scalebox{0.6}{\includegraphics{window_axis.eps}}\end{center}\end{figure}

X-axis auto scale:
If enabled, plots in the current window will be resized to fit inside the x-axis. If disabled, the min and max value of the x-axis will be set according to the values in the textboxes.
Y-axis auto scale:
If enabled, plots in the current window will be resized to fit inside the y-axis. If disabled, the min and max value of the y-axis will be set according to the values in the textboxes.
Keep aspect ratio:
If enabled, the aspect ratio between the x and y-axis will be kept constant. Notice that this option is not available if both the x-axis and y-axis auto scale option are diabled.


Plot settings

This section describes how to setup a 2d plot in a plot window. It applies to scatter, line and dendrogram plots.


Scatter Plot

Figure 2.38 shows a Scatter Plot which is configured properly to plot column 1 and column 3 of the default input port against each other.

Figure 2.38: Scatter Plot Settings
\begin{figure}\begin{center}
\includegraphics[scale=0.8]{scatterplot_settings_window}\end{center}\end{figure}

There are four main fields in the configuration dialog:

Plot name:
The name of this Scatter Plot is written here. This name is used to identify this Scatter Plot from any other plots that could be put in the same render window. If the Plot name is changed, the name of the selected plot in the list of plots on the left hand side gets updated.
X-axis data:
In the leftmost combobox, you choose which input port, data is to be retrieved from. The port name is displayed with the variable name from the input and the dimensions of the data in parantheses behind the port name. Note: The variable name and dimensions of it is not available until the diagram is run. In the other combobox you select whether the data is to be retrieved from a column or a row. The spin box on the right hand side selects which column or row (depending on what option is made in the combobox) the data is to be retrieved from.
Y-axis data:
The Y-axis data is set exactly the same way as the X-axis data.
Range selection:
Using a Matlab-like notation, subparts of the data from a column or row can be plotted. The default value is $1:end$ (plot entire data set), a detailed list over notations can be seen in table 2.2.


Table 2.2: Desctiption of range notations
NotationTranslates to
$ m:n $ Index from $m$ to $n$
$ m:end $ Index from $m$ to last index
$ m:end-5 $ Index from $m$ to last index - 5
$ m:s:n $ Index from $m$ to $n$ with step $s$
$ m_1:n_1, m_2:n_2 $ Index from $m_1$ to $n_1$ and from $m_2$ to $n_2$


How to set marker labels and changing the layout of plot markers are described in the following two paragraphs.

Setting marker labels

Figure 2.39 shows the setup dialog, in which the marker label settings are set. Figure 2.39 will set labels on the plot markers from the data that is on the input port labels. It will retrieve the labels from row number 1 in the matrix in the input port data.

Figure 2.39: Setting marker labels
\begin{figure}\begin{center}
\includegraphics[scale=0.5]{label_settings}\end{center}\end{figure}

There are three main options for how to set marker labels:

None:
No labels will be set on the plot markers when the Ok button is pressed. This is also the way to remove markers that has already been set.
Indexed from 1:
Labels will be set on the plot markers when the Ok button is pressed. The labels that will be set will be a sequence, $1, 2, 3, \ldots$, if no prefix is set. The prefix is set by typing it into the textbox right of the Indexed from 1 option. E.g. if the text string ``SciCraft'' is typed into the textbox, the sequence will be $SciCraft1, SciCraft2, SciCraft3, \ldots$.
From data:
Labels will be set on the plot markers when the Ok button is pressed. The labels that will be set will be retrieved from the given column or row in the given data input port. The input port and column or row index is set in the exact same way as the data is set on the Scatter Plot described in the previous paragraph.

Changing layout of plot markers

First of all, start by clicking on the Marker Settings button in the Scatter Plot Setup window. A new window will now appear on the screen, as illustrated in Figure 2.40.

Figure 2.40: Marker Settings window
\begin{figure}\begin{center}
\includegraphics[scale=0.5]{marker_settings.eps}\end{center}\end{figure}

If you want to change the marker symbol, toggle the Marker symbol radiobutton and continue by choosing the desired symbol from the combobox. It is also possible to change the style of the marker. Set the colour by clicking on the colour button. A new window, where you can choose a colour from a colour map will appear on the screen. When you have picked a new colour and closed the window, the new colour will be set on the button. Size and thickness of the marker is changed by clicking on the vertical arrows or by typing the value directly.

Instead of using a marker symbol you have the opportunity to replace the marker symbol by a 'text' symbol. Start by toggling the radiobutton named Text marker. Continue by typing in your text in the line edit field. If you want to change the layout of the font, click on the button next to the line edit field. A new window will now appear on the screen where you can change the settings of the font. It is also possible to change the colour of the text. This is done in the same way as for marker symbols.

When all changes are done, click on the Apply button, and the new marker settings will be applied for the current plot. By clicking on the Ok button the new settings will be applied and the Marker settings window will be closed. A preview of the current marker will be shown at the buttom of the window.

(Databaseinfo) Look up data from Gene Annotation Database

SciCraft enables the user to look up gene annotation data. Simply select one or more points in the scatter plot and click the Databaseinfo button, as shown in Figure 2.38. This will cause the Database information window, as shown in Figure 2.41. Select a data source and click Apply to look up the gene annotation information. A description of a specific gene is shown by clicking on it.

Figure 2.41: Database Information window
\begin{figure}\begin{center}
\includegraphics[scale=1.0]{databasewindow.eps}\end{center}\end{figure}

Brief descriptions of the variuos fields in the window are shown below:

ID:
GenBank Accession Number, used to look up database information.
Name and Description:
The name and description of the gene IDs are looked up in the database and displayed.
Database URL and Key:
URL and Key to the Gene Annotation Database to be used. Current this is locked to The Norwegian MicroArray Consortium Annotation Database. More information regarding this database can be found here:
http://nova2.idi.ntnu.no/annotdb/index.php?section=Home.
Data source:
An example of a data source would be a vector containing a list of gene IDs.


Setting tooltip labels on markers

SciCraft enables the user to use yet another dimension in plotting through the use of tooltip labels. Figure 2.42 shows a tooltip on a marker in a scatter plot. The label pops up like a tooltip does, when the mouse cursor is positioned over the marker.

Figure 2.42: An example of a tooltip label in a Scatter Plot
\begin{figure}\begin{center}
\includegraphics[scale=0.2]{tooltip_label}\end{center}\end{figure}

The tooltips can be assigned to the different markers in the same way as one assign labels to the different markers. By pressing the Tooltip labels button that is located below the combo boxes in which one assigns the data to the markers, a dialog similar to the one in Figure 2.39 pops up. In the dialog it is possible to choose from the following three options:

None:
No labels will be set as tooltips when the Ok button is pressed. This is also the way to remove tooltip labels that has already been set.
Indexed from 1:
Labels will be set as tooltips when the Ok button is pressed. The tooltip labels that will be set will be a sequence, $1, 2, 3, \ldots$, if no prefix is set. The prefix is set by typing it into the textbox right of the Indexed from 1 option. E.g. if the text string ``SciCraft'' is typed into the textbox, the sequence will be $SciCraft1, SciCraft2, SciCraft3, \ldots$.
From data:
Labels will be set as tooltips when the Ok button is pressed. The tooltip labels that will be set will be retrieved from the given column or row in the given data input port. The input port and column or row index is set in the exact same way as the data is set on the Scatter Plot described previously in this section.

When one of the last two options is chosen, the labels will pop up as tooltips when the mouse is over a marker.


Line Plot

Figure 2.43 shows a Line Plot which is configured properly to plot column 2 of the default input port with increasing indexes.

Figure 2.43: Line Plot settings
\begin{figure}\begin{center}
\includegraphics[scale=0.7]{lineplot_settings}\end{center}\end{figure}

There are three main fields in the configuration dialog:

Plot name:
The name of this Line Plot is written here. This name is used to identify this Line Plot from any other plots that could be put in the same render window. If the Plot name is changed, the name of the selected plot in the list of plots on the left hand side gets updated.
X-axis data:
In the leftmost combobox, you choose which input port, data is to be retrieved from. The port name is displayed with the variable name from the input and the dimensions of the data in parantheses behind the port name. Note: The variable name and dimensions of it is not available until the diagram is run. In addition, there is the Indexed option, which makes the first value in the Y-data show up on position 1, the second on position 2 and so on. In the other combobox you select whether the data is to be retrieved from a column or a row. The spin box on the right hand side selects which column or row (depending on what option is made in the combobox) the data is to be retrieved from.
Y-axis data:
The Y-axis data is set exactly the same way as the X-axis data, except that there is no option Indexed.
Range selection:
Using a Matlab-like notation, subparts of the data from a column or row can be plotted. The default value is $1:end$ (plot entire data set), a detailed list over notations can be seen in table 2.2.

How to change the layout of plot markers is described in the following paragraph.

Changing layout of a line plot

Start by clicking on the Line Settings button in Line Plot Setup window. A new window will then appear on the screen, as illustrated in figure 2.44.

If you want to change the current marker symbol a line plot, choose the Marker Settings tab and then follow the procedure as described in  2.5.5, ScatterPlot.

Otherwise, continue by clicking on the Line Settings tab. Change the the line type by choosing the desired one from the combobox. The line colour is set by clicking on the colour button. A new window will then appear, where you have the possibility to choose the desired colour. Pick the new colour from the map, and close the window. The new colour will then be set on the colour button. The width of the line is set by clicking on the vertical arrows or by typing the value directly. A preview of the line will be shown at the buttom of the window.

When all changes to the line is done, continue by clicking on the Apply button and the new settings for the line will be applied. If you click the Ok button the changes will be applied and the window will be closed.

Figure 2.44: Line setup window
\begin{figure}\begin{center}
\includegraphics[scale=0.5]{line_settings.eps}\end{center}\end{figure}

Setting tooltip labels on a line plot

SciCraft enables its users to set tooltip labels on a line plot. The tooltip labels will be set on each of the markers of the line in a plot. The tooltip labels are set in the same way as they are set on a scatter plot (see the corresponding paragraph, page [*], in the previous section for details).


Dendrogram Plot

Setting up a dendrogram plot is really straight forward. You need to have two data sources (input ports), one with the cluster matrix and one with the order list. You select which port that contains the cluster matrix and which port that has the order data. On the order port you have to select if the data is row or column and also which row or column to use. In Figure [*] the port single is used for the cluster matrix and row 1 from the single-order is used as order data.

Figure 2.45: Dendrogram Settings
\begin{figure}\begin{center}
\includegraphics[scale=0.8]{dendrogram_settings.eps}\end{center}\end{figure}

Setting tooltip labels on leaf nodes

SciCraft enables its users to set tooltip labels on a dendrogram plot. The tooltip labels will be set on the leaf nodes of the dendrogram plot, in the order according to the order list on the input port. The tooltip labels are set in the same way as they are set on a scatter plot (see the corresponding paragraph, page [*], in the section before the previous section for details).

Setting labels on leaf nodes

Labels can be set on the leaf nodes in the same way as tooltip labels by pressing the Label Settings button and choosing the desired settings. When choosing Use order indices, the leaf's order is printed, while these indices are used for lookup in the specified datasource when the From data radio button is set.

Colour and size mapping

It's possible to read meta data from any port defined in the plot node and map these data to colours and sizes of plot markers. This mapping possibility applies to both line and scatter plots. One may use either colour or size mapping, or both.

In both the Marker and Line Settings dialogs there is a Meta Data tab which is used to configure both the colour and size mapping from an input port. Figure 2.46 shows the settings window when the Meta Data tab has been chosen.

Figure 2.46: Meta Data Settings
\begin{figure}\begin{center}
\includegraphics[scale=0.5]{meta_data_settings}\end{center}\end{figure}

Choosing meta data

The data to use for mapping is chosen by selecting an input port on the desired type(s) of mapping and then choosing how to read the data, i.e. selecting column or row. The number of the column or row to use is then chosen by clicking the up/down arrows on the spin box or by typing the value directly. Note: If the module diagram has not yet been run, no data is available on any input ports, and the index or column/row number chosen may be out of bounds because no check can be made on the data. In addition, if the data set read from the selected port has a different size than that of the plot, the largest data set is stripped (end elements are removed) before mapping to achieve equal size on the two data sets.

Mapping data to marker colour

If you want to map the meta data read from the chosen input port to marker colours, just check the checkbox named Map to Marker Colour. Then choose a min and a max colour. The min colour is the colour associated with the minimum value in the data set read from the input port, and similarly the max colour is the colour associated with the maximum value. This mapping is linear. To choose these colours, just click the corresponding colour buttons. A new dialog will appear. Select the desired colour and then press Ok. The new colour will then be set on the colour button.

Mapping data to marker sizes

Mapping meta data to marker sizes is quite similar to that of mapping data to colours. Just check the checkbox named Map to Marker Size. The min size is the marker size associated with the minimum value in the data set, and similarly the max size corresponds to the maximum value. This mapping is also linear. Use the up/down arrows on the spin boxes or type the values directly.



SciCraft Development Team