The active items in the menus depend on the active window in the project. If the active window is a spreadsheet, then all the items linked to table functions are enabled and the others are automatically disabled. These commands can also be done by clicking on the New Project icon from the &file-toolbar-lnk;. In order to make this toolbar visible, use the &aff-toolbars-lnk; from the &view-menu-lnk;. File→ New → &new-project-cmd; (&new-project-key;) Creates a new &appname; project file. The project is the main container of &appname;, it can include tables, plots and notes. These objects can be organized in folders. If a project is open and saved, it will be closed. If a project is open is not saved, a dialog will be open to ask if the current project has to be saved. The new project will only contain an empty table. These commands can also be done by clicking on the New Project icon from the &file-toolbar-lnk;. In order to make this toolbar visible, use the &aff-toolbars-lnk; from the &view-menu-lnk;. &new-table-cmd; (&new-table-key;) TableCreate a new table Creates a new spreadsheet into the project. This empty table will have 30 rows and 2 columns. This number of rows and columns can be changed with the &table-dimensions-lnk; of the &table-menu-lnk;. The properties of each column (format of numbers, width, etc) can be modified by the commands of the &table-menu-lnk;. See the table section for more details. There are then many different ways to insert data inside a table: they can be entered one by one, copied and pasted from another software like a spreadsheet, imported from a text file (see &import-ascii-lnk;), or filled with the result of a function as explained in the section Filling of a table with the values of a function. &new-matrix-cmd; (&new-matrix-key;) MatrixCreate a new matrix Creates a new Matrix into the project. The empty matrix will have 32x32 cells, these dimensions can be changed by the &matrix-dimensions-lnk; of the &matrix-menu-lnk;. The default coordinates are ranging between 1 and 10 for x and y. See the matrix section for more details. &new-note-cmd; (&new-note-key;) Creates a new note window in the project. A note is a simple text window which can be used to add comments to the current project. This object is also used to store the scripts in python which can be used to perform complex operations with &appname;. See the note section and the python scripting sectionfor more details. It can also be used as a calculator. &new-graph-cmd; (&new-graph-key;) PlotCreate a new plot Creates a new empty 2D plot in the project. This default graph is just a framework in which you can add curves from the columns of a table with the &add-remove-curve-lnk; or define a mathematical expression with the &add-function-lnk; (to access to these command, use the &graph-menu-lnk; or do a right click). The graph will be created with the display parameters selected in the &preferences-lnk; (&edit-menu-lnk;). &new-function-plot-cmd; (&new-function-plot-key;) Opens a dialog allowing to create a plot by specifying an analytical function. See the 2D plot section of the tutorial for a general overview of this function.

This function can be defined in cartesian, parametric or polar coordinates, see the &add-function-lnk; for more details. &new-surface-3d-plot-cmd; (&new-surface-3d-plot-key;) Surface plotCreate a new surface plot Opens a dialog allowing to create a 3D plot by specifying an analytical function. See the 3D plot section of the tutorial for more detail on this function. The only available coordinate system is the cartesian one: z=f(x,y).

You can then enter the X, Y and Z scales. File → &open-cmd; (&open-key;) Opens an existing &appname; project file (default file extension .&file-ext;). If your project has been save in a compressed format, you must select the .&file-ext;.gz file format.

This command can also be used to open projects which have been built with the Qtiplot software (extension .qti) if the version used was below 0.9. By clicking on the Advanced button, an additional option appears which allows to insert a project in another as a new folder. File→ &recent-projects-cmd; Opens a list of the most recently used &appname; project files. You can open one of these files by selecting it from the list. If the file doesn't exist anymore an error message will pop-out and the file will be automatically deleted from the list. File→ &open-image-file-cmd; (&open-image-file-key;) This command loads an image file in a &appname; project. This image can be resized and then inserted in another 2D plot. It is in this case similar to the &add-image-lnk;. This image can also be used to generate an intensity matrix (see the &import-image-lnk;).

File→ &import-image-cmd; With this command, an image is loaded in the &appname; project and converted to an intensity matrix. For each pixel, an intensity between 0 and 255 is computed from the intensities of the three colors red, green and blue. This example shows the 3D plot which has been drawn from the matrix obtained with the &appname; logo. File→ &save-project-cmd; (&save-project-key;) Saves the actual project. If the project hasn't been saved yet ("untitled" project), a dialog will open, allowing to save the project to a specific location.In a project file all settings and all plots are stored in ASCII format. If the project include large tables, it may be usefull to save the project in a compressed file format. The free zlib library is used to build files in gzip formats ( .&file-ext;.gz ). File→ &save-project-as-cmd; Saves the actual project under a file name different from the current one. File → &open-template-cmd; Opens an existing template &appname; file. There are four kinds of templates with different extensions for file names. Entity Extension Parameters saved 2D Plot .qpt window and layers geometries, fonts and colors for labels and legends, etc. Style for curves is not kept. 3D Plot .qst window and layers geometries, fonts and colors for labels and legends, etc Table .qtt number of row and columns Matrix .qmt number of row and columns You just have to add curves with the &add-remove-curve-lnk;, but the style used to draw the curves is not kept in the template. See the . File → &save-as-template-cmd; Save the active object as a &appname; template file. In the case of plot template (.qpt file), the graphical parameters of the plot, together with the text labels (axis, etc) are restored, but the style used to draw the curves and the scales are not saved. File → &export-graph-cmd; The plot can be exported into several different image formats. You can define some parameters to customize your image file by checking the advanced options button. Depending on the chosen image format, the available options are not the same.

For tif, bmp, pbm, jpeg, xbm, pgm, ppm image formats, the quality of the image cannot be controlled, and these formats cannot handle transparency. Therefore, there is no need to check for advanced options. For jpeg and png, Image Quality parameter ranges between 0 and 100% and defines the compression ratio. The higher it is, the best the quality is but the larger the file is. For png, tif and xpm, you can choose to use a transparent background. For eps, ps and pdf file format, the option dialog is different. The parameters availables are: the size of the paper which is used to draw the plot, and the orientation of the paper sheet. You can choose to keep or not the aspect ratio of the plot, in the last case it will be adapted to the sheet size and orientation. In addition, you can define the resolution. The default value is 84. If you increase this parameter, the quality of the graphic elements will be better (but the overall size of the plot will be unchanged). The last format which can be selected is the Scalable Vector Graphic format. With this format, the files can be modified in vector drawing software such as Sodipodi, Inkscape or OpenOffice Draw. You can therefore build more complex images from the pristine &appname; plot. &export-graph-current-cmd; (&export-graph-current-key;) Here you have the possibility to save the active plot under different image formats. &export-graph-all-cmd; (&export-graph-all-key;) Here you have the possibility to save all plots of the project under different image formats. In this case, you must choose a directory for the differents plots. Then one file will be created for each plot, the filename being based on the title of the corresponding window. File→ &print-cmd; (&print-key;) Prints the active plot. A print dialog is opened where you can select the printer, etc.

. If your printer can handle duplex printing and/or color printing, your can select the corresponding options in the options tag of this dialog window. The properties button can be used to select the geometrics parameters of the printed output: paper size, margin, etc. File→ &print-all-plots-cmd; Prints all plots of the projects. A print dialog is opened where you can select the printer, different paper sizes, etc. File → &export-ascii-cmd; DataExport to text file Opens a dialog box allowing to save the data from the active spreadsheet to an ASCII file. You can save one selected table, or all the tables of the project. You can then choose the field separator which will be used by &appname;. If you check Export Selection, only the selected cells will be saved; If not, the whole table will be exported, including the cells with no content.

When the options are selected, click on OK and a new dialog will be displayed to choose the file name. If you check the all checkbox, the dialog box will ask for a folder and each table will be save in a file named from the title of the table windows. File → &import-ascii-cmd; Imports one or more ASCII file into the project by creating a new spreadsheet storing the data from the file.

You can choose to put each data file in a separate table, or join all the data files in one table. There is no automatic analysis of the data. Therefore, by default, the data will be read as text. If you want to obtain directly numeric values, you can specify it in the numeric data check box. You must then indicate the format of the numbers. The other possibility is to read data as text and then to specify the type and format of the different columns with the properties dialog of the tables. If you check the Remember the above options, the selected parameters will be used as default values. They will be used if you read an ascii file directly from the command line (see the Command line options section for more details. File → &quit-cmd; (&quit-key;) Closes the application. You will be asked wether you want to save your last changes or not. Edit → &undo-cmd; (&undo-key;) Undo the last command done on tables or matrix. It can also be accessed by clicking on the &undo-icon; icon of the &edit-toolbar-lnk;. The list of commands which are in the stack can be seen with the &undo-redo-history-lnk;. This command is not available for plot windows. Edit → &redo-cmd; (&redo-key;) Restores the modifications in a table after a "Undo" operation. It can also be accessed by clicking on the &redo-icon; icon of the &edit-toolbar-lnk;. The list of commands which are in the stack can be seen with the &undo-redo-history-lnk;. This function is not available for plot windows. Edit → &cut-cmd; (&cut-key;) Copies the current selection to the clipboard and deletes the selection. It can also be accessed by clicking on the &cut-icon; icon of the &edit-toolbar-lnk;. The command currently works for spreadsheets and for 2D plots objects. Edit → ©-cmd; (©-key;) Copies the current selection to the clipboard. It can also be accessed by clicking on the ©-icon; icon of the &edit-toolbar-lnk;. The command currently works for spreadsheets and for 2D plots objects. Edit → &paste-cmd; (&paste-key;) Pastes the content of the clipboard to the active window. It can also be accessed by clicking on the &paste-icon; icon of the &edit-toolbar-lnk;. The command currently works for spreadsheets and for 2D plots objects. Edit → &delete-cmd; (&delete-key;) Cleares the current selection. It can also be accessed by clicking on the &delete-icon; icon of the &edit-toolbar-lnk;. The command currently works for spreadsheets and for 2D plots objects. Edit → &delete-fit-cmd; Each time yo do a fit of your data with some mathematical model, a new table is created to put the results of the fit (i.e. the values computed by the model). These tables can be used to plot comparisons of experimental and fitted values. If you have done several fitting tentatives, a number of unused table may be present in your project. This command allows to remove the results of all the differents fits that you have tested. Edit → &clear-log-information-cmd; Deletes from the project file all the history information about the analysis operations performed by the user (fitting, integrations, etc). The log panel is then empty. If your project is reload from a file, all the fitting will be done again and the log-panel will be filled. Edit → &preferences-cmd; OptionsApplication The preference dialog is used to customize the application. It has five different tabs. If you confirm your changes to the default behaviour of the application, the changes are saved and stored imediatelly. The first icon can be selected to change the General options of the application. In the first tab: Application, the style is the general decoration used for the windows. It defines the aspect of the buttons and dialog boxes, as an example all screenshots presented in this manual have been done with the Cleanlooks style available in KDE. The available styles are part of the Qt library. The font is the general font used for the GUI (menus, dialogs, etc), it doesn't apply to the plots. You can select the language of the application in the corresponding combo-box. All the available translations can be downloaded from the following address: Sourceforge repository, you can also use the &translations-lnk; from the &help-menu-lnk;.The translated messages are in a file with the extension .qm which must be placed in a folder called share/translations/, situated in the same location as the &appname; executable, in order to be loaded by the application.

The second tab of the General option set is used to disable the prompting on deleting of objects. In the third tab, you can change the default color for the workspace of the application. You can also choose the background color and the text color for panels. The panels are the Log Window (activated by the &results-log-lnk;) and the Project explorer (activated by the &project-explorer-lnk;. The last tab is use to set the default format for numbers. This format will be used in any new table of matrix. If you check the Update... option, the decimal separator of the numbers already present in tables will be modified. The other icons can be used to define the default behaviour of specific objects. Refer to the corresponding sections for more details: tables, 2D links, 3D links and Fitting. View → &aff-toolbars-cmd; There are seven toolbar which can be used to quickly access to the different functions. &file-toolbar-lnk; &edit-toolbar-lnk; &graph-toolbar-lnk; &plot-toolbar-lnk; &table-toolbar-lnk; &matrix-plot-toolbar-lnk; &d3-surface-toolbar-lnk; In most cases, they are present automatically when necessary. View → &plot-wizard-cmd; (&plot-wizard-key;) PlotCreate with the assistant This dialog is used to build a new plot by selecting the columns in the tables available in the current project. At first, you have to select the table you want to use, and then click on New curve to create the curve. After that, you have to select at least one column for X and one for Y. You can also select one more column for X-errors or for Y-errors. The plot created will have the default style you defined using the 2D plot preferences dialog through the '2D Plots -> Curves' tab.

In this example, one curve is selected from the first table, and the other from the second table (with X error bars)

View → &project-explorer-cmd; (&project-explorer-key;) Opens/Close the Project Explorer, which gives an overview of the structure of a project and allows the user to perform various operations on the windows (tables and plots) in the workspace. The project explorer shows a list of all the windows, tables, matrices and folders which are included in the current project. It can be used to create new folders and windows, to find existing ones, to make hidden elements visible, to perform basic operations like: renaming, deleting, hiding, resizing, printing, etc... You can also use it in order to display the list of dependencies and properties of an element in the project.

View → &results-log-cmd; Opens/Close a panel displaying the historic of the data analysis operations performed by the user. View → &undo-redo-history-cmd; This command shows a window which contain all the command which have been done on tables and matrix during the session.

View → &console-cmd; .

This menu is only active when a plot window is selected. Graph → &add-remove-curve-cmd; (&add-remove-curve-key;) Opens the &add-remove-curve-cmd; dialog, allowing to easily add or remove curves from the active plot layer. This dialog can also be used to modify a curve which is already plotted by changing the columns which are used as X or Y values. PlotAdd a curve PlotRemove a curve The left window shows the columns which are available for plotting in the different tables of the project, and the right window gives the list of the curves already plotted. In the case presented below, there are two tables in which the &add-remove-curve-cmd; dialog box allows to select columns. If you use this dialog box to add a column, the X column will be the one define as X in the corresponding table.

In this dialog box, if you select one curve of the plot in the right window, you can change the columns used for X and Y with the Plot Association button. In any case, you can't mix the X values of one table with the Y values of another one. If you wan't to do this, you have to copy the columns in the same table. If the curve selected is a function, you can modify it. Refer to the &add-function-lnk; for more details on functions editing. Graph → &add-error-bars-cmd; (&add-error-bars-key;) PlotError bars This command is used to plot X and/or Y error bars around the data points. It must be taken care that the "add" button add the errors bars, and so do the "OK" button. Then, you should close the dialog with cancel if you have clicked on the "add" button.

There are three ways to specify the size of the bar: A column of the table In this case, the values of the selected column are used to compute the error bars. if V is the value of the data point, and E the value of the errorbar column, the size of the bars will be V-E to V+E. A percentage of the values if E is the percentage selected, the size of the bars will be V(1-E/100) to V(1+E/100). It must be noticed that, in addition to the errorbars on the plot, this command will create a new column in the active table with can be used in the way as with the previous option. This column can be modified like any other one. The standard deviation of the values the standard deviation of the values. This has a meaning only of the data are centered around an average value. Like with the previous option, a new column will be created in the active table.

Graph → &add-function-cmd; (&add-function-key;) PlotPlot a function This dialog box is used to add a function curve to the active plot. The function can be built with the common operators: * + / - and ^ for the power. The intrinsic functions available are listed in the appendix. The most common way to define a function is the classical cartesian coordinate definition y=f(x), this is the defaut option. The two following parameters allow to select the x range used for the plot, and the last one is used for the number of data points that are computed in the X-range.

The functions can also be defined in a parametric definition: if t is the parameter, the (x,y) data points are computed by x=f(t) and y=g(t). The first parameter is the name of the parametric variable (here t) followed by the range, the definition of the two functions and the number of data points.

The last way is the polar definition of the function: if t is the parameter, the radius r and the angle theta are computed by r=f(t) and theta=g(t). Then the (x,y) data points are computed by x=r*cos(theta) and y=r*sin(theta). The first parameter is the name of the parametric variable (here t) followed by the range, the definition of the two functions and the number of data points.The angle is defined in radians, and the constant value pi can be used: it is possible to use 3*pi to define the parameter range.

Graph → &add-text-cmd; (&add-text-key;) Text labelAdd a text label Opens a dialog allowing you to select whether the text is to be added to the active plot layer or on a new layer. The cursor changes to an edit text cursor. Next, you must click in the plot window to specify the position of the new text box. A text dialog will pop-up allowing you to type the new text to be displayed and all its properties (color, font, etc...) If you choose the On new layer option, the text will be inserted as a new layer which has the size and the position of the text. You can then modify the size and position of this layer with the layer Geometry (see the &add-layer-lnk; for details). Beware that in this case, all text which is not in the layer will be clipped, therefore, you need to modify the layer to modify the position of the text. If you choose the On Active layer option, the text will be inserted in the selected layer, and its position can be modified directly with the mouse inside this layer.

Graph → &draw-arrow-cmd; (&draw-arrow-key;) Arrows and LinesAdd an arrow/line Changes the active layer operation mode to the drawing mode. You must click on the layer canvas in order to specify the starting point for the new arrow, and then click once more to specify its ending point. You can edit the new arrow using the Arrow dialog. You can swith back to the normal operating mode by clicking the "Pointer" icon in the Plot toolbar. Then, a dialog allows to modify a line or an arrow which has been created. One can open it with a double click on an arrow or a line, or by selecting an arrow or a line and selecting Properties... with the right button of the mouse. The first tab allows to change the color, the line type and the line width. This last parameter is set in pixels. It is possible to define a default style for all the new lines by pressing the Set Default button.

The Arrow head tab is used to modify the shape of the head of the arrow. The length is set in pixels and the angle is in degrees. It is also possible to define a default style for the arrow heads using the same Set Default button.

The Geometry tab allows to specify the start and end points of the line/arrow. The coordinates can be set as a function of the scales values displayed on the left axis (Y) and on the bottom axis (X) or in pixels, by choosing the desired method from the Unit pull-down list. The pixel coordinates are relative to the top-left corner of the layer which contains the line.

Graph → &draw-line-cmd; (&draw-line-key;) Changes the active layer operation mode to the drawing mode. You must click on the layer canvas in order to specify the starting point for the new arrow, and then click once more to specify its ending point. You can edit the new arrow using the line dialog. You can swith back to the normal operating mode by clicking the "Pointer" icon in the Plot toolbar. Graph → &add-time-stamp-cmd; (&add-time-stamp-key;) This command is used to add a special label in the current plot which contains the current date and time. The properties of this label can be customized like any other label that is added by the &add-text-lnk;. A timestamp label is not modified if the plot is modified, saved, etc. Graph → &add-image-cmd; (&add-image-key;) Opens a file dialog allowing you to select an image to be added to the active plot layer. Only a link to the image file will be saved into the project file and not the image itself. The new image is added to the left-top corner of the layer and can be moved by drag-and-drop. Graph → &new-legend-cmd; (&new-legend-key;) Adds a new legend object to the active plot layer. You can have more than one legend on a plot. These legends can then be customized by double clicking on a given legend. Graph → &automatic-layout-cmd; Restore the drawind parameters of the layout to its default values (as they are defined in the dialog box of the &arrange-layers-lnk;): margins between the layer and the window border of 5 pixels, layer centered in the window, etc. Graph → &add-layer-cmd; (&add-layer-key;) Multilayers plotAdd a new layer This dialog is opened when you want to add a new layer on the active plot. If you select Guess, &appname; will divide the window in two columns and put the new layer on the right. If you choose Top-Left Corner, &appname; will create a new layer with the maximum possible size over the existing layer, this layer contains an empty plot.

You can then modify the size and position of each layer by selecting it with the layer number buttons and selecting the Layer Geometry command from the context menu. Graph → &remove-layer-cmd; (&remove-layer-key;) Deletes the active layer and prompts out a question dialog allowing you to choose whether the remaining layers should be automatically re-arranged or not. Graph → &arrange-layers-cmd; (&arrange-layers-key;) Multilayers plotOrganize the layers This dialog allows to modify the geometrical arrangement of the plots which are already present in the active window. You can also add new layers or remove existing ones.

The Arrange Layers dialog is used to modify the geometrical arrangement of the plots. You can specify the numbers of rows and columns which will define a table of plots. As pointed out above, you can also add or remove layers with this dialog, using the "Number of Layers" box. With the default setting, &appname; computes the size of the layers from the size of the window. If you check the Layer Canvas Size, you can set the size of the layers and &appname; will modify the size of the window. The two right zones allow to set the alignement of the layers in the window, and the margins between the layer borders and the window limits. If you do some modifications on your plot, the alignment of the different axis may not be conserved. You can exec again the &arrange-layers-cmd; to re-arrange your plot. This menu is active only when a table is selected. It can also be accessed in the context menu when one or more columns of a table are selected. These commands allow to plot the data selected in the active table. There are several possibilities to plot from a table: Conventional X-Y plots: lines, scatter Other plots which are drawn as X-Y plots: columns, rows Plots which need the computation of a distribution of values from the columns of data: histograms, box plots Vector plots which need four columns 3D plots drawn from a set of (X,Y,Z) triplets in three columns &line-cmd; Plots the selected data columns in the active table window using the "Line" style. This command can also be activated by clinking on the &line-icon; icon of the &table-toolbar-lnk;. Once the plot is created, the drawing of the data series can be customized (see ). &scatter-cmd; Plots the selected data columns in the active table window using the "Scatter" style. This command can also be activated by clinking on the &scatter-icon; icon of the &table-toolbar-lnk;. Once the plot is created, the drawing of the data series can be customized (see ). &line-symbol-cmd; Plots the selected data columns in the active table window using the "Line + Symbol" style.This command can also be activated by clinking on the &line-symbol-icon; icon of the &table-toolbar-lnk;. Once the plot is created, the drawing of the data series can be customized (see ). &special-line-symbol-cmd; → &vertical-drop-lines-cmd; Plots the selected data columns in the active table window using the "Vertical drop lines" style. Once the plot is created, the drawing of the data series can be customized (see ). &spline-cmd; Plots the selected data columns in the active table window using the "Spline" style. Once the plot is created, the drawing of the data series can be customized (see ). &vertical-steps-cmd; Plots the selected data columns in the active table window using the "Vertical Steps" style. Once the plot is created, the drawing of the data series can be customized (see ). &horizontal-steps-cmd; Plots the selected data columns in the active table window using the "Horizontal Steps" style. Once the plot is created, the drawing of the data series can be customized (see ). &columns-cmd; Plots the selected data columns in the active table window using the "Columns" style, that is vertical bars. &rows-cmd; Plots the selected data columns in the active table window using the "Rows" style. &area-cmd; Plots the selected data columns in the active table window using the "Area" style, that is a line style with the area under the curve filled. &pie-cmd; Creates a 2D Pie plot of the selected column in the active table window (only one column allowed). See for more details. &vectors-xyxy-cmd; Creates a vectors plot of the selected column in the active table window. You must select four columns for this particular type of plot. The two first columns give the coordinates for the starting points of the vectors, the two last columns giving the information regarding the end points. See for more details. &vectors-xyam-cmd; Creates a vectors plot of the selected column in the active table window. You must select four columns for this particular type of plot. The two first columns give the coordinates for the starting points of the vectors, the two last columns giving the angle (in radians) and the magnitude of the vectors. See for more details. &statistical-graphs-cmd; Statistical plot will not give a direct drawing of the data selected in the table, but they will give a representation of the frequency distribution of the Y-values. &box-plot-cmd; Creates a box plot of the selected data columns in the active table window. This type of plot is used to give a graphical representation of the some classical parameters of the frequency distribution such as the mean of data, the min and max values, the position of the 95 and 5 percentiles, etc. The choice of the statistical parameters and the graphical parameters can be modified (see ). &histogram-cmd; Creates a frequency histograms of the selected data columns in the active table window. With this command, a frequency distribution is computed from your data. The default binning uses 10 steps between the max and the min of Y-values. The parameters used to compute the distribution and the graphical parameters used for the drawing of the columns can be modified (see for details). If you want to draw an histogram directly from values, use the &bars-lnk;. &stacked-histogram-cmd; Creates vertically stacked layers displaying the histograms of the selected data columns in the active table window (one histogram per layer) See the &vertical-2-layers-lnk; for more details. &panel-cmd; These commands can be used to obtain quickly some classical arrangements of multiple plot. &vertical-2-layers-cmd; Creates 2 vertically stacked layers displaying the selected data columns in the active table window (one curve per layer). &horizontal-2-layers-cmd; Creates 2 horizontally stacked layers displaying the selected data columns in the active table window (one curve per layer). &four-layers-cmd; Creates 4 layers on a 2x2 grid, displaying the selected data columns in the active table window (one curve per layer). &stacked-layers-cmd; Creates vertically stacked layers displaying the selected data columns in the active table window (one curve per layer). &plot-3d-cmd; &ribbons-cmd; Makes a 3D plot of the selected data column in the active table window (only one column allowed) using the "Ribbon" style. &bars-cmd; Makes a 3D plot of the selected data column in the active table window (only one column allowed) using the "3D Bars" style. &scatter-cmd; Makes a 3D plot of the selected data column in the active table window (only one column allowed) using the "3D Dots" style. The 3D point symbol style can be changed via the 3D Plots Settings dialog. With scatter plots, you can choose the kind of graphic item which is used to plot the data points. The example above is done with cross hairs, but you can also select points or cones. This can be done either with the corresponding icons of the &d3-surface-toolbar-lnk; (respectively &cross-hairs-icon; &dots-icon; and &cones-icon; for cross-hairs, dots and cones) or with the custom-curves dialog. &trajectory-cmd; Makes a 3D plot of the selected data column in the active table window (only one column allowed) using the "3D Line" style. The line width and color may be changed via the 3D Plots Settings dialog. This menu is only active when a matrix is selected. &mesh-cmd; Makes a 3D plot of the selected matrix using the "3D mesh" style. &mesh-hidden-cmd; Makes a 3D plot of the matrix using the "3D mesh" style with hidden lines. &polygons-cmd; Makes a 3D plot of the matrix using the "3D polygons" style. &mesh-polygons-cmd; Makes a 3D plot of the matrix using the "3D polygons" style with the mesh drawn. &bars-cmd; Makes a 3D plot of the selected data column in the active table window (only one column allowed) using the "3D Bars" style. &scatter-cmd; Makes a 3D plot of the selected data column in the active table window (only one column allowed) using the "3D Dots" style. The 3D point symbol style can be changed via the 3D Plots Settings dialog. &contour-color-cmd; Makes a color map plot of the data in the active matrix window. The contour lines and the colormap settings may be changed by clicking on the plotting area, this will active the Contour Options Dialog. &contour-lines-cmd; Makes a contour plot of the data in the active matrix window. The contour lines and the colormap settings may be changed by clicking on the plotting area, this will active the Contour Options Dialog. &gray-scale-cmd; Makes a gray map plot of the data in the active matrix window. The contour lines and the colormap settings may be changed by clicking on the plotting area, this will active the Contour Options Dialog. This menu is active only when a plot is selected. Its commands can also be accessed by clicking on the icons of the &graph-toolbar-lnk; Data -> &pointer-cmd; When you are using a command which modify the pointer such as the &data-reader-cmd;, this command can be used to exit this special mode, and go back to the normal pointer behaviour. Data -> &zoom-in-cmd; (&zoom-in-key;) Switches the active plot layer to the zoom mode. The mouse cursor shape changes to a magnifying lens only inside the active plot canvas. You can select a window in the current plot which will be used as the new plotting window. Data -> &zoom-out-cmd; (&zoom-out-key;) This command cancel the previous zooming, a history of the zoom is kept so that you can do multiple zoom out commands. Data -> &rescale-cmd; (&rescale-key;) Rescale the active plot layer to its default parameters, and therefore cancel all the zoom operations which have been done. Data -> &screen-reader-cmd; Opens the Data Display toolbar and changes the mouse cursor shape to a small cross target. By keeping the left button pressed and moving the mouse you can view the coordinates of the cursor with respect to the axes of the active plot layer. Data -> &data-reader-cmd; (&data-reader-key;) Shows a red cross cursor and opens the Data Display toolbar giving easy and fast access to the values of the data points. You can select data points by moving the cursor with the Left and Right arrow keys or faster by clicking on them with the mouse. You can navigate through the curves on the plot layer using the Up and Down arrow keys. Data -> &select-data-range-cmd; (&select-data-range-key;) Shows two rectangular cursors that can be used for selecting the data range when performing analysis operations. The mouse cursor shape changes to a rectangular target only inside the active plot canvas. The active cursor is red, the other is black.You can move the active cursor with the arrows keys while keeping the Ctrl key pressed or faster by clicking on a curve point. You can change the active cursor using the Left and Right arrow keys. You can navigate through the curves on the plot layer using the Up and Down arrow keys. Data -> &move-data-points-cmd; (&move-data-points-key;) Allows you to modify the position of data points in the active plot layer by simple drag-and-drop. It opens the Data Display toolbar, for a better visualisation of the new coordinates. The changes you make automatically modify the data into the corresponding tables and all the plots depending on those data sets. You can cancel the modifications with the &undo-lnk;. Data -> &remove-data-points-cmd; (&remove-data-points-key;) Allows you to remove data points from the active plot layer by double-clicking on them. The coordinates of the points selected for removal are shown in the Data Display toolbar. The changes you make automatically modify the data into the corresponding tables and all the plots depending on those data sets. You can cancel the modifications with the &undo-lnk;, but you need to undo twice ro restore a point: the first one to create the removed point, and the second to put it at the right place in the plot. The commands which are available in this menu are not the same if a table or a plot is selected. For most analysis commands, you car refer to the tutorial in . &statistics-on-columns-cmd; Creates a new table providing basic statistical information about the selected columns in the active table: average, variance, standard deviation, max value, etc... You can select several columns in one table, one line will be created for each column. You can't select columns in different tables to obtain one single table of statistics. &statistics-on-rows-cmd; Creates a new table providing basic statistical information about the selected rows in the active table: average, variance, standard deviation, max value, etc... See the &statistics-on-columns-lnk; command for more details. &fft-on-tables-cmd; Computes a direct or inverse Fast Fourier Transform. See the of the for more details. &correlate-cmd; Does a cross-correlation of the two columns which are selected. See the of the for more details. &correlate-cmd; Does a correlation of the selected column with itself. See the of the for more details. &convolute-cmd; Does a convolution of the two columns which are selected. The first one being the response and the second the signal. See the of the for more details. &deconvolute-cmd; Does a deconvolution of the two columns which are selected. The first one being the response and the second the signal. See the of the for more details. &fit-wizard-table-cmd; (&fit-wizard-table-key;) Opens the Non-linear Fit dialog, allowing you to choose the curve to fit, the algorithm and the tolerance, the number of iterations to be performed, and to type the analytical function to use, the names of the fitting parameters and their initial guessed values. See the of the for more details. The following items are enabled only if the active window is a 2D Multilayer Plot Window. If the active plot layer contains more than one curve, and the Data Range Selectors are not enabled, a dialog window will pop-out allowing you to select the curve you want to analyse. In most of the cases (except for integration), a new red curve is added to the active plot layer and a a new table containing the data used to plot this curve is added to the workspace. Useful information about the operation performed will be showed in the &results-log-cmd;. The commands &fft-on-curves-lnk; and &fit-wizard-table-lnk; are presented in the &analysis-tables-menu-lnk;. &differentiate-cmd; Creates a new plot displaying the resulting curve of the numerical differentiation. The computation of the derivative is done by centered finite differences over the point before and the point after each data point: This command creates a new table which contains one column for X-values and one column for derivatives of Y-values. It also creates a new plot of the derivative. The numeric differentiation can generate a lot of noise for a given curve, and a smoothing may be necessary before this operation (see &smooth-lnk;). &integrate-cmd; Curve analysisIntegration Opens the integration dialog, allowing to choose the curve to integrate and the integration method. This command can't be used to obtain a cumulative curve from a selected curve, it can only compute the integral of the data between two limits. The first field is the curve that will be integrated. The second one is the order of the integration: the order 1 corresponds to the trapezoid rule, i.e. the curve is aproximated by a straight line between 2 successive points. If you choose the order 2, three successive points are used and a second order polynome is used to approximate the curve. etc. If you have a large amount of points in your curve, the order 1 is enough.

The result of the integration will be given in the &results-log-cmd;. &smooth-cmd; These commands will generate a new curve by dooing a smoothing ofthe selected curve. &savitsky-golay-cmd; This command performs a smoothing of the selected curve with the Savitzky-Golay method. The formula used to smooth the curve defined by the points yi=f(xi) is: The fi values are computed by fitting the data points to a polynome, they depend on the number of points used for the smoothing of the curve and the order of the polynome. Compared to the moving window average method, the advantage of this smoothing method is that the values of extrema are not truncated. The dialog allows to specify the curve which will be smoothed, the value of the order of the polynome, the number of data points used for the polynomial fit before and after each point and the color used to draw the smoothed curved. A new table will be created to store the data points xi, zi.

&moving-window-cmd; This command performs a smoothing of the selected curve with the moving window average method. The formula used to smooth the curve defined by the points yi=f(xi) is: The greater the number of points n, the smoother the resulting curve zi=f(xi) is. The dialog allows to specify the curve which will be smoothed, the value of n and the color used to draw the smoothed curve. A new table will be created to store the data points xi, zi.

Depending on the number of data points and on the variation of the Y values, smoothing can give very different results.

&moving-window-cmd; This command allow a smoothing based on FFT filtering of data. It can be used when you have noisy curves with a large number of data.

&fft-filter-cmd; &fft-low-pass-cmd; This command allows to filter the high frequencies of a signal. See the filtering section for more details. A dialog box will be opened in which you can select the curve to filter and the cut-off frequency of the filter. This command creates a new table with the filtered data, and a new curve will be added on the current plot. See of the for details. &fft-high-pass-cmd; This command allows to filter the low frequencies of a signal. See the filtering section for more details. A dialog box will be opened in which you can select the curve to filter and the cut-off frequency of the filter. This command creates a new table with the filtered data, and a new curve will be added on the current plot. See of the for details. &fft-band-pass-cmd; This command allows to filter the low and high frequencies of a signal. See the filtering section for more details. A dialog box will be opened in which you can select the curve to filter and the cut-off frequency of the filter. This command creates a new table with the filtered data, and a new curve will be added on the current plot. See of the for details. &fft-band-block-cmd; This command allows to keep the low and high frequencies of a signal. See the filtering section for more details. A dialog box will be opened in which you can select the curve to filter and the cut-off frequency of the filter. This command creates a new table with the filtered data, and a new curve will be added on the current plot. See of the for details. &interpolate-cmd; Performs an interpolation. The curve must have enough data points to compute the interpolated points, if not a warning message will be prompted out. The methods available to perform the interpolation are Linear (the curve must contain at least 3 points), Cubic Spline (the curve you analyse must contain at least 4 points, if not a warning message will be prompted out, Non-rounded Akima spline (the curve you analyse must contain at least 5 points). See the of the for a comparison of the differents methods. This command creates a new curve on the current plot, and a new table. &fft-on-curves-cmd; Performs a forward or inverse FFT transform of the selected curve. The inverse FFT transform of a forward transform will result in a data set identical to that used for the forward transform. &quick-fit-cmd; &fit-linear-cmd; Performs a linear fit of the selected curve. The results will be given in the Log panel &fit-polynomial-cmd; Opens the Polynomial Fit dialog, allowing you to choose the curve to fit, the order of the polynomial function to use, the number of points of the resulting curve and the abscissae limits for the fit. &fit-exp-decay-cmd; &fit-exp-decay-1-cmd; Opens the Exponential Fit dialog, allowing you to choose the curve to fit and the initial guesses for the fit parameters. &fit-exp-decay-2-cmd; Opens a dialog, allowing you to choose the curve to fit and the initial guesses for the fit parameters. &fit-exp-decay-3-cmd; Opens a dialog, allowing you to choose the curve to fit and the initial guesses for the fit parameters. &fit-exp-growth-cmd; Performs an exponential growth fit of the selected curve. &fit-lorentzian-cmd; Performs a lorentzian fit of the selected curve. It can be used to obtain a correlation equation of a bell shaped data set (see for details). &fit-gaussian-cmd; Performs a gaussian fit of the selected curve.It can be used to obtain a correlation equation of a bell shaped data set (see for details). &fit-bolzmann-cmd; Performs a fit to a bolzmann function of the selected curve. It can be used to obtain a correlation equation of a S shaped data set. (see for details). &fit-multipeak-cmd; &fit-multipeak-gaussian-cmd; Performs a fit to a sum of N gaussian functions of the selected curve. (see for details). &fit-multipeak-lorentzian-cmd; Performs a fit to a sum of N lorentz functions of the selected curve. (see for details). &fit-wizard-plot-cmd; (&fit-wizard-plot-key;) Performs a fit of the selected curve. This opens the general dialog for the fitting of curves. See the for a tutorial on this command. Some default parameters can be modified with the &preferences-lnk;, see the for details This menu is only active when a table is selected. For a general presentation of the tables, refer to the . &set-column-as-cmd; These commands are used to define the kind of data which is stored in the different columns of a table. They can also be accessed with the right mouse button when a column is selected in a table. &set-column-as-x-cmd; Define the selected column as abscissae for the plots. You can define more than one column as X-values in a tables, they will be referenced as X1, X2, etc. &set-column-as-y-cmd; In the case of 2D plots, this command defines the selected column as Y-values for the plots. In the case of 3D plots, Y columns can be used as the second abscissae. &set-column-as-z-cmd; In the case of 3D plots, Z columns will be used as plotted values. &set-column-as-x-error-cmd; Define the selected column for use as error bars width for abscissae. Note that the column is not related to a specific X column, you will have to specify the link to specific X values when the plot will be built. &set-column-as-y-error-cmd; Define the selected column for use as error bars for Y-values. Note that the column is not related to a specific Y column, you will have to specify the link to specific Y values when the plot will be built.. &set-column-as-none-cmd; The selected column can be used in different ways in several plots (as X values, Y values, etc). &fill-selection-with-cmd; This command is used to fill the selected column with special values. It can be applied to a limited selection of cells. These commands does not assign formulas to cells, they just fill in the cells with values. &fill-selection-with-row-number-cmd; The filling is done with the number of the corresponding rows. &fill-selection-with-random-values-cmd; The filling is done with random values between 0 and 1. &show-comments-cmd; If you select this command, the Comment field of the columns will be shown under the names of the columns. The name of the command will then change to hide comments. This command applies only to the selected table. See the for more details. &hide-controls-cmd; If you select this command, the Parameters part of the table will be shown. The name of the command will then change to hide controls. This command applies only to the selected table. See the for more details. &formula-edit-mode-cmd; If you select this command, the formula used in the different columns of the table will be shown. This command applies only to the selected table. In this mode, the formula assigned to each cell can be viewed and edited. This allows to use different formulas on each row of a column. Then, you can switch back to the normal mode and used the &recalculate-lnk; to view the numbers resulting from these formulas. &edit-column-description-cmd; This command is just a shortcut to the Description tab of the table. See the for details. &change-column-format-cmd; This command is just a shortcut to the Type tab of the table. See the for details. &clear-table-cmd; Removes all the values of the selected table. There is no confirmation window for this command, but you can use the &undo-lnk; to cancel. &sort-table-cmd; This command is used to sort the table. If you choose the option separately, only the selected column is sorted. If you choose together, all the columns are sorted based on the specified leading column. &assign-formula-cmd; TableColumnsFill with values This command is used to fill the selected column with the values resulting from a mathematical formula. This command will open the Formula tag in the properties dialog of the selected table. The available mathematical functions (assuming you are using the default scripting language, muParser) are listed in the . The special function col(x) can be used to access to the values of the column x, where x can be the column's number (as in col(2)) or its name in doublequotes (as in col("time")). You can also get values from other tables using the function tablecol(t,c), where t is the table's name in doublequotes and c is the column's number or name in doublequotes (example: tablecol("Table1","time")). The variables i and j can be used to access the current row and column numbers. Similarly, sr and er represent the selected start and end row, respectively. Using Python as scripting language gives you even more possibilities, since you can not only use arbitrary Python code in the function body, but also access other objects within your project. For details, see . If you make some changes in the table, the values are not computed again. You have to explicitly tell &appname; to recalculate individual cells or whole columns or rows by selecting &recalculate-lnk; from their context menu or pressing &recalculate-key;. &recalculate-cmd; When you fill a column (named for example 'C1') with the results of a formula (by using the &assign-formula-lnk;), the values of the column are calculated only once when you define the formula. If your formula depends on values of another column (name for example 'C2'), the values of 'C1' are not updated if you modify the values in 'C2'. This command is used to recalculate the values of the selected column. &add-column-cmd; Adds a new column in the table. Whatever the selected column, the new one will be inserted at the right of the table after the last column. If you want to insert a column between two existing ones, select the column and use Insert Empty Columns from the context menu. A new column will be created on the left of the selected column. &table-dimensions-cmd; Allows to define the number of columns in the table. Be carefull if you decrease the number of columns in a table, a number of columns will be removed and the data will be lost. Allows to define the number of rows in the table. Be carefull if you decrease the number of rows in a table, a number of rows will be removed and the data will be lost. &go-to-cell-cmd; Defines the active line in the selected table. &table-export-ascii-cmd; This command can be used to export the selected table to an ascii text file. If you check the option All, you will have to choose a directory in which one text file will be created for each table, the name of the files being the one of the tables. &convert-to-matrix-cmd; This command is used to convert a table into a matrix. It is mainly used to import data from files: the first step import data in a table, and the second one is the conversion of the table in a matrix. This menu is only active when a matrix is selected. See for details on matrices. &matrix-hide-controls-cmd; This command opens a dialog window which is used to specify the size of a matrix. It can also be used to specify the X and Y ranges which will be used as axis ranges for a 3D-plot of the matrix data. See for details. &set-coordinates-cmd; This command is just a shortcut to the Coordinates tab of the properties dialog of the selected matrix. See for details. &matrix-dimensions-cmd; This command opens a dialog window which is used to specify the size of a matrix. &set-display-format-cmd; This command is just a shortcut to the Format tab of the properties dialog of the selected matrix. See for details. &matrix-assign-formula-cmd; MatrixFill with a function This command is just a shortcut to the Formula tab of the properties dialog of the selected matrix. See for details. You can fill in a matrix with the results of a function z=f(i,j) in which i and j are the row and column numbers. If you have defined X-values and Y-values with the &set-coordinates-lnk; You can use x and y as parameters for the function. The functions can be written on several lines, and the intrinsic functions which are available are listed in the . &matrix-recalculate-cmd; This command apply the formula assigned to the matrix (with the &assign-formula-lnk;) to all the cells of the selected matrix. The values which may have been entered in some cells will be overwritten. &clear-matrix-cmd; Set all the values of the matrix to 0. There is no confirmation window but you can use the &undo-lnk; to cancel this command. The formula and the coordinates which may have been entered are not detroyed by this command. &transpose-cmd; Replace the selected matrix with the transposed one. If you want to keep a copy of the pristine matrix, use the &duplicate-window-lnk; before transposing. The matrix doesn't need to be square. Beware that the coordinate are not transposed. &mirror-horizontally-cmd; Mirror the values of the selected matrix horizontally. If you want to keep a copy of the pristine matrix, use the &duplicate-window-lnk; before mirroring. The coordinate are not mirrored. &mirror-vertically-cmd; Mirror the values of the selected matrix vertically. If you want to keep a copy of the pristine matrix, use the &duplicate-window-lnk; before mirroring. The coordinate are not mirrored. &matrix-import-image-cmd; This command is similar to &import-image-lnk; except the fact that it replace the selected matrix with the image matrix instead of creating a new matrix. &matrix-go-to-cell-cmd; You can specify the line and column number of a cell. &invert-cmd; Inverse the selected matrix. If you want to keep a copy of the pristine matrix, use the &duplicate-window-lnk; before mirroring. &determinant-cmd; Compute the determinant of the selected matrix. The result is given in the &results-log-lnk; &convert-to-table-cmd; Convert the selected matrix in a table. The pristine matrix is kept and a new table is created. The coordinates are lost. This menu is only active when a plot is selected. Refer to the for a tutorial on the formatting of 2D or 3D plots. &format-plot-cmd; 2D plot PlotSettings This command is used to set some general graphic parameters of the different layers and of the curves. Refer to the . In addition, you can specify some global parameters of the plot with the format dialog with the General tab selected. The canvas is the area defined by the axis, you can draw a box around this canvas and define a background color for this canvas. The background area is the global drawing area, you can also define a color border and a background color for this area. The margin parameter controls the distance between the drawing area limit and the canvas. If you want to modify the margin between the window limits and the drawing area, you must modify the layer parameters (manualy with the mouse or with the &arrange-layers-lnk;.

The parameters in the Axis group allow to modify the linestyle of the axes and of the ticks. 3D plot Surface plotSettings In the case of a surface plot, this command opens the surface plot options with the General plot options tab selected. In this case the aspect ratio of the plot can also be modified. The default behaviour is to use the perspective to compute the 3D plot. If you choose to check the Orthogonal check box, the plot will use vertical Z axis whatever the view angle of the plot.

--> &format-scales-cmd; 2D plot PlotScales Opens the format plot dialog with the scales tab selected. It allows to customize the ranges of the differents axes. It must be reminded that any modification in the table or in the plotted curves will result in a reset of these scales to the default values. In the case of a surface plot, this command opens the surface plot options with the scales options tab selected.

In this tab, you can also set the number of ticks used for each axis. This can be done in two ways: you can set the number of labels which are used for the whole scale. Whatever the number you enter, &appname; will use a value which leads to a pretty plot: for example, if you enter 7 ticks for a 0..100 scale, &appname; will use 10 major ticks from 10 to 10. If you want to fix non classical values, you can select the step method. 3D plot Surface plotScales The first tab is used to modify the X, Y and Z ranges. It allows also to specify the number of labels on the axis and the number of secondary ticks.

&format-axes-cmd; 2D plot PlotAxis Opens the format plot dialog with the axes tab selected. It allows to customize the settings for the different axes such as the size and color of axes and ticks, the label of the axes, etc. The third tab is used to modify the setting of the different axis. You must select the axis that must be customized in the right window. The label of the axis can be modified in the title window, see the text dialog section for more details.

3D plot Surface plotAxis In the case of a surface plot, this command opens the surface plot options with the axis options tab selected. The second tab defines the main parameters of the three axis: the axis label and its font, and the length of the ticks. This length is defined in the same units as the range of the axis. If something is changed in the scales of the graph, the length of the ticks is re-calculated by &appname;. The font button allows to modify only the font used for the label, if you want to customize the font of the numbers used for the axis, you must used the fifth tab. &format-grid-cmd; 2D plot PlotGrids Opens the format plot dialog with the grid tab selected. It allows to add and customize grid lines on the different axes. The grid tab is used to draw grid lines on the plot. The frequency of the lines are related to the number of label and major ticks set with the Scale tab.

If the selected plot is a surface plot, this menu item is not showed. &format-title-cmd; 2D plot PlotTitle Opens a text dialog, allowing you to modify the title of the plot and its properties (color, font, alignement). See the . 3D plot Surface plotTitle In the case of a surface plot, this command opens the surface plot options with the title options tab selected. You can not add subscripts, superscripts, bold characters, etc in your title as you can do it for 2D plots.

Additionaly to the items listed bellow, this menu will also display a list with the first ten windows created in the workspace. These windows can be made active or can be shown if they are hidden, by selecting their name from the list. If your project contains more then ten windows, you must use the Project explorer in order to perform these operations. Cascade Arranges the visible windows in the project in a cascading style. Tile Tiles the visible windows in the project. Next (F5) Makes the next visible window in the workspace stack the active window. Previous (F6) Makes the previous visible window in the workspace stack the active window. Rename Window Opens a dialog allowing to change the title of the active window. Duplicate Clonates the active window. Window Geometry... Opens a dialog allowing to change the size and the position of the active window. The size of the plot will be adapted to the new window size. Hide Window Hides the active window. A hidden window can be made visible again via the Project explorer. Close Window (Ctrl-W) Closes the active window. You will be prompted out a question dialog asking you to confirm the operation, if you checked this option in the Preferences dialog ("Confirmations" tab). &help-cmd; If you have configured the help folder with the &help-folder-cmd;, this command will launch the qt-assistant help browser. The last version of scidavis manual can be obtained from &kappdownload;. &help-folder-cmd; Let you define the folder which contain the &appname; manual. The manual should be in html version. &project-homepage-cmd; This command launch the default browser of your system with the home page of the &appname; project opened. &search-updates-cmd; Let &appname; look for updates. You should have an effective internet connection to use this command. &download-manual-cmd; Download the last version of the &appname; manual from the &kappdownload; site. &translations-cmd; Look for available translation files on the &kappdownload; site. &visit-forum-cmd; This command launch the default browser of your system with the forum page of the &appname; project opened. &report-bug-cmd; This command launch the default browser of your system with the bug page of the &appname; project opened. &about-cmd; Open the window which shows the version and the credits of &appname;.