# Command Reference

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.

# The File Menu

These commands can also be done by clicking on the New Project icon from the File Toolbar

File-> New ->
  &new-project-cmd; (&new-project-key;)

    Creates a new QtiPlot project file. 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.

  &new-folder-cmd; (&new-folder-key;)

    Adds a new folder to the project. The new folder is added to the current folder.

  &new-table-cmd; (&new-table-key;)

    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 &rows-lnk; and &columns-lnk; of the &table-menu-lnk;.

    The properties of each column (format of numbers, width, etc) can be modified by the &column-options-lnk; of the &table-menu-lnk;. See the table section for more details.

  &new-matrix-cmd;

    Creates a new Matrix into the project. The empty matrix will have 32x32 cells, these dimensions can be changed by the &set-dimensions-lnk; of the &matrix-menu-lnk;

    See the matrix section for more details.

  &new-note-cmd;

    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.

  &new-graph-cmd;

    Creates a new empty 2D plot in the project. This default graph is just a framework in which you can add curves with the &add-remove-curve-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;)

    Opens a dialog allowing to create a 3D plot by specifying an analytical function. Only cartesian coordinates are availables. See the 3D plot section of the tutorial for more detail on this function.

File -> &open-cmd; (&open-key;)

  Opens an existing QtiPlot project file (.qti). If your project has been save in a compressed format, you must select the .qti.gz file format.

  This command can also be used to open projects which have been built with the Origin software.

File-> &recent-projects-cmd;

  Opens a list of the most recently used QtiPlot 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;

  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 ( .qti.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; plot file (.qpt). This command will create a new empty plot with the same graphical parameters (window geometry, fonts, colors, etc).

  The first figure is the initial plot saved as a template, and the second one is the empty plot created by the &open-template-cmd;.

  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.

File -> &save-as-template-cmd;

  Save the active plot as a &appname; template file (.qpt). In this template, 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 show options check box. Depending on the chosen image format, the available options are not the same.

  For bmp, pbm, jpeg, xbm, pgm, ppm image formats, the only option is the quality of the image, this parameter between 0 and 100% defines the compression ratio. The higher it is, the best the quality is but the larger the file is. For png, tiff and xpm, you can choose to use a transparent background.

  For eps, pdf, psfile formats, the option dialog is different. The main parameters availables are: the resolution and the size of the paper which is used to draw the plot. of the paper sheet. The default value for the resolution is the screen resolution. If you increase this parameter, the quality of the graphic elements will be better (but the overall size of the plot will be unchanged).

  By default the plot is exported to a page size that fits best its real size on screen, but if you want you can choose a different page size, by checking the Custom page size option. The orientation of the exported image will be automatically adapted to the sheet size.

  In addition, you have the option to Keep the aspect ratio of the plot. If you leave this box unchecked, the exported image will be scaled to the entire sheet size, in order to avoid blank margins around the plot and therefore the width/height ratio of the plot will be modified.

  &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.

File-> &print-cmd; (&print-key;)

  Prints the active plot. A print dialog is opened where you can select the printer, different paper sizes, 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;

  Opens the &export-ascii-cmd; dialog allowing to save the data from the active spreadsheet to an ASCII file.

File -> &import-ascii-cmd; (&import-ascii-key;)

  The options for the importation of ASCII data files are set by the Import dialog.

File -> &quit-cmd; (&quit-key;)

  Closes the application. You will be asked wether you want to save your last changes or not.

# The Edit Menu

Edit -> &undo-cmd; (&undo-key;)

  Restores the last modified table at the state it had after the last "Save Project" operation. Not available for plot windows.

Edit -> &redo-cmd; (&redo-key;)

  Restores the modifications in a table after a "Undo" operation. Function not available for plot windows.

Edit -> &cut-cmd; (&cut-key;)

  Copies the current selection to the clipboard and deletes the selection. It currently works for spreadsheets and for 2D plots objects.

Edit -> &copy-cmd; (&copy-key;)

  Copies the current selection to the clipboard. It currently works for spreadsheets and for 2D plots objects.

Edit -> &paste-cmd; (&paste-key;)

  Pastes the content of the clipboard to the active window.

Edit -> &delete-cmd; (&delete-key;)

  Cleares the current selection. It 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-cmd;

  Deletes from the project file all the history information about the analysis operations performed by the user. The log panel is then empty.

# The View Menu

View -> &toolbars-cmd; (&toolbars-key;)

  Opens a pop-up menu allowing to enable/disable tool bars.

View -> &plot-wizard-cmd; (&plot-wizard-key;)

  Opens the Plot Wizard dialog.

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.

View -> &results-log-cmd;

  Opens/Close a panel displaying the historic of the data analysis operations performed by the user.

View -> &preferences-cmd;

  Opens the Preferences dialog.

# The Graph Menu

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.

Graph -> &add-error-bars-cmd; (&add-error-bars-key;)

  Opens the &add-error-bars-cmd; dialog. You can add error bars on X and/or on Y values on an existing plot.

Graph -> &add-function-cmd; (&add-function-key;)

  Opens the &add-function-cmd; dialog. This command allows to add a a new curve on an existing plot.

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 -> &add-text-cmd; (&add-text-key;)

  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...)

Graph -> &draw-arrow-cmd; (&draw-arrow-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 Arrow dialog. You can swith back to the normal operating mode by clicking the "Pointer" icon in the Plot toolbar.

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 -> &add-layer-cmd; (&add-layer-key;)

  Opens a dialog allowing you to select whether the new layer is to be added to the left-top corner of the plot window or to a best-guess position (based on a layer positioning algorithm in columns and rows).

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;)

  Opens the Arrange layers dialog, allowing you to custom the layout of the active 2D plot window.

# The Plot Menu

This menu is active only when a table is selected. These commands allow to plot the data selected in the active table.

&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 with the Custom curves dialog.

&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 with the Custom curves dialog.

&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 with the Custom curves dialog.

&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 with the Custom curves dialog.

  &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 with the Custom curves dialog.

  &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 with the Custom curves dialog.

  &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 with the Custom curves dialog.

&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.

&pie-cmd;

  Creates a 2D Pie plot of the selected column in the active table window (only one column allowed).

&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.

&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.

Statistical Graphs ->

  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 with the Custom curves dialog.

  &histogram-cmd;

    Creates a frequency histograms of the selected data columns in the active table window. The default binning uses 10 steps between the max and the min of Y-values. This can be modified with the Custom curves dialog.

    With this command, a frequency distribution is computed from your data. If you want to draw an histogram directly from values, use the &bars-cmd;.

  &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 ->

  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).

Data -> Plot 3D ->

  &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 &plot3d-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.

# The Plot 3D menu

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.

# The Data Menu

This menu is active only when a plot is selected.

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 after a zoom operation.

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. The [Home] key makes the data reader jump to the beginning of the selected curve and the [End] key to its end point.

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. When this tool is active you can easily copy, paste or cut the whole selected data range, using the well-known shortcuts: Ctrl+C, Ctrl+V and Ctrl+X, respectively.

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 -> &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.

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.

# The Analysis Menu

The commands which are available in this menu are not the same if a table or a plot is selected.

## Commands for the analysis of data in tables

&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.

&sort-column-cmd;

  Sorts the columns selected. If more than one column is selected, you can sort them:

  - separately: each column will be sorted in ascending or descending order

  - together: the column selected as leading column will be sorted in ascending or descending order, and the others column selected will be sorted in order to keep the rows unchanged.

&sort-table-cmd;

  This is the same command as &sort-column-cmd; but it operate on all columns of the active table.

&normalize-cmd;

  Normalizes the columns selected, that is modify the data in order to obtain a range of 0 to 1. All columns selected are normalized separately. This command doesn't create new normalized columns but replace the values of the selected columns.

  &normalize-column-cmd;

    Normalizes the selected column.

  &normalize-table-cmd;

    Normalizes all the columns of the table, it is not a global normalization of all values of the table: each column is normalized separately.

&fft-cmd;

  Computes a direct or inverse Fast Fourier Transform. The parameters used can be set with the FFT dialog. See the fft section of the Analysis chapter for more details.

&correlate-cmd;

  Does a cross-correlation of the two columns which are selected. See the correlate section of the Analysis chapter for more details.

&autocorrelate-cmd;

  Does a cross-correlation of the selected column. See the correlate section of the Analysis chapter 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 convolution section of the Analysis chapter 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 deconvolution section of the Analysis chapter for more details.

&non-linear-curve-fit-cmd; (&non-linear-curve-fit-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 Non Linear Curve Fit section of the Analysis chapter for more details.

## Commands for the analysis of curves in plots

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 display.

The commands &fft-cmd; and &non-linear-curve-fit-cmd; are presented in the Table Analysis Menu.

Analysis -> Differentiate

  Creates a new plot displaying the resulting curve of the numerical differentiation. The computation of the derivative is done by centered finite diferences.

  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.

Analysis -> Integrate...

  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 result is given in the Log Panel.

Analysis -> Smooth

  .

  Savitski-Golay

    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.

    ### The &savitsky-golay-cmd; dialog.

  Moving Window Average...

    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.

    ### The &moving-window-cmd; dialog.

Analysis -> FFT Filter

  Low Pass...

    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.

    ### The &fft-low-pass-cmd; dialog.

    This command creates a new table with the filtered data, and a new curve will be added on the current plot.

  High Pass...

    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.

    ### The &fft-high-pass-cmd; dialog.

    This command creates a new table with the filtered data, and a new curve will be added on the current plot.

  Band Pass...

    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.

    ### The &fft-band-pass-cmd; dialog.

    This command creates a new table with the filtered data, and a new curve will be added on the current plot.

  Band Block...

    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.

    ### The &fft-band-block-cmd; dialog.

    This command creates a new table with the filtered data, and a new curve will be added on the current plot.

Analysis -> Interpolate...

  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 Akime spline (the curve you analyse must contain at least 5 points). See the Analysis chapter for a comparison of the differents methods.

  ### The &interpolate-cmd; dialog.

  This command creates a new curve on the current plot, and a new table.

Analysis -> &fft-cmd;

  Performs a forward or inverse FFT transform of the selected curve. The parameters used can be set with the FFT dialog.

  The inverse FFT transform of a forward transform will result in a data set identical to that used for the forward transform.

Analysis -> Fit Linear

  Performs a linear fit of the selected curve. The results will be given in the Log panel

Analysis -> Fit Polynomial...

  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.

Analysis -> Fit Exponential Decay

  First Order...

    Opens the Exponential Fit dialog, allowing you to choose the curve to fit and the initial guesses for the fit parameters.

  Second Order...

    Opens a dialog, allowing you to choose the curve to fit and the initial guesses for the fit parameters.

  Third Order...

    Opens a dialog, allowing you to choose the curve to fit and the initial guesses for the fit parameters.

Analysis -> &fit-exp-growth-cmd;

  Performs an exponential growth fit of the selected curve.

Analysis -> &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.

Analysis -> &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.

Analysis -> &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.

Analysis -> &fit-multipeak-gaussian-cmd;

  Performs a fit to a sum of N gaussian functions of the selected curve.

Analysis -> &fit-multipeak-lorentzian-cmd;

  Performs a fit to a sum of N lorentz functions of the selected curve.

# The Table Menu

This menu is only active when a table is selected.

&set-column-as-cmd;

  These commands are used to define the kind of data which is stored in the different columns of 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.

  &set-column-as-y-error-cmd;

    Define the selected column for use as error bars for Y-values.

  &set-read-only-column-cmd;

    Set the selected columns as read-only.

  &set-read-write-column-cmd;

    Restore the write acess to the selected columns.

  &set-column-as-none-cmd;

    The selected column can be used in different ways in several plots (as X values, Y values, etc).

Column Options...

  This command is used to define the global parameters of each column such as numeric format, column name, etc. See the corresponding dialog box section for more details.

&set-column-values-cmd;

  This command is used to fill the selected column with the values resulting from a mathematical formula. See the corresponding dialog box section for more details.

&recalculate-cmd;

  When you fill a column (named for example 'C1') with the results of a formula (by using the &set-column-values-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.

Fill column with

  This command is used to fill the selected column with special values:

  &fill-column-with-row-number-cmd;

    The filling is done with the number of the corresponding rows.

  &fill-column-with-random-values-cmd;

    The filling is done with random values between 0 and 1.

&clear-cmd;

  Removes all 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 left column.

&columns-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.

&move-column-first-cmd;

  Moves the selected column to the beginning of the table.

&move-column-left-cmd;

  Moves the selected column to the left.

&move-column-right-cmd;

  Moves the selected column to the right.

&move-column-last-cmd;

  Moves the selected column to the end of the table.

&swap-columns-cmd;

  Swap the selected columns.

&rows-cmd;

  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-row-cmd;

  Defines the active line in the selected table.

&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.

# The Matrix Menu

This menu is only active when a matrix is selected.

&set-properties-cmd;

  This command opens a dialog window which is used to specify some view parameters of the matrix (cell width, format of numbers).

&set-dimensions-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.

&set-values-cmd;

  This command opens a dialog window which is used to fill in a matrix with the result of a function z=f(i,j) in which i and j stand for the row and column numbers.

&recalculate-cmd; (&recalculate-key;)

  This command allows to recalculate the matrix cell values using a predefined formula.

&rotate90-cmd; (&rotate90-key;)

  This command performes a clockwise 90 degrees rotation of the active matrix.

&rotate-90-cmd; (&rotate-90-key;)

  This command performes a counterclockwise 90 degrees rotation of the active matrix.

&flipV-cmd; (&flipV-key;)

  Flips vertically the selected matrix.

&flipH-cmd; (&flipH-key;)

  Flips horizontally the selected matrix.

&transpose-cmd;

  Transpose the selected matrix.

&invert-cmd;

  Inverse the selected matrix.

&determinant-cmd;

  Compute the determinant of the selected matrix.

&go-to-row-cmd; (&go-to-row-key;)

  This command opens a dialog allowing to select a row index that will become the current row in the selected matrix.

View

  &image-view-cmd; (&image-view-key;)

    Displays the selected matrix as an image.

  &table-view-cmd; (&table-view-key;)

    Displays the selected matrix as a data table.

Palette

  &gray-scale-cmd;

    If the selected matrix is viewed as an image, this command sets its palette to a gray scale.

  &rainbow-palette-cmd;

    If the selected matrix is viewed as an image, this command sets its palette to a predefined color scale.

  &custom-palette-cmd;

    Opens a dialog allowing to customize the palette of the selected matrix, in case this is displayed as an image.

&show-col-row-cmd; (&show-col-row-key;)

  By checking this option the horizontal and vertical headers of the selected matrix will display the column/row indexes.

&show-x-y-cmd; (&show-x-y-key;)

  By checking this option the horizontal and vertical headers of the selected matrix will display the x/y coordinates.

&convert-to-table-cmd;

  Convert the selected matrix in a table.

# The Format Menu

This menu is only active when a plot is selected.

&format-plot-cmd;

  In the case of a classical 2D plot, opens the format plot dialog with the general plot options tab selected. It allows to customize the line styles and colors of plot frame, etc.

  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.

&format-curves-cmd;

  Opens the Custom Curves dialog. It allows to customize the line style and colors used to draw curves.

  If the selected plot is a surface plot, this menu item is not showed.

&format-scales-cmd;

  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.

&format-axes-cmd;

  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.

  In the case of a surface plot, this command opens the surface plot options with the axis options tab selected.

&format-grid-cmd;

  Opens the format plot dialog with the grid tab selected. It allows to add and customize grid lines on the different axes.

  If the selected plot is a surface plot, this menu item is not showed.

&format-title-cmd;

  Opens a text options dialog, allowing you to modify the title of the plot and its properties (color, font, alignement).

  In the case of a surface plot, this command opens the surface plot options with the title options tab selected.

# The Scripting Menu

Scripting -> &script-language-cmd;

  Opens a dialog allowing to choose the scripting language for the current project.

Scripting -> &restart-scripting-cmd;

  Reinitializes the scripting environement.

Scripting -> &add-custom-action-cmd;

  Opens the Custom Action dialog, which allows you to define menu items and toolbar buttons used to launch Python scripts.

If the actif window in the project is a Notes window, the following items are also available in the menu:

Scripting -> &execute-cmd; (&execute-key;)

  Executes the line where the mouse cursor is placed in the Notes window.

Scripting -> &preferences-cmd; (&execute-all-key;)

  Executes all lines in the Notes window.

Scripting -> &evaluate-cmd; (&evaluate-key;)

  Evaluates the line where the mouse cursor is placed in the Notes window.

# The Window Menu

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.

Folders

  Opens a menu displaying a list of all the folders and subfolders in the project. The active folder is toggled. You can change the active folder in the project by selecting an item from this list.

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.

Script Window (F3)

  Opens the script console 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).

# Customization of 3D plots

Theses commands are not available through any menu nor by any keyboard shortcut. They can be accessed through the 3D toolbar.

&frame-cmd;

  This command can be accessed by a click on the &frame-icon;

  Draws only the three axis on the active 3D plot.

&box-cmd;

  This command can be accessed by a click on the &box-icon;

  Draws the three axis on the active 3D plot, and a box around it.

&no-axes-cmd;

  This command can be accessed by a click on the &no-axes-icon;

  Doesn't draw the three axis nor the box on the active 3D plot.

&front-grid-cmd;

  This command can be accessed by a click on the &front-grid-icon;

  Draws a grid on the front panel of the active 3D plot. The position of this grid is the plan defined by y=ymin.

&back-grid-cmd;

  This command can be accessed by a click on the &back-grid-icon;

  Draws a grid on the back panel of the active 3D plot. The position of this grid is the plan defined by y=ymax.

&left-grid-cmd;

  This command can be accessed by a click on the &left-grid-icon;

  Draws a grid on the left panel of the active 3D plot. The position of this grid is the plan defined by x=xmin.

&right-grid-cmd;

  This command can be accessed by a click on the &right-grid-icon;

  Draws a grid on the right panel of the active 3D plot. The position of this grid is the plan defined by x=xmax.

&top-grid-cmd;

  This command can be accessed by a click on the &top-grid-icon;

  Draws a grid on the top panel of the active 3D plot. The position of this grid is the plan defined by z=zmax.

&floor-grid-cmd;

  This command can be accessed by a click on the &floor-grid-icon;

  Draws a grid on the floor panel of the active 3D plot. The position of this grid is the plan defined by z=zmin.

&perspective-cmd;

  This command can be accessed by a click on the &perspective-icon;

  Enables/Disables the 3D perspective mode.

&reset-rotation-cmd;

  This command can be accessed by a click on the &reset-rotation-icon;

  Resets the rotation of the 3D plot to the default values.

&autoscale-cmd;

  This command can be accessed by a click on the &autoscale-icon;

  Finds the best layout of the 3D plot fitting the window size. It readjusts the length of the axis ticks to a default value.

&bar-style-cmd;

  This command can be accessed by a click on the &bar-style-icon;

  If the active 3D plot is a 3D histogram, this command is used to modify the style of the bars.

&dots-cmd;

  This command can be accessed by a click on the &dots-icon;

  If the active 3D plot is a 3D scatter, this command is used to modify the style of the data points to dots.

&cones-cmd;

  This command can be accessed by a click on the &cones-icon;

  If the active 3D plot is a 3D scatter, this command is used to modify the style of the data points to cones. It is then possible to modify the drawing parameters of the cones by double clicking on the plotting area.

&cross-hairs-cmd;

  This command can be accessed by a click on the &cross-hairs-icon;

  If the active 3D plot is a 3D scatter, this command is used to modify the style of the data points to cross-hairs. It it then possible to modify the drawing parameters of the crosses by double clicking on the plotting area.

&mesh-cmd;

  This command can be accessed by a click on the &mesh-icon;

  If the active 3D plot is a 3D surface, this command is used to modify the style of the surface to a simple wireframe.

&mesh-hidden-cmd;

  This command can be accessed by a click on the &mesh-hidden-icon;

  If the active 3D plot is a 3D surface, this command is used to modify the style of the surface to a wireframe. A computation of the hidden line is done.

&polygons-cmd;

  This command can be accessed by a click on the &polygons-icon;

  If the active 3D plot is a 3D surface, this command is used to modify the style of the surface to polygons.

&mesh-polygons-cmd;

  This command can be accessed by a click on the &mesh-polygons-icon;

  If the active 3D plot is a 3D surface, this command is used to modify the style of the surface to polygons with a mesh.

&floor-cmd;

  This command can be accessed by a click on the &floor-icon;

  If the active 3D plot is a 3D surface, this command is used to add a filled area projection of the surface on the floor of the plot.

&isolines-cmd;

  This command can be accessed by a click on the &isolines-icon;

  If the active 3D plot is a 3D surface, this command is used to add an isoline.

&empty-cmd;

  This command can be accessed by a click on the &empty-icon;

  If the active 3D plot is a 3D surface, this command is used to remove any projection from the floor.

&animation-cmd;

  This command can be accessed by a click on the &animation-icon;

  Enables/disables animation.