.. This file is part of Sympathy for Data. .. Copyright (c) 2010-2012 Combine Control Systems AB .. .. Sympathy for Data is free software: you can redistribute it and/or modify .. it under the terms of the GNU General Public License as published by .. the Free Software Foundation, version 3 of the License. .. .. Sympathy for Data is distributed in the hope that it will be useful, .. but WITHOUT ANY WARRANTY; without even the implied warranty of .. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .. GNU General Public License for more details. .. .. You should have received a copy of the GNU General Public License .. along with Sympathy for Data. If not, see . Windows ======= The graphical user interface or GUI for Sympathy for Data is the main interface, where you can create, edit, and run workflows. In the main interface of Sympathy for Data a number of smaller windows can be displayed, where each of these windows have their own functionality. All windows, except the workspace window, can be turned on/off from the *View* menu. A screenshot of the start view in Sympathy for Data is shown below. In this screenshot the workspace window and the node library window are located to the right and the left, respectively, and below that is the messages window. .. _`sympathy_start_view`: .. figure:: screenshot_main_window.png :alt: Startup view of the main window in `Sympathy for Data`. :align: center Screenshot of the startup view of the main window in `Sympathy for Data`. .. #. Execute - Execute the active workflow. .. #. Stop - Stop the execution of active workflow. .. #. Reload - Reload all nodes in the active workflow. .. figure:: screenshot_windows.png :scale: 80% :alt: All windows enabled in `Sympathy for Data`. :align: center Screenshot of `Sympathy for Data` with all windows in use. .. _node_library_window: Library window -------------- It is through the node library window that you get access to the nodes, the building blocks of the data analysis workflows. The nodes are stored in a tree structure and are categorized by their functionalities. The nodes are added to the flow with drag and drop. There are two ways of getting more information about a node in the library window. Brief information, consisting of a short description and a declaration of the incoming and outgoing data types, is displayed in a tooltip when resting the cursor over a node in the library view. The more detailed documentation is accessed by right clicking on the node and selecting "Help". A web browser will open to display the node documentation. Documentation for all nodes in the library can also be found :ref:`here `. It is possible to add new node libraries to the node library window. See :ref:`Using Libraries ` for introductory information about libraries and how to add them. The library window can be configured from :ref:`Library View in Preferences `. .. _search_window: Searching for nodes ^^^^^^^^^^^^^^^^^^^ You can search for nodes in the node library by typing search terms into the filter textbox. The search supports multiple search terms, which you can enter seperated by a space. For a node to match, each search terms must appear in a different word in the order that you typed them. Screenshots with examples of how to search in the library window are shown below. .. figure:: screenshot_search_single.png :alt: search with single search term :align: center Screenshot of searching with one search term .. figure:: screenshot_search_multi.png :alt: search with multi search term :align: center Screenshot of searching with multiple search terms .. _`error window`: Messages window --------------- The *Messages* window is where all output from nodes ends up; be it errors, warnings, or simple notices. When a node has something to say it will add a single row with the node's label to the left column of the *Messages* window. Select the this row to see the contents of the message. Right-click on the label and choose *Go to Node* to jump to the node in the flow view. Old messages from nodes will be automatically archived when the node changes state. By right-click on the label in the left column you can manually archive or delete messages. A button in the toolbar at the very left of the messages view allows you to see archived messages. Note that there is a limit to the number of archived messages that are kept. This limit can be changed in preferences. There are four different severities in the output, ranging from least to most severe: Notice Informative non-crucial output that does not affect the node's ability to complete its task. For messages at this level the node label is green and accompanied by a tick mark. Warnings A node will give you a warning when it suspects that something might be wrong, but it is still able to complete its task. You should usually take a look at any warnings and judge for yourself if some action needs to be taken. For messages at this level the node label is yellow and accompanied by a yellow warning sign. Error An unrecoverable error occurred during node execution. These errors are usually due to problems with either the node's configuration or the data that it received. The details can sometimes give more information about how to fix the problem. For error messages the node label is red and accompanied by a red warning sign. Exception Like the *Error* level this also represents some unrecoverable error during node execution. The difference is that an exception is some kind of error that the node developer has not anticipated. Sometimes these errors can be fixed simply by fixing some problem with the configuration or input data, but it can also be that there is some problem that needs to be fixed in the source code for the node. A good quality node should in principle never give exceptions. You should consider reporting any exceptions you see to the node developer by right-clicking on the node's label and choosing *Report Issue*. The content of an exception message will include a stack trace which gives information to the node developer about where in the code the error arose. For exceptions the node label is red and accompanied by a icon of a little bug. .. _`flow_overview`: Flow overview ------------- The flow overview can be accessed via the view menu. It shows all subflows and nodes in the current workflow. Click on a node or subflow to jump to that node or subflow. When typing something into the filter textbox only subflows and nodes whose labels match the filter are shown. This can help you quickly find nodes or subflows even in very large workflows. How to search from the flow overview textbox is similar as in the library window. See also :ref:`search_window` . Undo stack ---------- The undo stack shows all historical operations performed in the active workflow. Each operation (create node, move node, delete node, connect nodes etc.) is represented by a row in the undo stack with new operations being added at the bottom. If you select a specific row Sympathy will undo all operations below the selected row, effectively jumping to a point in time just after the selected operation was performed. .. _`help_browser`: Help browser ------------ The help browser is used for viewing the documentation from within Sympathy. Just right-click on a node and select :guilabel:`Help`, or select :menuselection:`Help --> User Manual` to open the help browser with the relevant portion of the documentation. The help browser is only intended for Sympathy's documentation, so any links that would take you outside of the documentation are instead opened in the system default web browser. Clicking on an example flow for any node will open that example flow in the current Sympathy session. If you prefer to use the system default web browser for viewing documentation, you can uncheck :guilabel:`Use internal help browser` in :menuselection:`File --> Preferences`.