diff --git a/doc/index.docbook b/doc/index.docbook
index af92a46ae..a1e22ff99 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -1,2491 +1,2491 @@
ATEX">
EX">
LabPlot">
]>
The &LabPlot; Handbook
Stefan
Gerlach
stefan.gerlach@uni-konstanz.de
Alexander
Semke
Alexander.Semke@web.de
Yuri
Chornoivan
yurchor@ukr.net
Garvit
Khatri
garvitdelhi@gmail.com
2007-2016
Stefan Gerlach
2008-2015
Alexander Semke
2014
Yuri Chornoivan
&FDLNotice;
2016-12-24
3.3.1
&LabPlot; is a program for two-dimensional function plotting and data analysis.
KDE
LabPlot
plot
Introduction
&LabPlot; is a &kde; application for interactive graphing and analysis of scientific data. &LabPlot; provides an easy way to create, manage and edit plots.
Features:
Project-based management of data
Project-explorer for management and organization of created objects in different folders and sub-folders
Spreadsheet with basic functionality for manual data entry or for generation of uniform and non-uniform random numbers
Import of external ASCII-data into the project for further editing and visualization
Export of spreadsheet to an ASCII-file
Worksheet as the main parent object for plots, labels &etc;, supports different layouts and zooming functions
Export of worksheet to different formats (pdf, eps, png and svg)
Great variety of editing capabilities for properties of worksheet and its objects
Cartesian plots, created either from imported or manually created data sets or via mathematical equation
Definition of mathematical formulas is supported by syntax-highlighting and completion and by the list of thematicaly grouped mathematical and physical constants and functions
Investigation of plotted data is supported by many zooming and navigation features
Several analysis functions and methods for data reduction, differentiation, integration, interpolation, smoothing, (nonlinear) fitting, Fourier filter and Fourier transform
Linear and non-linear fits to data, several fit-models are predefined and custom models with arbitrary number of parameters can be provided
Supports many CAS backends like Maxima, Python, KAlgebra, Sage
Nice Worksheet view for evaluating expressions
Easy plugin based structure to add different Backends
Plugin based assistant dialogs for common tasks (like integrating a function or entering a matrix)
Datapicker for manual or (semi-)automatic data extraction from imported images containing plots and curves.
Using &LabPlot;
Interface Overview
&LabPlot; follows the MDI (Multiple Document Interface) philosophy - all the created application objects are placed as sub-windows in the Main Area of the application window. The Project Explorer serves as the tool to create and organize those objects in a tree-like structure.
The Properties Explorer is used to modify the properties of the currently selected object(s).
Many functions are reachable via the main menu and via object specific toolbars and context menus. Additional information and application notifications are shown in the status bar.
The default &LabPlot; window
Project Explorer
The Project Explorer is the main part of &LabPlot; aimed to handle its objects. Objects are organized in a tree-like structure representing the parent-child relations between the different objects.
Folders and sub-folders can introduce additional grouping for the different objects.
Project explorer is a dockable window and can be placed at an arbitrary place. The user can determine which columns should be shown by selecting/deselecting the columns of interest in the context menu (&RMB; click on an empty place in the tree-view or its header). Furthermore, the list of shown objects can be reduced by providing a filter in the Search/Filter text field.
Main Area
Created objects having a view (like worksheet, spreadsheet &etc;) are placed in the main area of the application. Depending on the current setting for the user interface, windows are placed either as independent and freely moveable sub-windows (interface "Sub-window view") or as tabs in a tabbed view (interface "Tabbed view").
When sub-windows are used, all windows of objects belonging to the currently selected folder only are shown. Alternatively, the visibility of windows can be extended to the currently selected folder and its sub-folders or to all windows in the project. This behaviour is controlled via the parameter "Window visibility policy" accessible via the context menu of the project explorer.
Properties Explorer
Properties explorer allows the user to modify the currently selected object in the project explorer. A great variety of object properties can be edited in undoable/redoable way. Editing of multiple objects of the same time is also possible.
Properties explorer is a dockable window and can be placed at an arbitrary place.
Spreadsheet
The spreadsheet is the main part of &LabPlot; when working with data and consists of columns.
Column is the basic data set in &LabPlot; used for plotting and data analysis.
Every column of the spreadsheet is specified by its name and the type - numeric, text, month names, day names and date and time.
Also, for each type different representation formats can be assigned like decimal or scientific format for numeric columns &etc;
You can mask selected data points in the spreadsheet (SelectionMask Selection from the spreadsheet cell context menu).
Masked data is not plotted and is also excluded from data analysis functions like fitting &etc;
Alternatively, you can mask or drop values in a column (Mask Values or Drop Values from the column context menu) by specifying a range.
When specifying which values to mask or to drop, several operators (“equal to”, “greater than”, “lesser than”, &etc;) are available.
These operations can help to hide or to remove some outliers in the data set prior to, ⪚, performing a fit to this data set.
Any spreadsheet function can be reached via the context menu (&RMB; click).
You can cut, copy and paste between spreadsheets, generate, normalize and sort data and finally make plots out of your data.
New data can be produced either by entering it manually in the spreadsheet or by generating the data according to a certain prescription.
&LabPlot; provides 5 different methods to generate data, accessible via the context menu of the column:
Row Numbers - values in the column are set according to its row number, this provide an easy way to quickly create an index.
Const Values - values in the column are set to a constant value provided by the user.
Equidistant values (for numeric columns only) - given the minimal and the maximal values, the equidistant values can be either generated
by fixing the total number of values in that range or by fixing the increment (distance).
Random values (for numeric columns only) - values are randomly generated according to the selected distribution.
To generate uniformly distributed random numbers, select "Flat" distribution.
In the simplest cases a non-uniform distribution is calculated analytically from the uniform distribution of a random number generator by applying
an appropriate transformation. More complicated distributions are created by the acceptance-rejection method, which compares the desired distribution
against a distribution which is similar and known analytically.
Function values (for numeric columns only) - values are generated according to a mathematical function provided by the user,
a column (data set) containing the function arguments has to be provided.
It is possible to define a multivariant function and to provide a data set (a column in a spreadsheet) for each of the variables.
The corresponding dialog supports the creation of arbitrary number of variables.
Already existing data can be imported into a spreadsheet from external files via the "Import Data" dialog.
Imported data will be stored in the project file. Changes on data, performed either in the spreadsheet or in the external file after the import, are not synchronized anymore.
The data in the spreadsheet can be exported to an external file (see Export Dialog).
Matrix
Matrix is another container for matrix-like data. This container is presented like a table or, alternatively, as a two-dimensional greyscale image.
The elements of such a table/matrix can be thought as being the Z-values, Z=Z(X,Y), with X and Y values being the row and column numbers, respectively.
The transition from the row and column numbers to the logical coordinates is done via an explicit user-defined mapping of both representations.
The matrix data can either be entered manually or via an import from an external file.
Similar to the data generation for a column in a spreadsheet, the matrix can be filled with constant values or via a formula, too.
The screenshot below shows the image view of a matrix together with the formula that was used to generate the matrix elements:
Workbook
Workbook helps the user to better organize and to group different data containers (Spreadsheet and Matrix).
This object serves as the parent container for multiple Spreadsheet- and/or Matrix-objects and puts them together in a view with multiple tabs:
With folders it is already possible to bring some structure in the Project Explorer and to group together several related objects
(spreadsheets with data stemming from text files of similar origin, red, green and blue values of an image imported into three different matrices, &etc;).
With Workbook the user has the possibility for another additional grouping.
Worksheet
The worksheet is, besides the data containers Spreadsheet and Matrix, another central part of the application and provides an area for showing and grouping together different kinds of worksheet objects - plots, labels &etc;
Worksheets can either have a fixed size (a user defined size or one of the predefined sizes like A4, Letter &etc;) or they can fill out the complete available area for the worksheet window. Multiple plots can be arranged on the worksheet in a vertical, horizontal or grid layouts.
Many properties of the worksheet like size, background colour and layout settings can be changed in the "Worksheet properties" pane.
Different worksheet actions dealing with the creation of new objects, changing of the current mouse mode or zooming can be accessed via the toolbar, main menu or the context menu of the worksheet in the project explorer.
The results shown on the worksheet can be exported to different formats via the export dialog.
CAS Worksheet
The CAS worksheet is, besides the worksheet, the third central part of the application and provides an area to you use your favorite mathematical applications from within an elegant Worksheet Interface.
&LabPlot; offers you several choices for the backends you wish to use with it. The choice to make depends on what you want to achieve.
Currently the following backends are available:
Sage:
Sage is a free open-source mathematics software system licensed under the GPL.
It combines the power of many existing open-source packages, within a common Python-based interface.
See http://sagemath.org for more information.
Maxima:
Maxima is a system for the manipulation of symbolic and numeric expressions,
including differentiation, integration, Taylor series, Laplace transforms,
ordinary differential equations, systems of linear equations, polynomials, sets,
lists, vectors, matrices, and tensors. Maxima yields high-precision numeric results
by using exact fractions, arbitrary precision integers, and variable precision
floating point numbers. Maxima can plot functions and data in two and three dimensions.
See http://maxima.sourceforge.net for more information.
R:
R is a language and environment for statistical computing and graphics, similar to the S language and environment.
It provides a wide variety of statistical (linear and nonlinear modelling,
classical statistical tests, time-series analysis, classification, clustering, ...)
and graphical techniques, and is highly extensible. The S language is often the
vehicle of choice for research in statistical methodology,
and R provides an open-source route to this.
See http://www.r-project.org for more information.
&kalgebra;:
&kalgebra; is a MathML-based graph calculator, that ships with &kde; Education project.
See http://edu.kde.org/kalgebra/ for more information.
Qalculate!:
Qalculate! is not your regular software replication of the cheapest
available calculator. Qalculate! aims to make full use of the superior
interface, power and flexibility of modern computers. The center of
attention in Qalculate! is the expression entry. Instead of entering each
number in a mathematical expression separately, you can directly write the
whole expression and later modify it. The interpretation of expressions is
flexible and fault tolerant, and if you nevertheless do something wrong,
Qalculate! will tell you so. Not fully solvable expressions are however not
errors. Qalculate! will simplify as far as it can and answer with an
expression. In addition to numbers and arithmetic operators, an expression
may contain any combination of variables, units, and functions.
See http://qalculate.sourceforge.net/ for more information.
Python2:
Python is a remarkably powerful dynamic programming language that is used
in a wide variety of application domains. There are several Python packages
to scientific programming.
Python is distributed under Python Software Foundation license (GPL compatible).
See the official website for more information.
This backend adds an additional item to the &cantor;'s main menu, Package. The only item of this menu is PackageImport Package. This item can be used to import Python packages to the worksheet.
This backend supports Python 2 only.
Scilab:
Scilab is an free software, cross-platform numerical computational package
and a high-level, numerically oriented programming language.
Scilab is distributed under CeCILL license (GPL compatible).
See http://www.scilab.org/ for more information.
You need Scilab version 5.5 or higher to be installed in your system to make this backend usable.
Octave:
&GNU; Octave is a high-level language, primarily intended for numerical
computations. It provides a convenient command line interface for
solving linear and nonlinear problems numerically, and for performing other
numerical experiments using a language that is mostly compatible with MATLAB.
See http://www.gnu.org/software/octave/ for more information.
Lua:
Lua is a fast and lightweight scripting language, with a simple procedural syntax. There are several libraries in Lua aimed at math and science.
See http://www.lua.org/ for more information.
This backend supports luajit 2.
File Data Source
A file data source is very similar in spirit to a spreadsheet with imported data from an external file. The difference is that the imported data cannot be shown and edited in &LabPlot; after the import anymore. This can be sufficient ⪚ if you only want to plot the data stemming from a calculation in an external program (and exported to an ASCII-file afterwards).
Since no spreadsheet has to be filled with the imported data, the import into a file data source is faster than into a spreadsheet which can be advantageously when dealing with big files.
It is possible to store the link to the external file in the project file only and not its content. Each time the project file is opened in &LabPlot;, the content is read from the external file again. Also, it is possible to let &LabPlot; watch the file for changes - the content of the file data source is updated if the external file was changed.
The additional options determining the import of the data are equivalent to those provided in Import Dialog.
Datapicker
Datapicker is a tool that allows you to easily extract data from image files. The process of extraction consists mainly out of the following steps:
Import an image containing plots and curves where you want to read the data points from.
Select the plot type (cartesian, polar, &etc;).
Select tree reference points and provide values for them. With the help of these points the logical coordinate system is determined.
Create a new datapicker curve and set the type of the error bars.
Switch to the mouse mode "Set Curve Points" and start selecting points on the imported image - the coordinates for the selected points are determined and added to the spreadsheet "Data".
It is possible to add more then one datapicker curve. This is useful in case the imported image contains several curves that need to be digitized.
The datapicker curve that is currently being selected in the Project Explorer is the "active" one - points clicked on the datapicker image will be calculated and added to its data spreadsheet.
Calculated values are stored in different columns in data spreadsheets in the datapicker. These columns behave exactly the same like other columns
in usual spreadsheets and can be directly used as source columns for curves in your own plots.
Datapicker supports the process of the data extraction with several helpers. To place the points more precisely, a magnification glass with different magnification levels is available.
Also, the last selected point can be shifted with the help of the navigation keys.
Furthermore, when reading data points having error bars, datapicker automatically creates bars indicating the end points of the error bars.
Those bars can be pulled with the mouse until the required length (the distance to the data point) is reached.
The procedure for the extraction of data from an imported plot as described above is feasible when dealing with a limited number of points.
In case the curves in the imported image are given as solid lines, the datapicker tool in &LabPlot; allows to read them (semi-)automatically.
For this, after a new datapicker curve was added as described above, switch to the mouse mode "Select Curve Segments". The curves on the plot are recognized and highlighted.
By clicking on a highlighted curve (or one of its segments), points along this curve are created.
The length of a segment and the density of created points (separation between two points) are adjustable parameters.
On the screenshots below, after switching to the segment mode all black lines were highlighted (green colour).
In this specific case, the curve was recognized as a single segment and a single mouse-click on this segment is sufficient to digitize this curve and to automatically place points along the curve.
In many cases the plot is not as simple as above (single black curve on white background) and contains grid lines, many curves of different colour and thinness and a non-white background.
In such a case the automatic detection fails (too many or no objects are highlighted). To help the datapicker to determine the curve(s) correctly, the user has to limit the allowed ranges in the HSV (or HSI) colour spaces.
To subtract the non-white background it is possible to limit the range for the foreground colour, too.
Internally, each pixel of the image is converted to black and white where only the points fitting into the user-defined ranges for hue, saturation, value, intensity and foreground are set to black.
On the screenshots below, the blue curves in the original image were projected onto by having appropriately reduced the allowed ranges in the colour space (note the peak for blue in the histogram for the hue).
The transformed black and white image contains only the curves the user is interested in and it is now an easy task for the datapicker to determine the curves and to place points on them.
Similar to Worksheet, the currently visible area in the datapicker can be exported.
The supported image formats as described in the section Export Dialog.
Import Dialog
In the import dialog you can import data into one of the available spreadsheets or matrices in &LabPlot;.
The supported data formats are
ASCII
Binary
Image
NetCDF
HDF5
FITS
Preview of all supported file types is available in the import dialog.
For data formats with complex internal structures (like NetCDF, HDF5 and FITS),
the content of the file is presented in a tree view that allows comfortable navigation
through the file. A versatile dialog to edit the headers (keywords) of a FITS file is also
provided.
Import of ascii and binary data compressed with gzip, bzip2 or xz can be done directly as the decompression happens transparently for the user.
The name of the file containing the data to import has to be provided. The File Info button opens a dialog where some information about the selected file is shown. The type of the data can be specified - currently, only ASCII files containing several data sets (vectors) stored as columns are supported.
The filter - automatic or custom - determines how the file has to be parsed. Selecting the filter "custom", several parameters like separating character &etc; can be provided manually in this case.
The start and end row to read can be customized using the Data portion to read tab. To read all data specify -1 as an end row or column.
Importing data into &LabPlot;
Importing data into &LabPlot;
Export Dialog
A worksheet can be exported to several graphics format (vector and raster).
The export is done via the export dialog reachable via the
Export in the main toolbar or
FileExport
in the main menu.
Besides the graphics format, the user can specify which part of the worksheet
has to be exported and whether the background has to be exported or not.
Also, for raster graphics the image resolution can be provided.
The content of a spreadsheet can be exported to an external text or FITS file.
In the export dialog for spreadsheets the user can specify the character
separating values of different columns. Optionally, the header of the spreadsheet
(names of the columns in the spreadsheet) can be exported.
Command Reference
Toolbar
The main toolbar contains the main items that you can find in the different menus. More details on this can be found in the &kde; Fundamentals manual.
Plotting
Plots
Plots can be created inside a worksheet via "Add new" in the context menu or in the application menu via "Worksheet"
by selecting "xy-plot" and the type of plot you like to have.
Within this xy-plot you can add a xy-curve containing data to show (again via the context menu or application menu).
The settings of a plot can be changed in the corresponding dock widget. There are general settings like geometry
but also the range of the x- and y-axis (including scaling). The plot title can be set in the "Title" tab of the
dock widget. Background and border styles can be changed in the "Plot Area" tab.
Curves
Curves contain data points that can be shown in a plot.
There are three different method to create curves: the standard xy-curve, a xy-curve from a mathematical expression
and a xy-curve from a data analysis function.
The standard xy-curve can be filled with values of a spreadsheet by selecting the x-data and y-data as column of the
spreadsheet in the xy-curve dock widget. Another method to fill a curve is to use a mathematical expression. Here you can
select any mathematical function and range to create the curve.
The third method to create a curve is to use a data analysis function. The data and the analysis function can be
selected in the dock widget of the analysis function.
For all types of curves the line and symbols styles can be changed in the dock widget. Also annotated values
and error bar settings can be changed here.
Legends
A legend can be easily added to a plot by using the context of application menu. It contains information
about all curves in a plot.
The settings of a legend (format and geometry) can be changed in the legend dock widget. Also the legend title
settings, the legend background and the layout can be changed in the corresponding tab of the legend dock widget.
Analysis functions
Overview
&LabPlot; supports a wide variety of data analysis functions:
Data reduction
Differentiation
Integration
Interpolation
Smoothing
Nonlinear curve fitting
Fourier filter
Fourier transform
All of them can be applied to any data consisting of x- and y-columns.
The analysis functions can be accessed using the Analysis menu or the context menu of a worksheet.
The newly created curves can be customized (line style, symbol style, &etc;) like any other x-y-curve.
Data reduction
To reduce the number of data points without losing the features of a data set
you can apply one of several line simplification algorithm:
Douglas-Peucker
Visvalingam-Whyatt
Reumann-Witkam
Perpendicular distance simplification
n-th point simplification
Radial distance simplification
Interpolation (nearest neighbor)
Opheim
Lang
The desired tolerance is automatically calculated from the data but can also be changed
in the dock widget.
Differentiation
Numerical differentiation of data can be done specifying:
order of derivation (first to sixth order)
order of accuracy (up to 4th order, depending on derivation order)
Integration
Numerical integration of data can be done specifying one of the methods
rectangle (1-point) rule
trapezoid (2-point) rule
Simpson-1/3 (3-point) rule
Simpson-3/8 (4-point) rule
The default method (trapezoid) should be suitable for most cases.
The number of resulting data points is reduced for both Simpson-rules due to the properties of these methods.
Interpolation
Interpolation of data can be done with several algorithm:
linear
polynomial (if number of data points < 100)
cubic spline
cubic spline (periodic)
Akima spline
Akima spline (periodic)
Steffen spline (needs GSL ≥ 2.0)
cosine
exponential
piecewise cubic Hermite (finite differences, Catmull-Rom, cardinal, Kochanek-Bartels)
rational functions
The interpolating function is calculated with the given number n of data points and evaluated as:
function
derivative
second derivative
integral (starting from zero)
Smoothing
A number of different smoothing methods are supported:
Moving average (central)
Moving average (lagged)
Percentile filter
Savitzky-Golay
All smoothing methods support several padding modes (constant, periodic, mirror, nearest, etc.) for the beginning and end
of the data set. The moving averages support several weight functions (uniform, triangular, binomial, parabolic, tricubic, etc.)
which can be selected to weight the selected data points depending on their distance.
Curve fitting
Linear and non-linear curve fitting of data can be done with several predefined fit-models
(for instance polynomial, exponential, Gaussian or custom) to data consisting of x- and y-columns
with an optional weight column. With a custom model any function with unlimited number of parameters
can be used for fitting. The results including statistical properties are displayed in the results text.
The start values of the parameter can be set in the parameter dialog. It is also possible to fix any parameter and set lower and upper limits to the values here. Be aware that reducing the parameter space by fixing parameter or specifying limits can slow down convergence or avoid finding a good result. It's always a good idea to remove any parameter limitations when good start values are found.
Following options can be set in the options dialog to optimize the fitting:
Max. iterations: number of maximum iterations
Tolerance: desired tolerance for result
Evaluated points: number of points to evaluate the fit function
Evaluate full range: evaluate the fit function for the full data range instead of evaluating only for the given x range
Use results as new start values: results will be the new parameter start values
Fourier filter
This function can be used to apply a Fourier filter to any data consisting of x- and y-columns. Supported
filter types are:
Low pass
High pass
Band pass
Band reject (band block)
where any of them can have the form
Ideal
Butterworth (order 1 to 10)
Chebyshev type I or II (order 1 to 10)
Optimal "L"egendre (order 1 to 10)
Bessel-Thomson (any order)
The cutoff value(s) can be specified in the units frequency (Hertz), fraction (0.0 to 1.0) or index
of the data points.
Fourier transform
To convert a signal from time to frequency domain or to change between other conjugate variables like
position and momentum (k-space) a discrete Fourier transform can be applied.
Following options can be used to suite one needs:
Window function (Welch, Hann, Hamming, etc.) to avoid leakage effects
Output (magnitude, amplitude, phase, dB, etc.)
One or two sided spectrum with or without shifting
X axis scaling to frequency, index or period
Curve Tracing
Upload Image
Datapicker can be created inside a project via Add new in the context menu of project/folder or in the main toolbar.
After that a new image can be added and can be changed via Plot in the corresponding dock widget.
After uploading image different zooming options can be used from the context menu/datapicker toolbar to change width and
height of image. Image can also be rotated to an angle using Rotation in the "edit" section of dock widget. After this
user have to set axis points.
Symbols
Symbols are the points that can be drawn over image of datapicker. Symbols can be directly created by mouse
right click over the image. Symbols are mainly of two types, with and without error-bar depending on the type of
curve they belong.
Every curve of datapicker can have its own symbol style that can be changed in the Symbols section of dock widget.
"SelectAndMove" mouse mode can be used to select multiple points/symbols and can be moved by using navigation keys.
Axis Points
Axis Points are the set of three reference points over image of datapicker. These points
can be set via Set Axis Points in the context menu of datapicker. After selecting points over image user have to update
their coordinate system type via Plot Type and logical positions via Ref. Points in the dock widget.
Datapicker Curve
Datapicker-Curve can be created inside datapicker via New Curve in the context menu of datapicker. A curve can have
different types of X and Y errors (No-error, symmetric, asymmetric). This depends on the type of errors dock widget
of datapicker have at the point of creation.
Every curve object contains all the curve points (hidden) and a spreadsheet that contains
logical positions of all its curve points, and provides options to update spreadsheet and to toggle visibility
of its curve points using the context menu. Mode Set Curve Points in the context menu of datapicker should be
selected in order to create curve points.
Multiple curve can be created for same datapicker. The created curve points always correspond to the active
curve of datapicker which can be changed via Active Curve option in the context menu and dock widget of datapicker.
Every curve of datapicker can have its own symbol style that can be changed in the Symbols section of dock widget.
Curve Segments
Curve segment for datapicker can be created over image by switching mode to Select Curve Segments in the context menu of
datapicker. A segment is a selectable object over image which can be selected by mouse right click over it.
Segments are created by processing of image on the basis range of colour attributes in order to automatically
trace curves. To improve results these range and types of colour attributes can be changed in the "edit"
section of dock-widget. Dock-widget also provides options to switch among processed image and original image,
and to set the minimum possible length of segments.
Once a segment is selected it will create curve points over it with a minimum specified distance among them.
The minimum specified distance among the points can be changed in the dock widget of datapicker. User might have
to select the segments again in order to observe the changes.
Advanced Topics
Here you will find some explanations of advanced topics.
Topics
Error bars
If you want to plot data with error bars just import your data with the import dialog into your project. Then use the Error bars tab of the curve properties to select Error type, choose the error column from the Data, +- list. Format of the error bars can be defined using the Format: pane.
TeX label
For using TeX label you just have to activate the switch button TeX in the Title tab. With that every text you enter in the text box is rendered by TeX and plotted accordingly. Since this conversion takes some time you may see a certain delay when redrawing the plot.
Short Tutorials
Building a sine graph with &LabPlot;
In this chapter you will find explanations on how to build a simple plot for a curve in the Cartesian coordinates from a mathematical equation.
&LabPlot; window after the first start
&LabPlot; window after the first start
Click on the New button or press &Ctrl;N on the keyboard.
New &LabPlot; project
New &LabPlot; project
Click on the Project item on the Project Explorer panel with the &RMB; and choose Add newWorksheet or press &Alt;X on the keyboard.
Adding new &LabPlot; worksheet
Adding new &LabPlot; worksheet
Click on the Worksheet item on the Project Explorer panel with the &RMB; and choose Add newxy-plottwo axes, centered.
Adding axes to the plot
Adding axes to the plot
Click on the xy-plot item on the Project Explorer panel with the &RMB; and choose Add newxy-curve from a mathematical equation.
Adding new curve
Adding new curve
Use the xy-equation-curve properties pane on the right to enter sin(x) into the y=f(x) field (for the list of available functions please see ), -6 into the x, min field, 6 into the x, max field and click on the Recalculate button to see the result.
The default curve plot
The default curve plot
&LabPlot; highlights unknown syntax in the y=f(x) field. This is useful to control the correctness of the input.
The list of the known functions can be found in corresponding section of this manual.
Switch to the Line tab on the xy-equation-curve properties pane and choose cubic spline (natural) from the Type drop down box.
Choosing the line type
Adding the line type
Switch to the Symbol tab on the xy-equation-curve properties pane and choose none from the Style drop down list.
Removing symbols from the plot
Removing symbols from the plot
Click on the xy-plot item on the Project Explorer panel with the &RMB; and choose Add newlegend. Switch to the Title tab on the Cartesian plot legend properties pane and enter Graph of sine into the Text field.
Changing the legend title
Changing the legend title
Choose FileExport from the main menu. Select the place and the format to save the plot.
Exporting the plot
Exporting the plot
Building a graph from spreadsheet data with &LabPlot;
In this chapter you will find explanations on how to build a simple plot from spreadsheet data.
&LabPlot; window after the first start
&LabPlot; window after the first start
Click on the New button or press &Ctrl;N on the keyboard.
New &LabPlot; project
New &LabPlot; project
Click on the Project item on the Project Explorer panel with the &RMB; and choose Add newSpreadsheet or press &Ctrl;= on the keyboard.
Adding new &LabPlot; spreadsheet
Adding new &LabPlot; spreadsheet
Click on the header of the first column of the spreadsheet with the &LMB; then click on any of its cells with &RMB; and choose SelectionFill Selection withRow Numbers.
Filling the first column of the spreadsheet
Filling the first column of the spreadsheet
Select Automatic (g) from the Format drop down box on the Column properties right dock to enhance data presentation for the first column.
Click on the header of the second column of the spreadsheet with the &RMB; and choose Generate DataRandom Values.
Filling the second column of the spreadsheet
Filling the second column of the spreadsheet
Click on the Project item on the Project Explorer panel with the &RMB; and choose Add newWorksheet or press &Alt;X on the keyboard.
Adding new &LabPlot; worksheet
Adding new &LabPlot; worksheet
Click on the Worksheet item on the Project Explorer panel with the &RMB; and choose Add newxy-plotbox plot, four axes.
Adding axes to the plot
Adding axes to the plot
Click on the xy-plot item on the Project Explorer panel with the &RMB; and choose Add newxy-curve.
Adding new curve
Adding new curve
Use the xy-curve properties pane on the right to select ProjectSpreadsheet1 in the x-data field (just click on the item and press &Enter;). Use the same procedure to select 2 for the y-data field. The results will be shown on the worksheet immediately.
The plot for the unsorted data
The plot for the unsorted data
Click on the Spreadsheet item on the Project Explorer panel with the &LMB; then click on the second column header with the &RMB; and choose SortAscending.
Sorting the second column of the spreadsheet
Sorting the second column of the spreadsheet
Click on the Worksheet item on the Project Explorer panel with the &LMB; to see the results.
The plot for the sorted data
The plot for the sorted data
Examples
2D Plotting
Coming soon ...
Signal processing
Fourier filter
A time signal containing Morse code is Fourier transformed to frequency space to see the main component. By applying a narrow band pass filter the Morse signal is extracted and a nice ‘SOS’ can be seen:
Computing
Maxima
Maxima session showing the chaotic dynamics of the Duffing oscillator.
The differential equation of the forced oscillator are solved with Maxima.
Plots of the trajectory, the phase space of the oscillator and the corresponding Poincaré map are done with LabPlot:
Python
Python session illustrating the effect of Blackman windowing on the Fourier transform:
Import/Export
Coming soon ...
Tools
Coming soon ...
Parser functions
The &LabPlot; parser allows you to use following functions:
Standard functions
FunctionDescription
cbrt(x)Cube root
ceil(x)Truncate upward to integer
fabs(x)Absolute value
gamma(x)Gamma function
ldexp(x,y)x * 2y
ln(x)Logarithm, base e
log(x)Logarithm, base e
log1p(x)log(1+x)
log10(x)Logarithm, base 10
logb(x)Radix-independent exponent
pow(x,n)power function xn
powint(x,n)integer power function xn
pow2(x)power function x2
pow3(x)power function x3
pow4(x)power function x4
pow5(x)power function x5
pow6(x)power function x6
pow7(x)power function x7
pow8(x)power function x8
pow9(x)power function x9
rint(x)round to nearest integer
round(x)round to nearest integer
sqrt(x)Square root
tgamma(x)Gamma function
trunc(x)Returns the greatest integer less than or equal to x
Trigonometric functions
FunctionDescription
sin(x)Sine
cos(x)Cosine
tan(x)Tangent
asin(x)Inverse sine
acos(x)Inverse cosine
atan(x)Inverse tangent
atan2(y,x)Inverse tangent function of two variables
sinh(x)Hyperbolic sine
cosh(x)Hyperbolic cosine
tanh(x)Hyperbolic tangent
asinh(x)Inverse hyperbolic sine
acosh(x)Inverse hyperbolic cosine
atanh(x)Inverse hyperbolic tangent
sec(x)Secant
csc(x)Cosecant
cot(x)Cotangent
asec(x)Inverse secant
acsc(x)Inverse cosecant
acot(x)Inverse cotangent
sech(x)Hyperbolic secant
csch(x)Hyperbolic cosecant
coth(x)Hyperbolic cotangent
asech(x)Inverse hyperbolic secant
acsch(x)Inverse hyperbolic cosecant
acoth(x)Inverse hyperbolic cotangent
sinc(x)Sinc function sin(π x) / (π x)
logsinh(x)log(sinh(x)) for x > 0
logcosh(x)log(cosh(x))
hypot(x,y)Hypotenuse function √{x2 + y2}
hypot3(x,y,z)√{x2 + y2 + z2}
anglesymm(α)force the angle α to lie in the range (-π,π]
anglepos(α)force the angle α to lie in the range (0,2π]
Special functions
For more information about the functions see the documentation of GSL.
FunctionDescription
Ai(x)Airy function Ai(x)
Bi(x)Airy function Bi(x)
Ais(x)scaled version of the Airy function SAi(x)
Bis(x)scaled version of the Airy function SBi(x)
Aid(x)Airy function derivative Ai'(x)
Bid(x)Airy function derivative Bi'(x)
Aids(x)derivative of the scaled Airy function SAi(x)
Bids(x)derivative of the scaled Airy function SBi(x)
Ai0(s)s-th zero of the Airy function Ai(x)
Bi0(s)s-th zero of the Airy function Bi(x)
Aid0(s)s-th zero of the Airy function derivative Ai'(x)
Bid0(s)s-th zero of the Airy function derivative Bi'(x)
J0(x)regular cylindrical Bessel function of zeroth order, J0(x)
J1(x)regular cylindrical Bessel function of first order, J1(x)
Jn(n,x)regular cylindrical Bessel function of order n, Jn(x)
Y0(x)irregular cylindrical Bessel function of zeroth order, Y0(x)
Y1(x)irregular cylindrical Bessel function of first order, Y1(x)
Yn(n,x)irregular cylindrical Bessel function of order n, Yn(x)
I0(x)regular modified cylindrical Bessel function of zeroth order, I0(x)
I1(x)regular modified cylindrical Bessel function of first order, I1(x)
In(n,x)regular modified cylindrical Bessel function of order n, In(x)
I0s(x)scaled regular modified cylindrical Bessel function of zeroth order, exp (-|x|) I0(x)
I1s(x)scaled regular modified cylindrical Bessel function of first order, exp(-|x|) I1(x)
Ins(n,x)scaled regular modified cylindrical Bessel function of order n, exp(-|x|) In(x)
K0(x)irregular modified cylindrical Bessel function of zeroth order, K0(x)
K1(x)irregular modified cylindrical Bessel function of first order, K1(x)
Kn(n,x)irregular modified cylindrical Bessel function of order n, Kn(x)
K0s(x)scaled irregular modified cylindrical Bessel function of zeroth order, exp(x) K0(x)
K1s(x)scaled irregular modified cylindrical Bessel function of first order, exp(x) K1(x)
Kns(n,x)scaled irregular modified cylindrical Bessel function of order n, exp(x) Kn(x)
j0(x)regular spherical Bessel function of zeroth order, j0(x)
j1(x)regular spherical Bessel function of first order, j1(x)
j2(x)regular spherical Bessel function of second order, j2(x)
jl(l,x)regular spherical Bessel function of order l, jl(x)
y0(x)irregular spherical Bessel function of zeroth order, y0(x)
y1(x)irregular spherical Bessel function of first order, y1(x)
y2(x)irregular spherical Bessel function of second order, y2(x)
yl(l,x)irregular spherical Bessel function of order l, yl(x)
i0s(x)scaled regular modified spherical Bessel function of zeroth order, exp(-|x|) i0(x)
i1s(x)scaled regular modified spherical Bessel function of first order, exp(-|x|) i1(x)
i2s(x)scaled regular modified spherical Bessel function of second order, exp(-|x|) i2(x)
ils(l,x)scaled regular modified spherical Bessel function of order l, exp(-|x|) il(x)
k0s(x)scaled irregular modified spherical Bessel function of zeroth order, exp(x) k0(x)
k1s(x)scaled irregular modified spherical Bessel function of first order, exp(x) k1(x)
k2s(x)scaled irregular modified spherical Bessel function of second order, exp(x) k2(x)
kls(l,x)scaled irregular modified spherical Bessel function of order l, exp(x) kl(x)
Jnu(ν,x)regular cylindrical Bessel function of fractional order ν, Jν(x)
Ynu(ν,x)irregular cylindrical Bessel function of fractional order ν, Yν(x)
Inu(ν,x)regular modified Bessel function of fractional order ν, Iν(x)
Inus(ν,x)scaled regular modified Bessel function of fractional order ν, exp(-|x|) Iν(x)
Knu(ν,x)irregular modified Bessel function of fractional order ν, Kν(x)
lnKnu(ν,x)logarithm of the irregular modified Bessel function of fractional order ν,ln(Kν(x))
Knus(ν,x)scaled irregular modified Bessel function of fractional order ν, exp(|x|) Kν(x)
J0_0(s)s-th positive zero of the Bessel function J0(x)
J1_0(s)s-th positive zero of the Bessel function J1(x)
Jnu_0(nu,s)s-th positive zero of the Bessel function Jν(x)
clausen(x)Clausen integral Cl2(x)
hydrogenicR_1(Z,R)lowest-order normalized hydrogenic bound state radial wavefunction R1 := 2Z √Z exp(-Z r)
hydrogenicR(n,l,Z,R)n-th normalized hydrogenic bound state radial wavefunction
dawson(x)Dawson's integral
D1(x)first-order Debye function D1(x) = (1/x) ∫0x(t/(et - 1)) dt
D2(x)second-order Debye function D2(x) = (2/x2) ∫0x (t2/(et - 1)) dt
D3(x)third-order Debye function D3(x) = (3/x3) ∫0x (t3/(et - 1)) dt
D4(x)fourth-order Debye function D4(x) = (4/x4) ∫0x (t4/(et - 1)) dt
D5(x)fifth-order Debye function D5(x) = (5/x5) ∫0x (t5/(et - 1)) dt
D6(x)sixth-order Debye function D6(x) = (6/x6) ∫0x (t6/(et - 1)) dt
Li2(x)dilogarithm
Kc(k)complete elliptic integral K(k)
Ec(k)complete elliptic integral E(k)
F(phi,k)incomplete elliptic integral F(phi,k)
E(phi,k)incomplete elliptic integral E(phi,k)
P(phi,k,n)incomplete elliptic integral P(phi,k,n)
D(phi,k,n)incomplete elliptic integral D(phi,k,n)
RC(x,y)incomplete elliptic integral RC(x,y)
RD(x,y,z)incomplete elliptic integral RD(x,y,z)
RF(x,y,z)incomplete elliptic integral RF(x,y,z)
RJ(x,y,z)incomplete elliptic integral RJ(x,y,z,p)
erf(x)error function erf(x) = 2/√π ∫0x exp(-t2) dt
erfc(x)complementary error function erfc(x) = 1 - erf(x) = 2/√π ∫x∞ exp(-t2) dt
log_erfc(x)logarithm of the complementary error function log(erfc(x))
erf_Z(x)Gaussian probability function Z(x) = (1/(2π)) exp(-x2/2)
erf_Q(x)upper tail of the Gaussian probability function Q(x) = (1/(2π)) ∫x∞ exp(-t2/2) dt
hazard(x)hazard function for the normal distribution
exp(x)Exponential, base e
expm1(x)exp(x)-1
exp_mult(x,y)exponentiate x and multiply by the factor y to return the product y exp(x)
exprel(x)(exp(x)-1)/x using an algorithm that is accurate for small x
exprel2(x)2(exp(x)-1-x)/x2 using an algorithm that is accurate for small x
expreln(n,x)n-relative exponential, which is the n-th generalization of the functions `exprel'
E1(x)exponential integral E1(x), E1(x) := Re ∫1∞ exp(-xt)/t dt
E2(x)second-order exponential integral E2(x), E2(x) := Re ∫1∞ exp(-xt)/t2 dt
En(x)exponential integral E_n(x) of order n, En(x) := Re ∫1∞ exp(-xt)/tn dt)
Ei(x)exponential integral E_i(x), Ei(x) := PV(∫-x∞ exp(-t)/t dt)
shi(x)Shi(x) = ∫0x sinh(t)/t dt
chi(x)integral Chi(x) := Re[ γE + log(x) + ∫0x (cosh[t]-1)/t dt ]
Ei3(x)exponential integral Ei3(x) = ∫0x exp(-t3) dt for x >= 0
si(x)Sine integral Si(x) = ∫0x sin(t)/t dt
ci(x)Cosine integral Ci(x) = -∫x∞ cos(t)/t dt for x > 0
atanint(x)Arctangent integral AtanInt(x) = ∫0x arctan(t)/t dt
Fm1(x)complete Fermi-Dirac integral with an index of -1, F-1(x) = ex / (1 + ex)
F0(x)complete Fermi-Dirac integral with an index of 0, F0(x) = ln(1 + ex)
F1(x)complete Fermi-Dirac integral with an index of 1, F1(x) = ∫0∞ (t /(exp(t-x)+1)) dt
F2(x)complete Fermi-Dirac integral with an index of 2, F2(x) = (1/2) ∫0∞ (t2 /(exp(t-x)+1)) dt
Fj(j,x)complete Fermi-Dirac integral with an index of j, Fj(x) = (1/Γ(j+1)) ∫0∞ (tj /(exp(t-x)+1)) dt
Fmhalf(x)complete Fermi-Dirac integral F-1/2(x)
Fhalf(x)complete Fermi-Dirac integral F1/2(x)
F3half(x)complete Fermi-Dirac integral F3/2(x)
Finc0(x,b)incomplete Fermi-Dirac integral with an index of zero, F0(x,b) = ln(1 + eb-x) - (b-x)
lngamma(x)logarithm of the Gamma function
gammastar(x)regulated Gamma Function Γ*(x) for x > 0
gammainv(x)reciprocal of the gamma function, 1/Γ(x) using the real Lanczos method.
fact(n)factorial n!
doublefact(n)double factorial n!! = n(n-2)(n-4)...
lnfact(n)logarithm of the factorial of n, log(n!)
lndoublefact(n)logarithm of the double factorial log(n!!)
choose(n,m)combinatorial factor `n choose m' = n!/(m!(n-m)!)
lnchoose(n,m)logarithm of `n choose m'
taylor(n,x)Taylor coefficient xn / n! for x >= 0, n >= 0
poch(a,x)Pochhammer symbol (a)x := Γ(a + x)/Γ(x)
lnpoch(a,x)logarithm of the Pochhammer symbol (a)x := Γ(a + x)/Γ(x)
pochrel(a,x)relative Pochhammer symbol ((a,x) - 1)/x where (a,x) = (a)x := Γ(a + x)/Γ(a)
gammainc(a,x)incomplete Gamma Function Γ(a,x) = ∫x∞ ta-1 exp(-t) dt for a > 0, x >= 0
gammaincQ(a,x)normalized incomplete Gamma Function P(a,x) = 1/Γ(a) ∫x∞ ta-1 exp(-t) dt for a > 0, x >= 0
gammaincP(a,x)complementary normalized incomplete Gamma Function P(a,x) = 1/Γ(a) ∫0x ta-1 exp(-t) dt for a > 0, x >= 0
beta(a,b)Beta Function, B(a,b) = Γ(a) Γ(b)/Γ(a+b) for a > 0, b > 0
lnbeta(a,b)logarithm of the Beta Function, log(B(a,b)) for a > 0, b > 0
betainc(a,b,x)normalize incomplete Beta function B_x(a,b)/B(a,b) for a > 0, b > 0
C1(λ,x)Gegenbauer polynomial Cλ1(x)
C2(λ,x)Gegenbauer polynomial Cλ2(x)
C3(λ,x)Gegenbauer polynomial Cλ3(x)
Cn(n,λ,x)Gegenbauer polynomial Cλn(x)
hyperg_0F1(c,x)hypergeometric function 0F1(c,x)
hyperg_1F1i(m,n,x)confluent hypergeometric function 1F1(m,n,x) = M(m,n,x) for integer parameters m, n
hyperg_1F1(a,b,x)confluent hypergeometric function 1F1(a,b,x) = M(a,b,x) for general parameters a,b
hyperg_Ui(m,n,x)confluent hypergeometric function U(m,n,x) for integer parameters m,n
hyperg_U(a,b,x)confluent hypergeometric function U(a,b,x)
hyperg_2F1(a,b,c,x)Gauss hypergeometric function 2F1(a,b,c,x)
hyperg_2F1c(aR,aI,c,x)Gauss hypergeometric function 2F1(aR + i aI, aR - i aI, c, x) with complex parameters
hyperg_2F1r(aR,aI,c,x)renormalized Gauss hypergeometric function 2F1(a,b,c,x) / Γ(c)
hyperg_2F1cr(aR,aI,c,x)renormalized Gauss hypergeometric function 2F1(aR + i aI, aR - i aI, c, x) / Γ(c)
hyperg_2F0(a,b,x)hypergeometric function 2F0(a,b,x)
L1(a,x)generalized Laguerre polynomials La1(x)
L2(a,x)generalized Laguerre polynomials La2(x)
L3(a,x)generalized Laguerre polynomials La3(x)
W0(x)principal branch of the Lambert W function, W0(x)
Wm1(x)secondary real-valued branch of the Lambert W function, W-1(x)
P1(x)Legendre polynomials P1(x)
P2(x)Legendre polynomials P2(x)
P3(x)Legendre polynomials P3(x)
Pl(l,x)Legendre polynomials Pl(x)
Q0(x)Legendre polynomials Q0(x)
Q1(x)Legendre polynomials Q1(x)
Ql(l,x)Legendre polynomials Ql(x)
Plm(l,m,x)associated Legendre polynomial Plm(x)
Pslm(l,m,x)normalized associated Legendre polynomial √{(2l+1)/(4π)} √{(l-m)!/(l+m)!} Plm(x) suitable for use in spherical harmonics
Phalf(λ,x)irregular Spherical Conical Function P1/2-1/2 + i λ(x) for x > -1
Pmhalf(λ,x)regular Spherical Conical Function P-1/2-1/2 + i λ(x) for x > -1
Pc0(λ,x)conical function P0-1/2 + i λ(x) for x > -1
Pc1(λ,x)conical function P1-1/2 + i λ(x) for x > -1
Psr(l,λ,x)Regular Spherical Conical Function P-1/2-l-1/2 + i λ(x) for x > -1, l >= -1
Pcr(l,λ,x)Regular Cylindrical Conical Function P-m-1/2 + i λ(x) for x > -1, m >= -1
H3d0(λ,η)zeroth radial eigenfunction of the Laplacian on the 3-dimensional hyperbolic space, LH3d0(λ,,η) := sin(λ η)/(λ sinh(η)) for η >= 0
H3d1(λ,η)zeroth radial eigenfunction of the Laplacian on the 3-dimensional hyperbolic space, LH3d1(λ,η) := 1/√{λ2 + 1} sin(λ η)/(λ sinh(η)) (coth(η) - λ cot(λ η)) for η >= 0
H3d(l,λ,η)L'th radial eigenfunction of the Laplacian on the 3-dimensional hyperbolic space eta >= 0, l >= 0
logabs(x)logarithm of the magnitude of X, log(|x|)
logp(x)log(1 + x) for x > -1 using an algorithm that is accurate for small x
logm(x)log(1 + x) - x for x > -1 using an algorithm that is accurate for small x
psiint(n)digamma function ψ(n) for positive integer n
psi(x)digamma function ψ(n) for general x
psi1piy(y)real part of the digamma function on the line 1+i y, Re[ψ(1 + i y)]
psi1int(n)Trigamma function ψ'(n) for positive integer n
psi1(n)Trigamma function ψ'(x) for general x
psin(m,x)polygamma function ψ(m)(x) for m >= 0, x > 0
synchrotron1(x)first synchrotron function x ∫x∞ K5/3(t) dt for x >= 0
synchrotron2(x)second synchrotron function x K2/3(x) for x >= 0
J2(x)transport function J(2,x)
J3(x)transport function J(3,x)
J4(x)transport function J(4,x)
J5(x)transport function J(5,x)
zetaint(n)Riemann zeta function ζ(n) for integer n
zeta(s)Riemann zeta function ζ(s) for arbitrary s
zetam1int(n)Riemann ζ function minus 1 for integer n
zetam1(s)Riemann ζ function minus 1
zetaintm1(s)Riemann ζ function for integer n minus 1
hzeta(s,q)Hurwitz zeta function ζ(s,q) for s > 1, q > 0
etaint(n)eta function η(n) for integer n
eta(s)eta function η(s) for arbitrary s
Random number distributions
For more information about the functions see the documentation of GSL.
FunctionDescription
gaussian(x,σ)probability density p(x) for a Gaussian distribution with standard deviation σ
ugaussian(x)unit Gaussian distribution. They are equivalent to the functions above with a standard deviation of σ = 1
gaussianP(x,σ)cumulative distribution functions P(x) for the Gaussian distribution with standard deviation σ
gaussianQ(x,σ)cumulative distribution functions Q(x) for the Gaussian distribution with standard deviation σ
gaussianPinv(P,σ)inverse cumulative distribution functions P(x) for the Gaussian distribution with standard deviation σ
gaussianQinv(Q,σ)inverse cumulative distribution functions Q(x) for the Gaussian distribution with standard deviation σ
ugaussianP(x)cumulative distribution function P(x) for the unit Gaussian distribution
ugaussianQ(x)cumulative distribution function Q(x) for the unit Gaussian distribution
ugaussianPinv(P)inverse cumulative distribution function P(x) for the unit Gaussian distribution
ugaussianQinv(Q)inverse cumulative distribution function Q(x) for the unit Gaussian distribution
gaussiantail(x,a,σ)probability density p(x) for a Gaussian tail distribution with standard deviation σ and lower limit a
ugaussiantail(x,a)tail of a unit Gaussian distribution. They are equivalent to the functions above with a standard deviation of σ = 1
gaussianbi(x,y,σx,σy,ρ)probability density p(x,y) for a bivariate gaussian distribution
with standard deviations σx, σy and correlation coefficient ρ
exponential(x,μ)probability density p(x) for an exponential distribution with mean μ
exponentialP(x,μ)cumulative distribution function P(x) for an exponential distribution with mean μ
exponentialQ(x,μ)cumulative distribution function Q(x) for an exponential distribution with mean μ
exponentialPinv(P,μ)inverse cumulative distribution function P(x) for an exponential distribution with mean μ
exponentialQinv(Q,μ)inverse cumulative distribution function Q(x) for an exponential distribution with mean μ
laplace(x,a)probability density p(x) for a Laplace distribution with width a
laplaceP(x,a)cumulative distribution function P(x) for a Laplace distribution with width a
laplaceQ(x,a)cumulative distribution function Q(x) for a Laplace distribution with width a
laplacePinv(P,a)inverse cumulative distribution function P(x) for an Laplace distribution with width a
laplaceQinv(Q,a)inverse cumulative distribution function Q(x) for an Laplace distribution with width a
exppow(x,a,b)probability density p(x) for an exponential power distribution with scale parameter a and exponent b
exppowP(x,a,b)cumulative probability density P(x) for an exponential power distribution with scale parameter a and exponent b
exppowQ(x,a,b)cumulative probability density Q(x) for an exponential power distribution with scale parameter a and exponent b
cauchy(x,a)probability density p(x) for a Cauchy (Lorentz) distribution with scale parameter a
cauchyP(x,a)cumulative distribution function P(x) for a Cauchy distribution with scale parameter a
cauchyQ(x,a)cumulative distribution function Q(x) for a Cauchy distribution with scale parameter a
cauchyPinv(P,a)inverse cumulative distribution function P(x) for a Cauchy distribution with scale parameter a
cauchyQinv(Q,a)inverse cumulative distribution function Q(x) for a Cauchy distribution with scale parameter a
rayleigh(x,σ)probability density p(x) for a Rayleigh distribution with scale parameter σ
rayleighP(x,σ)cumulative distribution function P(x) for a Rayleigh distribution with scale parameter σ
rayleighQ(x,σ)cumulative distribution function Q(x) for a Rayleigh distribution with scale parameter σ
rayleighPinv(P,σ)inverse cumulative distribution function P(x) for a Rayleigh distribution with scale parameter σ
rayleighQinv(Q,σ)inverse cumulative distribution function Q(x) for a Rayleigh distribution with scale parameter σ
rayleigh_tail(x,a,σ)probability density p(x) for a Rayleigh tail distribution with scale parameter σ and lower limit a
landau(x)probability density p(x) for the Landau distribution
gammapdf(x,a,b)probability density p(x) for a gamma distribution with parameters a and b
gammaP(x,a,b)cumulative distribution function P(x) for a gamma distribution with parameters a and b
gammaQ(x,a,b)cumulative distribution function Q(x) for a gamma distribution with parameters a and b
gammaPinv(P,a,b)inverse cumulative distribution function P(x) for a gamma distribution with parameters a and b
gammaQinv(Q,a,b)inverse cumulative distribution function Q(x) for a gamma distribution with parameters a and b
flat(x,a,b)probability density p(x) for a uniform distribution from a to b
flatP(x,a,b)cumulative distribution function P(x) for a uniform distribution from a to b
flatQ(x,a,b)cumulative distribution function Q(x) for a uniform distribution from a to b
flatPinv(P,a,b)inverse cumulative distribution function P(x) for a uniform distribution from a to b
flatQinv(Q,a,b)inverse cumulative distribution function Q(x) for a uniform distribution from a to b
lognormal(x,ζ,σ)probability density p(x) for a lognormal distribution with parameters ζ and σ
lognormalP(x,ζ,σ)cumulative distribution function P(x) for a lognormal distribution with parameters ζ and σ
lognormalQ(x,ζ,σ)cumulative distribution function Q(x) for a lognormal distribution with parameters ζ and σ
lognormalPinv(P,ζ,σ)inverse cumulative distribution function P(x) for a lognormal distribution with parameters ζ and σ
lognormalQinv(Q,ζ,σ)inverse cumulative distribution function Q(x) for a lognormal distribution with parameters ζ and σ
chisq(x,ν)probability density p(x) for a χ2 distribution with ν degrees of freedom
chisqP(x,ν)cumulative distribution function P(x) for a χ2 distribution with ν degrees of freedom
chisqQ(x,ν)cumulative distribution function Q(x) for a χ2 distribution with ν degrees of freedom
chisqPinv(P,ν)inverse cumulative distribution function P(x) for a χ2 distribution with ν degrees of freedom
chisqQinv(Q,ν)inverse cumulative distribution function Q(x) for a χ2 distribution with ν degrees of freedom
fdist(x,ν1,ν2)probability density p(x) for an F-distribution with ν1 and ν2 degrees of freedom
fdistP(x,ν1,ν2)cumulative distribution function P(x) for an F-distribution with ν1 and ν2 degrees of freedom
fdistQ(x,ν1,ν2)cumulative distribution function Q(x) for an F-distribution with ν1 and ν2 degrees of freedom
fdistPinv(P,ν1,ν2)inverse cumulative distribution function P(x) for an F-distribution with ν1 and ν2 degrees of freedom
fdistQinv(Q,ν1,ν2)inverse cumulative distribution function Q(x) for an F-distribution with ν1 and ν2 degrees of freedom
tdist(x,ν)probability density p(x) for a t-distribution with ν degrees of freedom
tdistP(x,ν)cumulative distribution function P(x) for a t-distribution with ν degrees of freedom
tdistQ(x,ν)cumulative distribution function Q(x) for a t-distribution with ν degrees of freedom
tdistPinv(P,ν)inverse cumulative distribution function P(x) for a t-distribution with ν degrees of freedom
tdistQinv(Q,ν)inverse cumulative distribution function Q(x) for a t-distribution with ν degrees of freedom
betapdf(x,a,b)probability density p(x) for a beta distribution with parameters a and b
betaP(x,a,b)cumulative distribution function P(x) for a beta distribution with parameters a and b
betaQ(x,a,b)cumulative distribution function Q(x) for a beta distribution with parameters a and b
betaPinv(P,a,b)inverse cumulative distribution function P(x) for a beta distribution with parameters a and b
betaQinv(Q,a,b)inverse cumulative distribution function Q(x) for a beta distribution with parameters a and b
logistic(x,a)probability density p(x) for a logistic distribution with scale parameter a
logisticP(x,a)cumulative distribution function P(x) for a logistic distribution with scale parameter a
logisticQ(x,a)cumulative distribution function Q(x) for a logistic distribution with scale parameter a
logisticPinv(P,a)inverse cumulative distribution function P(x) for a logistic distribution with scale parameter a
logisticQinv(Q,a)inverse cumulative distribution function Q(x) for a logistic distribution with scale parameter a
pareto(x,a,b)probability density p(x) for a Pareto distribution with exponent a and scale b
paretoP(x,a,b)cumulative distribution function P(x) for a Pareto distribution with exponent a and scale b
paretoQ(x,a,b)cumulative distribution function Q(x) for a Pareto distribution with exponent a and scale b
paretoPinv(P,a,b)inverse cumulative distribution function P(x) for a Pareto distribution with exponent a and scale b
paretoQinv(Q,a,b)inverse cumulative distribution function Q(x) for a Pareto distribution with exponent a and scale b
weibull(x,a,b)probability density p(x) for a Weibull distribution with scale a and exponent b
weibullP(x,a,b)cumulative distribution function P(x) for a Weibull distribution with scale a and exponent b
weibullQ(x,a,b)cumulative distribution function Q(x) for a Weibull distribution with scale a and exponent b
weibullPinv(P,a,b)inverse cumulative distribution function P(x) for a Weibull distribution with scale a and exponent b
weibullQinv(Q,a,b)inverse cumulative distribution function Q(x) for a Weibull distribution with scale a and exponent b
gumbel1(x,a,b)probability density p(x) for a Type-1 Gumbel distribution with parameters a and b
gumbel1P(x,a,b)cumulative distribution function P(x) for a Type-1 Gumbel distribution with parameters a and b
gumbel1Q(x,a,b)cumulative distribution function Q(x) for a Type-1 Gumbel distribution with parameters a and b
gumbel1Pinv(P,a,b)inverse cumulative distribution function P(x) for a Type-1 Gumbel distribution with parameters a and b
gumbel1Qinv(Q,a,b)inverse cumulative distribution function Q(x) for a Type-1 Gumbel distribution with parameters a and b
gumbel2(x,a,b)probability density p(x) at X for a Type-2 Gumbel distribution with parameters A and B
gumbel2P(x,a,b)cumulative distribution function P(x) for a Type-2 Gumbel distribution with parameters a and b
gumbel2Q(x,a,b)cumulative distribution function Q(x) for a Type-2 Gumbel distribution with parameters a and b
gumbel2Pinv(P,a,b)inverse cumulative distribution function P(x) for a Type-2 Gumbel distribution with parameters a and b
gumbel2Qinv(Q,a,b)inverse cumulative distribution function Q(x) for a Type-2 Gumbel distribution with parameters a and b
poisson(k,μ)probability p(k) of obtaining k from a Poisson distribution with mean μ
poissonP(k,μ)cumulative distribution functions P(k) for a Poisson distribution with mean μ
poissonQ(k,μ)cumulative distribution functions Q(k) for a Poisson distribution with mean μ
bernoulli(k,p)probability p(k) of obtaining k from a Bernoulli distribution with probability parameter p
binomial(k,p,n)probability p(k) of obtaining p from a binomial distribution with parameters p and n
binomialP(k,p,n)cumulative distribution functions P(k) for a binomial distribution with parameters p and n
binomialQ(k,p,n)cumulative distribution functions Q(k) for a binomial distribution with parameters p and n
nbinomial(k,p,n)probability p(k) of obtaining k from a negative binomial distribution with parameters p and n
nbinomialP(k,p,n)cumulative distribution functions P(k) for a negative binomial distribution with parameters p and n
nbinomialQ(k,p,n)cumulative distribution functions Q(k) for a negative binomial distribution with parameters p and n
pascal(k,p,n)probability p(k) of obtaining k from a Pascal distribution with parameters p and n
pascalP(k,p,n)cumulative distribution functions P(k) for a Pascal distribution with parameters p and n
pascalQ(k,p,n)cumulative distribution functions Q(k) for a Pascal distribution with parameters p and n
geometric(k,p)probability p(k) of obtaining k from a geometric distribution with probability parameter p
geometricP(k,p)cumulative distribution functions P(k) for a geometric distribution with parameter p
geometricQ(k,p)cumulative distribution functions Q(k) for a geometric distribution with parameter p
hypergeometric(k,n1,n2,t)probability p(k) of obtaining k from a hypergeometric distribution with parameters n1, n2, t
hypergeometricP(k,n1,n2,t)cumulative distribution function P(k) for a hypergeometric distribution with parameters n1, n2, t
hypergeometricQ(k,n1,n2,t)cumulative distribution function Q(k) for a hypergeometric distribution with parameters n1, n2, t
logarithmic(k,p)probability p(k) of obtaining K from a logarithmic distribution with probability parameter p
Constants
ConstantDescription
eThe base of natural logarithms
piπ
GSL constants
For more information about this constants see the documentation of GSL.
ConstantDescription
c The speed of light in vacuum
mu0The permeability of free space
e0The permittivity of free space
hThe Planck constant h
hbarThe reduced Planck constant ℏ
naAvogadro's number
fThe molar charge of 1 Faraday
kThe Boltzmann constant
r0The molar gas constant
v0The standard gas volume
sigmaThe Stefan–Boltzmann constant
gaussThe magnetic field of 1 Gauss
auThe length of 1 astronomical unit (mean earth-sun distance)
GThe gravitational constant
lyThe distance of 1 light-year
pcThe distance of 1 parsec
ggThe standard gravitational acceleration on Earth
msThe mass of the Sun
eeThe charge of the electron
eVThe energy of 1 electron volt
amuThe unified atomic mass
meThe mass of the electron
mmuThe mass of the muon
mpThe mass of the proton
mnThe mass of the neutron
alphaThe electromagnetic fine structure constant
ryThe Rydberg constant
a0The Bohr radius
aThe length of 1 angstrom
barn The area of 1 barn
muBThe Bohr Magneton
munThe Nuclear Magneton
mueThe magnetic moment of the electron
mupThe magnetic moment of the proton
sigmaTThe Thomson cross section for an electron
pDThe debye
minThe number of seconds in 1 minute
hThe number of seconds in 1 hour
d The number of seconds in 1 day
weekThe number of seconds in 1 week
inThe length of 1 inch
ftThe length of 1 foot
yardThe length of 1 yard
milThe length of 1 mil (1/1000th of an inch)
v_km_per_hThe speed of 1 kilometer per hour
v_mile_per_hThe speed of 1 mile per hour
nmileThe length of 1 nautical mile
fathomThe length of 1 fathom
knotThe speed of 1 knot
pt The length of 1 printer's point (1/72 inch)
texptThe length of 1 TeX point (1/72.27 inch)
micronThe length of 1 micrometre
hectareThe area of 1 hectare
acreThe area of 1 acre
literThe volume of 1 liter
us_gallonThe volume of 1 US gallon
can_gallonThe volume of 1 Canadian gallon
uk_gallonThe volume of 1 UK gallon
quartThe volume of 1 quart
pintThe volume of 1 pint
poundThe mass of 1 pound
ounceThe mass of 1 ounce
tonThe mass of 1 ton
mtonThe mass of 1 metric ton (1000 kg)
uk_tonThe mass of 1 UK ton
troy_ounceThe mass of 1 troy ounce
caratThe mass of 1 carat
gram_forceThe force of 1 gram weight
pound_forceThe force of 1 pound weight
kilepound_forceThe force of 1 kilopound weight
poundalThe force of 1 poundal
calThe energy of 1 calorie
btuThe energy of 1 British Thermal Unit
thermThe energy of 1 Therm
hpThe power of 1 horsepower
barThe pressure of 1 bar
atmThe pressure of 1 standard atmosphere
torrThe pressure of 1 torr
mhgThe pressure of 1 meter of mercury
inhgThe pressure of 1 inch of mercury
inh2oThe pressure of 1 inch of water
psiThe pressure of 1 pound per square inch
poiseThe dynamic viscosity of 1 poise
stokesThe kinematic viscosity of 1 stokes
stilbThe luminance of 1 stilb
lumenThe luminous flux of 1 lumen
luxThe illuminance of 1 lux
photThe illuminance of 1 phot
ftcandleThe illuminance of 1 footcandle
lambertThe luminance of 1 lambert
ftlambertThe luminance of 1 footlambert
curieThe activity of 1 curie
roentgenThe exposure of 1 roentgen
radThe absorbed dose of 1 rad
NThe force of 1 newton
dyneThe force of 1 dyne
JThe energy of 1 joule
ergThe energy of 1 erg
Installation
How to Obtain &LabPlot;
&LabPlot; can be found on its homepage at sourceforge.net:
http://labplot.sf.net.
There is an overview about all available packages at
http://labplot.wiki.sourceforge.net/Download.
bug-fixed packages are released regular and can be found there too.
Requirements
In order to successfully use &LabPlot;, you need at least a standard &Qt; 5 and &kde; KF5 installation, the &GNU; scientific library (GSL), &cantor; libcantor library.
Compilation and Installation
&install.compile.documentation;
Command Line Options
Specify a File
When starting &LabPlot; from the command prompt, you can supply the name of a project file (ending with .lml, .lml.gz, .lml.bz2 or .lml.xz):
labplot2
file.lml
Other Command Line Options
The following command line help options are available
labplot2
This lists the most basic options available at the
command line.
labplot2
Do not show the splash screen
labplot2
Start in the presenter mode
labplot2
Lists &LabPlot;'s author in the terminal window
labplot2
Lists version information for &LabPlot;.
Also available through labplot2
Questions and Answers
For which platforms is &LabPlot; available?
&LabPlot; is developed for Unix platforms and uses the &Qt; toolkit and &kde-frameworks;. Normally you can expect &LabPlot;
to build and run on every platform &kde-frameworks; supports.
A recent list of supported platforms and tips for compiling and running &LabPlot; can be found on
http://labplot.wiki.sourceforge.net/Download.
How do I export the active worksheet as image?
The standard way is to use FileExport. All &Qt; supported image formats are allowed. Just select the desired format and the active worksheet is exported.
How do I use Greek letters for title, axes label, &etc;?
Use π button to open character selector window or &tex; to generate Greek letters and other symbols using &latex;.
I miss an important feature. What can I do?
Please take a look at the TODO file in the documentation of &LabPlot;.
Here, all planned features are listed in more or
less sorted order which I will implement in future releases of &LabPlot;.
If you like to have additional
features or like to have a listed feature soon, mail me your wishes and, if possible, send me
example data or a short
description of what you like to do.
It is not unlikely that your feature will appear in the next stable release
of &LabPlot; :-)
Many Analysis functions are disabled. What can I do?
It looks like your &LabPlot; package was compiled without GSL (&GNU; Scientific Library) support. &LabPlot; was designed to even work on systems that
are missing most of the standard libraries. Many distributions are shipping &LabPlot; packages without this additional functionality. In this case some functions are not available. Fortunately some programs (like pstoedit or texvc) can be added without recompiling &LabPlot;. You can always check your system environment in the help menu of &LabPlot;.
The packages provided on the official download page are always built with the standard libraries (GSL, &etc;). You should use them
to have all the features.
I want to help. How can I contribute to &LabPlot;?
Yes, of course. There are a lot things to do. Even if you don't know anything about programming we always
need people to find bugs, test things and make suggestions. Also the translation and documentation always
needs a lot of work.
License
&LabPlot;
Program copyright © 2007-2016 Stefan Gerlach stefan.gerlach@uni-konstanz.de
Program copyright © 2008-2016 Alexander Semke Alexander.Semke@web.de
&LabPlot; is still under development. There is a long list of missing features that will be implemented in later versions of &LabPlot;.
Because there are a lot things to do, developers need every help you can give. Any contribution like wishes, corrections,
patches, bug reports or screen shots is welcome.
Documentation copyright © 2007-2016 Stefan Gerlach
stefan.gerlach@uni-konstanz.de
Documentation copyright © 2008-2015 Alexander Semke
Alexander.Semke@web.de
Documentation copyright © 2014 Yuri Chornoivan
yurchor@ukr.net
&underFDL;
&underGPL;
&documentation.index;