"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/en/index.docbook" between
kpl-4.1.tar.gz and kpl-5.0.tar.gz

About: Kpl is a KDE program for two- and three-dimensional graphical presentation (plots) of data sets and functions. Multidimensional nonlinear parameter and general linear least square parameter fits can be performed.

index.docbook  (kpl-4.1):index.docbook  (kpl-5.0)
<?xml version="1.0" ?> <?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd /kdex.dtd" [ <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd /kdedbx45.dtd" [
<!ENTITY kpl "<application>Kpl</application>"> <!ENTITY kpl "<application>Kpl</application>">
<!ENTITY kappname "&kpl;"> <!ENTITY kappname "&kpl;">
<!ENTITY package "kde-module"> <!ENTITY package "kde-module">
<!ENTITY % addindex "IGNORE"> <!ENTITY % addindex "IGNORE">
<!ENTITY % English "INCLUDE"> <!ENTITY % English "INCLUDE">
]> ]>
<book lang="&language;"> <book lang="&language;">
<bookinfo> <bookinfo>
<title>The &kpl; Handbook</title> <title>The &kpl; Handbook</title>
<authorgroup> <authorgroup>
<author> <author>
<personname> <personname>
<firstname>Werner</firstname> <firstname>Werner</firstname>
<surname>Stille</surname> <surname>Stille</surname>
</personname> </personname>
<email>stille@uni-freiburg.de</email> <email>kpl@werner-stille.de</email>
</author> </author>
</authorgroup> </authorgroup>
<copyright> <copyright>
<year>2015</year> <year>2017</year>
<holder>Werner Stille</holder> <holder>Werner Stille</holder>
</copyright> </copyright>
<legalnotice>&FDLNotice;</legalnotice> <legalnotice>&FDLNotice;</legalnotice>
<date>2015-06-21</date> <date>2017-01-08</date>
<releaseinfo>4.1</releaseinfo> <releaseinfo>5.0</releaseinfo>
<abstract> <abstract>
<para> <para>
&kpl; is a program for two- and three-dimensional graphical presentation of &kpl; is a program for two- and three-dimensional graphical presentation of
data sets and functions. data sets and functions.
</para> </para>
</abstract> </abstract>
<keywordset> <keywordset>
<keyword>KDE</keyword> <keyword>KDE</keyword>
skipping to change at line 56 skipping to change at line 56
</bookinfo> </bookinfo>
<chapter id="introduction"> <chapter id="introduction">
<title>Introduction</title> <title>Introduction</title>
<para> <para>
&kpl; is a program for two- and three-dimensional graphical presentation of &kpl; is a program for two- and three-dimensional graphical presentation of
data sets and functions. Moreover multidimensional nonlinear parameter fits of data sets and functions. Moreover multidimensional nonlinear parameter fits of
functions to data sets can be performed using the Levenberg-Marquardt functions to data sets can be performed using the Levenberg-Marquardt
algorithm. Also general linear least square parameter fits are possible. A algorithm. Also general linear least square parameter fits are possible.
<acronym>D-Bus</acronym> interface can be used to control &kpl; by other A&nbsp; <acronym>D-Bus</acronym> interface can be used to control &kpl; by
applications and scripts.</para> other applications and scripts.</para>
<para> <para>
All settings necessary for a complete description of the presentation can be All settings necessary for a complete description of the presentation can be
saved in plot files. These files as well as data files may be chosen by command saved in plot files. These files as well as data files may be chosen by command
line parameters, using the File menu, or by drag and drop.</para> line parameters, using the File menu, or by drag and drop.</para>
<para> <para>
Automatic scaling and normalization allow the easy graphical presentation Automatic scaling and normalization allow the easy graphical presentation
of data. Also parameter fits can be performed automatically.</para> of data. Also parameter fits can be performed automatically.</para>
<para> <para>
The settings of a presentation may be changed using dialogs for editing the The settings of a presentation may be changed using dialogs for editing the
plot items. Additional data sets and functions can be displayed in the same as plot items. Additional data sets and functions can be displayed in the same as
well as in different data windows.</para> well as in different data windows.</para>
<sect1 id="kpl-revhistory"> <sect1 id="kpl-revhistory">
<title>&kpl; Revision History</title> <title>&kpl; Revision History</title>
<para> <para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Version 5.0 (January 8, 2017)</para>
<itemizedlist>
<listitem><para>Version for KDE Frameworks 5</para></listitem>
<listitem><para>Different line types selectable for arrow, arc, rectangle,
and ellipse items</para></listitem>
<listitem><para>Export as PDF, PNG, PPM, BMP, JPEG, TIFF, or SVG image
file</para></listitem>
<listitem><para>Improved calculation of bounding box</para></listitem>
</itemizedlist>
</listitem>
<listitem>
<para>Version 4.1 (June 21, 2015)</para> <para>Version 4.1 (June 21, 2015)</para>
<itemizedlist> <itemizedlist>
<listitem><para>Library split-off for use of Kpl graphics in other <listitem><para>Library split-off for use of Kpl graphics in other
applications</para></listitem> applications</para></listitem>
<listitem><para>Multiple function items can be fitted simultaneously to the <listitem><para>Multiple function items can be fitted simultaneously to the
same array item</para></listitem> same array item</para></listitem>
<listitem><para>New <acronym>D-Bus</acronym> function <listitem><para>New <acronym>D-Bus</acronym> function
addFunFitItem</para></listitem> addFunFitItem</para></listitem>
<listitem><para><acronym>D-Bus</acronym> function addSplineFitItems renamed to <listitem><para><acronym>D-Bus</acronym> function addSplineFitItems renamed to
addSplineFitItem</para></listitem> addSplineFitItem</para></listitem>
skipping to change at line 446 skipping to change at line 458
function is displayed, too.</para> function is displayed, too.</para>
</sect2> </sect2>
<sect2> <sect2>
<title>Other Command Line Options</title> <title>Other Command Line Options</title>
<para>The following command line help options are available:</para> <para>The following command line help options are available:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><command>kpl <option>--help</option></command></term> <term><command>kpl <option>--help</option></command></term>
<listitem><para>Show help about options</para></listitem> <listitem><para>Show help about options, also available through
<command>kpl <option>-h</option></command></para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><command>kpl <option>--help-qt</option></command></term> <term><command>kpl <option>--version</option></command></term>
<listitem><para>Show Qt specific options</para></listitem> <listitem><para>Show version information, also available through
</varlistentry> <command>kpl <option>-v</option></command>
</para></listitem>
<varlistentry>
<term><command>kpl <option>--help-kde</option></command></term>
<listitem><para>Show KDE specific options</para></listitem>
</varlistentry>
<varlistentry>
<term><command>kpl <option>--help-all</option></command></term>
<listitem><para>Show all options</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><command>kpl <option>--author</option></command></term> <term><command>kpl <option>--author</option></command></term>
<listitem><para>Show author information</para></listitem> <listitem><para>Show author information</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><command>kpl <option>--version</option></command></term> <term><command>kpl <option>--license</option></command></term>
<listitem><para>Show version information, also available through <listitem><para>Show license information</para></listitem>
<command>kpl <option>-v</option></command>
</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><command>kpl <option>--license</option></command></term> <term><command>kpl <option>--desktopfile</option></command>
<listitem><para>Show license information</para></listitem> <replaceable>filename</replaceable></term>
<listitem><para>Specify the base filename of the desktop entry for this
application
</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>
<sect1 id="dolphin"> <sect1 id="dolphin">
<title>Start from Dolphin</title> <title>Start from Dolphin</title>
<para> <para>
skipping to change at line 533 skipping to change at line 539
rectangle, ellipse, line, arrow, and scale bar items.</para> rectangle, ellipse, line, arrow, and scale bar items.</para>
<para> <para>
In the tree view frames are displayed one hierarchical level higher than In the tree view frames are displayed one hierarchical level higher than
the other item types. Other items following a frame are to be plotted in the other item types. Other items following a frame are to be plotted in
that frame. The sequence of items belonging to a frame ends when another that frame. The sequence of items belonging to a frame ends when another
frame item follows. Items not belonging to a frame, that is, items not frame item follows. Items not belonging to a frame, that is, items not
following a frame item, will be plotted without a frame. Function and data following a frame item, will be plotted without a frame. Function and data
set values then will be interpreted as cm. 3D arrays and 3D functions set values then will be interpreted as cm. 3D arrays and 3D functions
contain the function of frames and therefore do not need an additional contain the function of frames and therefore do not need an additional
frame item; also other items can belong to them. The position of an item can be frame item; also other items can belong to them. The position of an item can be
changed by <link linkend="drag-and-drop">Drag and Drop</link> within the list changed using <guilabel>Up</guilabel>, <guilabel>Down</guilabel>,
<guilabel>Top</guilabel>, and <guilabel>Bottom</guilabel> from the
menu&nbsp; <link linkend="edit-menu">Edit</link> and by
<link linkend="drag-and-drop">Drag and Drop</link> within the list
using the mouse.</para> using the mouse.</para>
<para> <para>
Each item is preceeded by a checkbox field, displaying its activation state. Each item is preceeded by a checkbox field, displaying its activation state.
Activated items are shown in the plot, deactivated items are hidden. Activated items are shown in the plot, deactivated items are hidden.
The state can be toggled by clicking the checkbox field with the left mouse The state can be toggled by clicking the checkbox field with the left mouse
button or by the item's context menu, which pops up when an item is clicked button or by the item's context menu, which pops up when an item is clicked
with the right mouse button.</para> with the right mouse button.</para>
<para>An item can be selected without changing its activation state by clicking <para>An item can be selected without changing its activation state by clicking
it right of the checkbox field. More than one item can be selected by holding it right of the checkbox field. More than one item can be selected by holding
down the <keycap>Ctrl</keycap> key when clicking the items. Several actions for down the&nbsp; <keycap>&Ctrl;</keycap> key when clicking the items. Several acti
selected items can be found in the menu ons for
<link linkend="edit-menu">Edit</link>.</para> selected items can be found in the
menu&nbsp; <link linkend="edit-menu">Edit</link>.</para>
<para> <para>
In the tree view, frame items may closed to hide their children for clearness In the tree view, frame items may closed to hide their children for clearness
by clicking the arrow symbol. Reopening to show their children is done by by clicking the arrow symbol. Reopening to show their children is done by
clicking the arrow symbol again. The corresponding state of the frame items clicking the arrow symbol again. The corresponding state of the frame items
will be saved in the plot files.</para> will be saved in the plot files.</para>
</sect1> </sect1>
<sect1 id="drag-and-drop"> <sect1 id="drag-and-drop">
<title>Drag and Drop</title> <title>Drag and Drop</title>
skipping to change at line 570 skipping to change at line 579
<literal role="extension">.dat</literal>, plot files by the extension <literal role="extension">.dat</literal>, plot files by the extension
<literal role="extension">.plo</literal>. In addition to local files also URLs <literal role="extension">.plo</literal>. In addition to local files also URLs
may be passed in this way.</para> may be passed in this way.</para>
<para> <para>
In case of more than one dropped file and activated option In case of more than one dropped file and activated option
<guilabel>Add files</guilabel> in the <guilabel>Add files</guilabel> in the
<link linkend="settings">Basic settings</link> all files are shown in one <link linkend="settings">Basic settings</link> all files are shown in one
window, otherwise new windows are opened for each file.</para> window, otherwise new windows are opened for each file.</para>
<para> <para>
Drag and drop can also be used to move or copy selected items within the item Drag and drop can also be used to move or copy selected items within the item
list. For moving, the <keycap>Shft</keycap> key has to be pressed at drop list. For moving, the&nbsp; <keycap>&Shift;</keycap> key has to be pressed at dr op
time. Dropped items will be inserted before the item they are dropped on, or time. Dropped items will be inserted before the item they are dropped on, or
at the end of the list.</para> at the end of the list.</para>
<para>Also copying of items to another instance of &kpl; can be be performed <para>Also copying of items to another instance of &kpl; can be be performed
by dropping selected items on the item list or the plot window of that by dropping selected items on the item list or the plot window of that
instance.</para> instance.</para>
</sect1> </sect1>
<sect1 id="positioning"> <sect1 id="positioning">
<title>Positioning with the Mouse</title> <title>Positioning with the Mouse</title>
<para> <para>
skipping to change at line 595 skipping to change at line 604
To move an item, its area has to be clicked with the &LMB;. To move an item, its area has to be clicked with the &LMB;.
When the mouse is moved with the &LMB; pressed, a dashed rectangle When the mouse is moved with the &LMB; pressed, a dashed rectangle
shows the current position, displayed also on the status bar. The plot will shows the current position, displayed also on the status bar. The plot will
be updated corresponding to the new position after releasing of the mouse be updated corresponding to the new position after releasing of the mouse
button.</para> button.</para>
<para> <para>
Moving of a frame item will update also the position of all its child Moving of a frame item will update also the position of all its child
items.</para> items.</para>
<para> <para>
More than one item can be selected for simultaneous moving by clicking More than one item can be selected for simultaneous moving by clicking
their areas with the <keycap>Ctrl</keycap> key pressed.</para> their areas with the&nbsp; <keycap>&Ctrl;</keycap> key pressed.</para>
</sect1> </sect1>
<sect1 id="scaling"> <sect1 id="scaling">
<title>Scaling with the Mouse</title> <title>Scaling with the Mouse</title>
<para> <para>
In addition to change the scaling of a 2D plot using the In addition to change the scaling of a 2D plot using the
<link linkend="frame">Frame</link> dialog, a displayed plot containing a frame <link linkend="frame">Frame</link> dialog, a displayed plot containing a frame
item can be rescaled conveniently with the help of the mouse. For this, one item can be rescaled conveniently with the help of the mouse. For this, one
corner of a rectangle has to be defined by pressing the middle mouse button. corner of a rectangle has to be defined by pressing the middle mouse button.
Then, by moving the mouse diagonally, a rectangle is drawn. Its final size will Then, by moving the mouse diagonally, a rectangle is drawn. Its final size will
skipping to change at line 649 skipping to change at line 658
<chapter id="commands"> <chapter id="commands">
<title>Command Reference</title> <title>Command Reference</title>
<sect1 id="file-menu"> <sect1 id="file-menu">
<title>The File Menu</title> <title>The File Menu</title>
<para> <para>
<variablelist> <variablelist>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>N</keycap></keycombo></shortcut>
<guimenu><accel>F</accel>ile</guimenu><guimenuitem><accel>N</accel>ew</guimenuit em> <guimenu><accel>F</accel>ile</guimenu><guimenuitem><accel>N</accel>ew</guimenuit em>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Creates a new empty plot.</action> <listitem><para><action>Creates a new empty plot.</action>
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>O</keycap></keycombo></shortcut>
<guimenu><accel>F</accel>ile</guimenu><guimenuitem><accel>O</accel>pen Plot File </guimenuitem> <guimenu><accel>F</accel>ile</guimenu><guimenuitem><accel>O</accel>pen Plot File </guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Opens one or more existing plot files.</action></para> <listitem><para><action>Opens one or more existing plot files.</action></para>
<para> <para>
In a plot file all settings of a graphical presentation are stored in the INI In a plot file all settings of a graphical presentation are stored in the INI
style.</para> style.</para>
<para> <para>
In case of more than one selected file and activated option In case of more than one selected file and activated option
<guilabel>Add files</guilabel> in the <guilabel>Add files</guilabel> in the
<link linkend="settings">Basic settings</link>, all files are shown in one <link linkend="settings">Basic settings</link>, all files are shown in one
skipping to change at line 700 skipping to change at line 709
In case of more than one selected file and activated option In case of more than one selected file and activated option
<guilabel>Add files</guilabel> in the <guilabel>Add files</guilabel> in the
<link linkend="settings">Basic settings</link>, all files are shown in one <link linkend="settings">Basic settings</link>, all files are shown in one
window, otherwise for each file a new window is opened.</para> window, otherwise for each file a new window is opened.</para>
<para> <para>
Loading of data files overwrites an eventually displayed presentation Loading of data files overwrites an eventually displayed presentation
in case of deactivated option <guilabel>Add files</guilabel>. in case of deactivated option <guilabel>Add files</guilabel>.
When a data file is to be inserted in an existing graphical presentation, When a data file is to be inserted in an existing graphical presentation,
this has to be done by first activating <guilabel>Add files</guilabel>, or this has to be done by first activating <guilabel>Add files</guilabel>, or
by creating a new array item using by creating a new array item using
<link linkend="edit-menu"><guimenuitem>New Item</guimenuitem></link>.</para></li stitem> <link linkend="edit-menu">New Item</link>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu> <guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>Open <accel>R</accel>ecent</guimenuitem> <guimenuitem>Open <accel>R</accel>ecent</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Opens a submenu for selecting one of up to ten <listitem><para><action>Opens a submenu for selecting one of up to ten
recently opened plot or data files.</action></para> recently opened plot or data files.</action></para>
<para> <para>
In case of activated setting <guilabel>Add files</guilabel> the file is In case of activated setting <guilabel>Add files</guilabel> the file is
appended to an existing plot, otherwise it will replace the current appended to an existing plot, otherwise it will replace the current
plot.</para></listitem> plot.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>S</keycap></keycombo></shortcut>
<guimenu><accel>F</accel>ile</guimenu><guimenuitem><accel>S</accel>ave</guimenui tem> <guimenu><accel>F</accel>ile</guimenu><guimenuitem><accel>S</accel>ave</guimenui tem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Saves created or edited plot files. <listitem><para><action>Saves created or edited plot files.
</action></para></listitem> </action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap>
<keycap>&Shift;</keycap><keycap>S</keycap></keycombo></shortcut>
<guimenu><accel>F</accel>ile</guimenu> <guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>Save <accel>A</accel>s</guimenuitem> <guimenuitem>Save <accel>A</accel>s</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Allows to save the current graphical presentation <listitem><para><action>Allows to save the current graphical presentation
as a plot file with another name.</action></para></listitem> as a plot file with another name.</action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>P</keycap></keycombo></shortcut>
<guimenu><accel>F</accel>ile</guimenu><guimenuitem><accel>P</accel>rint</guimenu item> <guimenu><accel>F</accel>ile</guimenu><guimenuitem><accel>P</accel>rint</guimenu item>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Prints the graphical presentation to a printer <listitem><para><action>Prints the graphical presentation to a printer
chosen from a list or to a file.</action></para></listitem> chosen from a list or to a file.</action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu> <guimenu><accel>F</accel>ile</guimenu>
<guisubmenu>PostScript Outp<accel>u</accel>t</guisubmenu> <guisubmenu>PostScript O<accel>u</accel>tput</guisubmenu>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Saves the graphical presentation as a PostScript <listitem><para><action>Saves the graphical presentation as a PostScript
file in </action> <guimenuitem><accel>P</accel>ortrait</guimenuitem> or file in </action> <guimenuitem><accel>P</accel>ortrait</guimenuitem> or
<guimenuitem><accel>L</accel>andscape</guimenuitem> orientation.</para> <guimenuitem><accel>L</accel>andscape</guimenuitem> orientation.</para>
<para> <para>
If the <guilabel>Use internal PS encoding</guilabel> option in the
<link linkend="basic">Basic Settings</link> is checked, &kpl; creates files
which may be edited easily.</para>
<para>
The output can be chosen to be PostScript (PS) or Encapsulated PostScript The output can be chosen to be PostScript (PS) or Encapsulated PostScript
(EPS), the latter allowing to import the graphics in other applications. (EPS), the latter allowing to import the graphics in other applications.
The bounding box is calculated exactly when The bounding box is calculated exactly when
<guilabel>Calculate PS Bounding Box</guilabel> is checked in the <guilabel>Calculate Bounding Box</guilabel> is checked in the
<link linkend="basic">Basic Settings</link>.</para></listitem> <link linkend="basic">Basic Settings</link>.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu> <guimenu><accel>F</accel>ile</guimenu>
<guisubmenu>PostScript Pre<accel>v</accel>iew</guisubmenu> <guisubmenu>PostScript Pre<accel>v</accel>iew</guisubmenu>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Creates a temporary PostScript file in <listitem><para><action>Creates a temporary PostScript file
</action> <guimenuitem><accel>P</accel>ortrait</guimenuitem> or in </action> <guimenuitem><accel>P</accel>ortrait</guimenuitem>
<guimenuitem><accel>L</accel>andscape</guimenuitem> orientation and displays it or <guimenuitem><accel>L</accel>andscape</guimenuitem> orientation and displays
by invoking the application (e.g. Okular) currently associated to PostScript it by invoking the application (e.g. Okular) currently associated to PostScript
files. This allows to print the PostScript output without permanently saving a files. This allows to print the PostScript output without permanently saving a
PostScript file.</para></listitem> PostScript file.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu> <guimenu><accel>F</accel>ile</guimenu>
<guimenuitem><accel>E</accel>xport</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves the graphical presentation as PDF, PNG, PPM, BMP,
JPEG, TIFF, or SVG image file.</action></para>
<para>
The minimum page size will be chosen
when <guilabel>Calculate Bounding Box</guilabel> is checked in
the <link linkend="basic">Basic Settings</link>.</para></listitem>
</varlistentry>
<varlistentry><term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>New <accel>W</accel>indow</guimenuitem> <guimenuitem>New <accel>W</accel>indow</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Opens a new instance of &kpl;. <listitem><para><action>Opens a new instance of &kpl;.
</action></para></listitem> </action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>F</accel>ile</guimenu> <guimenu><accel>F</accel>ile</guimenu>
<guimenuitem>Close W<accel>i</accel>ndow</guimenuitem> <guimenuitem>Close W<accel>i</accel>ndow</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Close the window.</action> If the closed window <listitem><para><action>Close the window.</action> If the closed window
was the last instance open, &kpl; will exit.</para></listitem> was the last instance open, &kpl; will exit.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>Q</keycap></keycombo></shortcut>
<guimenu><accel>F</accel>ile</guimenu><guimenuitem><accel>Q</accel>uit</guimenui tem> <guimenu><accel>F</accel>ile</guimenu><guimenuitem><accel>Q</accel>uit</guimenui tem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Exits &kpl;.</action></para></listitem> <listitem><para><action>Exits &kpl;.</action></para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</para> </para>
</sect1> </sect1>
<sect1 id="edit-menu"> <sect1 id="edit-menu">
<title>The Edit Menu</title> <title>The Edit Menu</title>
<para> <para>
<variablelist> <variablelist>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>Z</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>U</accel>ndo</guimenui <guimenu><accel>E</accel>dit</guimenu><guimenuitem>Undo</guimenuitem>
tem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>This is used to eliminate or reverse the most <listitem><para><action>This is used to eliminate or reverse the most
recent change of the plot.</action> The maximum number of saved states recent change of the plot.</action> The maximum number of saved states
is 1000.</para></listitem> is 1000.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Ctrl</keycap> <varlistentry><term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap>
<keycap>Shft</keycap><keycap>Z</keycap></keycombo></shortcut> <keycap>&Shift;</keycap><keycap>Z</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>R</accel>edo</guimenui tem> <guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>R</accel>edo</guimenui tem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>This will reverse the most recent change <listitem><para><action>This will reverse the most recent change
made using </action> <guimenuitem><accel>U</accel>ndo</guimenuitem>. made using&nbsp; </action> <guimenuitem><accel>U</accel>ndo</guimenuitem>.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Ctrl</keycap> <varlistentry><term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap>
<keycap>X</keycap></keycombo></shortcut> <keycap>X</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu><guimenuitem>Cu<accel>t</accel></guimenuit em> <guimenu><accel>E</accel>dit</guimenu><guimenuitem>Cu<accel>t</accel></guimenuit em>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Moves</action> the selected items from the item list <listitem><para><action>Moves</action> the selected items from the item list
to the clipboard.</para></listitem> to the clipboard.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Ctrl</keycap> <varlistentry><term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap>
<keycap>C</keycap></keycombo></shortcut> <keycap>C</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>C</accel>opy</guimenui tem> <guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>C</accel>opy</guimenui tem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Copies</action> the selected items of the item list <listitem><para><action>Copies</action> the selected items of the item list
to the clipboard.</para></listitem> to the clipboard.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Ctrl</keycap> <varlistentry><term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap>
<keycap>V</keycap></keycombo></shortcut> <keycap>V</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>P</accel>aste</guimenu item> <guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>P</accel>aste</guimenu item>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Pastes</action> items or a plot file stored in the <listitem><para><action>Pastes</action> items or a plot file stored in the
clipboard before the selected item of the list, or, if no item is selected, at clipboard before the selected item of the list, or, if no item is selected, at
the end of the list.</para></listitem> the end of the list.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>N</accel>ew Item</guim enuitem> <guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>N</accel>ew Item</guim enuitem>
skipping to change at line 869 skipping to change at line 887
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Opens a dialog to edit</action> the selected item.</para ></listitem> <listitem><para><action>Opens a dialog to edit</action> the selected item.</para ></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>F</accel>it</guimenuit em> <guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>F</accel>it</guimenuit em>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Opens a dialog to perform a fit</action> of function(s) <listitem><para><action>Opens a dialog to perform a fit</action> of function(s)
or spline(s) to the data set(s) of array item(s).</para> or spline(s) to the data set(s) of array item(s).</para>
<para>When one ore more functions and one or more arrays are selected, the <para>When one ore more functions and one or more arrays are selected, the
dialog <link linkend="fit">Parameter fit</link> to perform a (multidimensional) dialog&nbsp; <link linkend="fit">Parameter fit</link> to perform a
parameter fit of the function(s) to the data set(s) of the array item(s) will (multidimensional) parameter fit of the function(s) to the data set(s) of the
be opened. When the item list contains exactly one function and one array array item(s) will be opened. When the item list contains exactly one function
item, no multiselection is necessary and the dialog is just opened to perform a and one array item, no multiselection is necessary and the dialog is just
parameter fit in one dimension. Otherwise you first have to select one or opened to perform a parameter fit in one dimension. Otherwise you first have to
more array items and at least the same number of function items. In case of select one or more array items and at least the same number of function items.
multidimensional fits (more than one array item selected), the first selected In case of multidimensional fits (more than one array item selected), the first
function item in the list corresponds to the first selected array item in the selected function item in the list corresponds to the first selected array item
list and so on. When more function items than array items are selected, the in the list and so on. When more function items than array items are selected,
resulting parameters will be applied also to the extra function items, when the resulting parameters will be applied also to the extra function items, when
indicated.</para> indicated.</para>
<para>When one or more splines and one array are selected, the button opens the <para>When one or more splines and one array are selected, the button opens the
dialog <link linkend="spline-fit">Smoothing spline fit</link> to perform a fit dialog&nbsp; <link linkend="spline-fit">Smoothing spline fit</link> to perform
of a (smoothing) spline to the data set of the array item.</para></listitem> a fit of a (smoothing) spline to the data set of the array
item.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut><keycap>Del</keycap> <varlistentry><term><menuchoice><shortcut><keycap>Del</keycap>
</shortcut> </shortcut>
<guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>D</accel>elete</guimen uitem> <guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>D</accel>elete</guimen uitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Deletes</action> the selected item(s).</para></listitem> <listitem><para><action>Deletes</action> the selected item(s).</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>A</accel>ctive</guimen uitem> <guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>A</accel>ctive</guimen uitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Changes the activation state of the selected item. <listitem><para><action>Changes the activation state of the selected item.
Activated items are shown in the plot, deactivated items are Activated items are shown in the plot, deactivated items are
hidden.</action></para></listitem> hidden.</action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>Up Arrow</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>Up</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>U</accel>p</guimenuite m> <guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>U</accel>p</guimenuite m>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Moves the selected item upwards in the <listitem><para><action>Moves the selected item upwards in the
list.</action></para></listitem> list.</action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>Down Arrow</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>Down</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>dit</guimenu><guimenuitem>D<accel>o</accel>wn</guimenui tem> <guimenu><accel>E</accel>dit</guimenu><guimenuitem>D<accel>o</accel>wn</guimenui tem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Moves the selected item downwards in the <listitem><para><action>Moves the selected item downwards in the
list.</action></para></listitem> list.</action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>T</accel>op</guimenuit em> <guimenu><accel>E</accel>dit</guimenu><guimenuitem><accel>T</accel>op</guimenuit em>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Moves the selected item to the top of the <listitem><para><action>Moves the selected item to the top of the
skipping to change at line 950 skipping to change at line 969
</sect1> </sect1>
<sect1 id="view-menu"> <sect1 id="view-menu">
<title>The View Menu</title> <title>The View Menu</title>
<para> <para>
<variablelist> <variablelist>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>+</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>+</keycap></keycombo></shortcut>
<guimenu><accel>V</accel>iew</guimenu><guimenuitem>Zoom <accel>I</accel>n</guime nuitem> <guimenu><accel>V</accel>iew</guimenu><guimenuitem>Zoom <accel>I</accel>n</guime nuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Increases the magnification by 20&nbsp;%. <listitem><para><action>Increases the magnification by 20&nbsp;%.
</action></para></listitem> </action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>-</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>-</keycap></keycombo></shortcut>
<guimenu><accel>V</accel>iew</guimenu><guimenuitem>Zoom <accel>O</accel>ut</guim enuitem> <guimenu><accel>V</accel>iew</guimenu><guimenuitem>Zoom <accel>O</accel>ut</guim enuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Decreases the magnification by 20&nbsp;%. <listitem><para><action>Decreases the magnification by 20&nbsp;%.
</action></para></listitem> </action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>V</accel>iew</guimenu><guimenuitem><accel>Z</accel>oom</guimenui tem> <guimenu><accel>V</accel>iew</guimenu><guimenuitem><accel>Z</accel>oom</guimenui tem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Here the magnification factor of the graphical <listitem><para><action>Here the magnification factor of the graphical
skipping to change at line 999 skipping to change at line 1018
</sect1> </sect1>
<sect1 id="settings-menu"> <sect1 id="settings-menu">
<title>The Settings Menu</title> <title>The Settings Menu</title>
<para> <para>
<variablelist> <variablelist>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Show <accel>T</accel>ool Bar</guimenuitem> <guimenu><accel>S</accel>ettings</guimenu><guimenuitem><accel>S</accel>how Tool Bar</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>This toggles the display of the tool bar. <listitem><para><action>This toggles the display of the tool bar.
</action></para></listitem> </action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Show St<accel>a</accel>tu s Bar</guimenuitem> <guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Show St<accel>a</accel>tu s Bar</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>This toggles the display of the status bar. <listitem><para><action>This toggles the display of the status bar.
</action></para></listitem> </action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu><guimenuitem>S<accel>h</accel>ow Funct ion Source</guimenuitem> <guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Show Function Sou<accel>r </accel>ce</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>This toggles the display of the functions source <listitem><para><action>This toggles the display of the functions source
files in the dialogs for function parameters</action></para></listitem> files in the dialogs for function parameters</action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut><keycap>Insert</keycap></shortcut> <varlistentry><term><menuchoice><shortcut><keycap>Insert</keycap></shortcut>
<guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Add <accel>F</accel>iles< /guimenuitem> <guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Add <accel>F</accel>iles< /guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>This toggles the adding of plot and data files to <listitem><para><action>This toggles the adding of plot and data files to
existing plots and overwriting, respectively. The current state of this existing plots and overwriting, respectively. The current state of this
setting is displayed on the status bar.</action></para></listitem> setting is displayed on the status bar.</action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Calculate <accel>P</accel <guimenu><accel>S</accel>ettings</guimenu>
>S Bounding Box <guimenuitem>Ca<accel>l</accel>culate Bounding Box</guimenuitem></menuchoice></t
</guimenuitem></menuchoice></term> erm>
<listitem><para><action>This toggles the automatic calculation of the <listitem><para><action>This toggles the automatic calculation of the
bounding box for generated PostScript files.</action> The calculation needs bounding box for generated PostScript files.</action> The calculation needs
<application>Ghostscript</application> to be installed and assumes that the <application>Ghostscript</application> to be installed and assumes that the
<guilabel>Page format</guilabel> on the page <guilabel>Page format</guilabel> on the page
<link linkend="basic">Basic Settings</link> of &kpl;'s settings dialog is set <link linkend="basic">Basic Settings</link> of &kpl;'s settings dialog is set
sufficiently large to contain all parts of the plot. Without calculation the sufficiently large to contain all parts of the plot. Without calculation the
bounding box is set according to that page format.</para></listitem> bounding box is set according to that page format.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Save Absol<accel>u</accel >te Paths <guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Save Absol<accel>u</accel >te Paths
</guimenuitem></menuchoice></term> </guimenuitem></menuchoice></term>
<listitem><para><action>Tis toggles the saving of absolute or relative paths <listitem><para><action>Tis toggles the saving of absolute or relative paths
of data and library files in plot files.</action> When this option of data and library files in plot files.</action> When this option
is set on, the paths always saved as absolute. This is the default setting, is set on, the paths always saved as absolute. When the option is set off, the
compatible with older versions of &kpl;. When the option is set off, the
paths are saved as relative paths to that of the plot file, if possible. paths are saved as relative paths to that of the plot file, if possible.
This allows to move directory branches containing the plot file and all This allows to move directory branches containing the plot file and all
files it depends on.</para></listitem> files it depends on.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Unsaved Changes <accel>W< /accel>arning <guimenu><accel>S</accel>ettings</guimenu><guimenuitem>Unsaved Changes <accel>W< /accel>arning
</guimenuitem></menuchoice></term> </guimenuitem></menuchoice></term>
<listitem><para><action>This toggles the display of warnings at unsaved <listitem><para><action>This toggles the display of warnings at unsaved
changes.</action></para></listitem> changes.</action></para></listitem>
skipping to change at line 1170 skipping to change at line 1188
<sect2><title>Item Specific</title> <sect2><title>Item Specific</title>
<para> <para>
Clicking the area of an item in the plot or in the item list with the right Clicking the area of an item in the plot or in the item list with the right
mouse button brings up a context menu with actions corresponding to that item mouse button brings up a context menu with actions corresponding to that item
(also available in the <link linkend="edit-menu">Edit</link>) menu:</para> (also available in the <link linkend="edit-menu">Edit</link>) menu:</para>
<para> <para>
<variablelist> <variablelist>
<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Ctrl</keycap> <varlistentry><term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap>
<keycap>X</keycap></keycombo></shortcut> <keycap>X</keycap></keycombo></shortcut>
<guimenuitem>Cu<accel>t</accel></guimenuitem> <guimenuitem>Cu<accel>t</accel></guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Moves</action> the selected items from the item list <listitem><para><action>Moves</action> the selected items from the item list
to the clipboard.</para></listitem> to the clipboard.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Ctrl</keycap> <varlistentry><term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap>
<keycap>C</keycap></keycombo></shortcut> <keycap>C</keycap></keycombo></shortcut>
<guimenuitem><accel>C</accel>opy</guimenuitem> <guimenuitem><accel>C</accel>opy</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Copies</action> the selected items of the item list <listitem><para><action>Copies</action> the selected items of the item list
to the clipboard.</para></listitem> to the clipboard.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Ctrl</keycap> <varlistentry><term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap>
<keycap>V</keycap></keycombo></shortcut> <keycap>V</keycap></keycombo></shortcut>
<guimenuitem><accel>P</accel>aste</guimenuitem> <guimenuitem><accel>P</accel>aste</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Pastes</action> items stored in the clipboard before <listitem><para><action>Pastes</action> items stored in the clipboard before
the selected item of the list, or, if no item is selected, at the end the selected item of the list, or, if no item is selected, at the end
of the list.</para></listitem> of the list.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenuitem><accel>N</accel>ew Item</guimenuitem> <guimenuitem><accel>N</accel>ew Item</guimenuitem>
skipping to change at line 1242 skipping to change at line 1260
<para> <para>
Clicking the empty parts of the plot window or the item list with the right Clicking the empty parts of the plot window or the item list with the right
mouse button brings up a context menu with the most important mouse button brings up a context menu with the most important
actions:</para> actions:</para>
<para> <para>
<variablelist> <variablelist>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>N</keycap></keycombo></shortcut>
<guimenuitem><accel>N</accel>ew</guimenuitem> <guimenuitem><accel>N</accel>ew</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Opens a new plot file.</action> <listitem><para><action>Opens a new plot file.</action>
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>O</keycap></keycombo></shortcut>
<guimenuitem><accel>O</accel>pen Plot File</guimenuitem> <guimenuitem><accel>O</accel>pen Plot File</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Opens one or more existing plot files.</action></para> <listitem><para><action>Opens one or more existing plot files.</action></para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenuitem>Open <accel>D</accel>ata File</guimenuitem> <guimenuitem>Open <accel>D</accel>ata File</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Opens one or more existing data files.</action></para> <listitem><para><action>Opens one or more existing data files.</action></para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>S</keycap></keycombo></shortcut>
<guimenuitem><accel>S</accel>ave</guimenuitem> <guimenuitem><accel>S</accel>ave</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Saves the current plot file. <listitem><para><action>Saves the current plot file.
</action></para></listitem> </action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap>
<keycap>&Shift;</keycap><keycap>S</keycap></keycombo></shortcut>
<guimenuitem>Save <accel>A</accel>s</guimenuitem> <guimenuitem>Save <accel>A</accel>s</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Saves the current graphical presentation in a new plot <listitem><para><action>Saves the current graphical presentation in a new plot
file.</action></para></listitem> file.</action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>P</keycap></keycombo></shortcut>
<guimenuitem><accel>P</accel>rint</guimenuitem> <guimenuitem><accel>P</accel>rint</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Prints the graphical presentation.</action></para></list item> <listitem><para><action>Prints the graphical presentation.</action></para></list item>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guisubmenu>PostScript Outp<accel>u</accel>t</guisubmenu> <guisubmenu>PostScript O<accel>u</accel>tput</guisubmenu>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Saves the graphical presentation as a PostScript <listitem><para><action>Saves the graphical presentation as a PostScript
file in </action> <guimenuitem><accel>P</accel>ortrait</guimenuitem> or file in </action> <guimenuitem><accel>P</accel>ortrait</guimenuitem> or
<guimenuitem><accel>L</accel>andscape</guimenuitem> orientation.</para> <guimenuitem><accel>L</accel>andscape</guimenuitem> orientation.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut><keycombo><keycap>Ctrl</keycap> <varlistentry><term><menuchoice>
<guimenuitem><accel>E</accel>xport</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves the graphical presentation as PDF, PNG, PPM, BMP,
JPEG, TIFF, or SVG image file.</action></para></listitem>
</varlistentry>
<varlistentry><term><menuchoice><shortcut><keycombo><keycap>&Ctrl;</keycap>
<keycap>V</keycap></keycombo></shortcut> <keycap>V</keycap></keycombo></shortcut>
<guimenuitem><accel>P</accel>aste</guimenuitem> <guimenuitem><accel>P</accel>aste</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Pastes</action> items stored in the clipboard before <listitem><para><action>Pastes</action> items stored in the clipboard before
the item.</para></listitem> the item.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenuitem><accel>N</accel>ew Item</guimenuitem> <guimenuitem><accel>N</accel>ew Item</guimenuitem>
</menuchoice></term> </menuchoice></term>
skipping to change at line 1319 skipping to change at line 1345
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice> <varlistentry><term><menuchoice>
<guimenuitem>I<accel></accel>tems</guimenuitem> <guimenuitem>I<accel></accel>tems</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Opens the dock window </action> <listitem><para><action>Opens the dock window </action>
<link linkend="items">Items</link> (if not already open).</para></listitem> <link linkend="items">Items</link> (if not already open).</para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>+</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>+</keycap></keycombo></shortcut>
<guimenuitem>Zoom <accel>I</accel>n</guimenuitem> <guimenuitem>Zoom <accel>I</accel>n</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Increases magnification by 20&nbsp;%. <listitem><para><action>Increases magnification by 20&nbsp;%.
</action></para></listitem> </action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut> <varlistentry><term><menuchoice><shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>-</keycap></keycombo></shortcut> <keycombo><keycap>&Ctrl;</keycap><keycap>-</keycap></keycombo></shortcut>
<guimenuitem>Zoom <accel>O</accel>ut</guimenuitem> <guimenuitem>Zoom <accel>O</accel>ut</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Decreases magnification by 20&nbsp;%. <listitem><para><action>Decreases magnification by 20&nbsp;%.
</action></para></listitem> </action></para></listitem>
</varlistentry> </varlistentry>
<varlistentry><term><menuchoice><shortcut><keycap>F5</keycap></shortcut> <varlistentry><term><menuchoice><shortcut><keycap>F5</keycap></shortcut>
<guimenuitem><accel>R</accel>edisplay</guimenuitem> <guimenuitem><accel>R</accel>edisplay</guimenuitem>
</menuchoice></term> </menuchoice></term>
<listitem><para><action>Reloads the current file and refreshes the <listitem><para><action>Reloads the current file and refreshes the
skipping to change at line 1368 skipping to change at line 1394
<thead> <thead>
<row> <row>
<entry>Key Binding</entry> <entry>Key Binding</entry>
<entry>Action</entry> <entry>Action</entry>
</row> </row>
</thead> </thead>
<tbody> <tbody>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></entry> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>N</keycap></keycombo></entry>
<entry><action>Opens a new plot file.</action></entry> <entry><action>Opens a new plot file.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></entry> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>O</keycap></keycombo></entry>
<entry><action>Opens an existing plot file.</action></entry> <entry><action>Opens an existing plot file.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo></entry> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>S</keycap></keycombo></entry>
<entry><action>Saves the current plot file.</action></entry> <entry><action>Saves the current plot file.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>P</keycap></keycombo></entry> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>&Shift;</keycap><keycap>S</keyca
p></keycombo></entry>
<entry><action>Saves the current graphical presentation in a new plot
file.</action></entry>
</row>
<row>
<entry><keycombo><keycap>&Ctrl;</keycap><keycap>P</keycap></keycombo></entry>
<entry><action>Prints the graphical presentation.</action></entry> <entry><action>Prints the graphical presentation.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo></entry> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>Q</keycap></keycombo></entry>
<entry><action>Quits &kpl;.</action></entry> <entry><action>Quits &kpl;.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>Z</keycap></keycombo></entry> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>Z</keycap></keycombo></entry>
<entry><action>Reverses the last change of the plot.</action></entry> <entry><action>Reverses the last change of the plot.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>Shft</keycap> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>&Shift;</keycap>
<keycap>Z</keycap></keycombo></entry> <keycap>Z</keycap></keycombo></entry>
<entry><action>Reverses the last change of the plot made using </action> <entry><action>Reverses the last change of the plot made using </action>
<guimenuitem>Undo</guimenuitem>.</entry> <guimenuitem>Undo</guimenuitem>.</entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>X</keycap></keycombo></entry> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>X</keycap></keycombo></entry>
<entry><action>Moves the selected items from the item list <entry><action>Moves the selected items from the item list
to the clipboard.</action></entry> to the clipboard.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo></entry> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>C</keycap></keycombo></entry>
<entry><action>Copies the selected items from the item list <entry><action>Copies the selected items from the item list
to the clipboard.</action></entry> to the clipboard.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>V</keycap></keycombo></entry> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>V</keycap></keycombo></entry>
<entry><action>Pastes items stored in the clipboard before <entry><action>Pastes items stored in the clipboard before
the selected item of the list, or, if no item is selected, at the end the selected item of the list, or, if no item is selected, at the end
of the list.</action></entry> of the list.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>F2</keycap></keycombo></entry> <entry><keycombo><keycap>F2</keycap></keycombo></entry>
<entry><action>Opens a dialog to edit the selected item.</action></entry> <entry><action>Opens a dialog to edit the selected item.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Del</keycap></keycombo></entry> <entry><keycombo><keycap>Del</keycap></keycombo></entry>
<entry><action>Deletes the selected item.</action></entry> <entry><action>Deletes the selected item.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>Up Arrow</keycap></keycombo></entr y> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>Up</keycap></keycombo></entry>
<entry><action>Moves the selected item upwards in the list. <entry><action>Moves the selected item upwards in the list.
</action></entry> </action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>Down Arrow</keycap></keycombo></en try> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>Down</keycap></keycombo></entry>
<entry><action>Moves the selected item downwards in the list. <entry><action>Moves the selected item downwards in the list.
</action></entry> </action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>+</keycap></keycombo></entry> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>+</keycap></keycombo></entry>
<entry><action>Increases magnification by 20&nbsp;%. <entry><action>Increases magnification by 20&nbsp;%.
</action></entry> </action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>-</keycap></keycombo></entry> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>-</keycap></keycombo></entry>
<entry><action>Decreases magnification by 20&nbsp;%. <entry><action>Decreases magnification by 20&nbsp;%.
</action></entry> </action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>F5</keycap></keycombo></entry> <entry><keycombo><keycap>F5</keycap></keycombo></entry>
<entry><action>Reloads the current file and refreshes the plot. <entry><action>Reloads the current file and refreshes the plot.
</action></entry> </action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Insert</keycap></keycombo></entry> <entry><keycombo><keycap>Ins</keycap></keycombo></entry>
<entry><action>Toggles the adding of plot and data files to existing plots <entry><action>Toggles the adding of plot and data files to existing plots
and overwriting, respectively. and overwriting, respectively.
</action></entry> </action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>F1</keycap></keycombo></entry> <entry><keycombo><keycap>F1</keycap></keycombo></entry>
<entry><action>Opens the &kpl; handbook. <entry><action>Opens the &kpl; handbook.
</action></entry> </action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Left Arrow</keycap></keycombo></entry> <entry><keycombo><keycap>Left</keycap></keycombo></entry>
<entry><action>Scrolls left.</action></entry> <entry><action>Scrolls left.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Right Arrow</keycap></keycombo></entry> <entry><keycombo><keycap>Right</keycap></keycombo></entry>
<entry><action>Scrolls left.</action></entry> <entry><action>Scrolls left.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Down Arrow</keycap></keycombo></entry> <entry><keycombo><keycap>Down</keycap></keycombo></entry>
<entry><action>Scrolls down.</action></entry> <entry><action>Scrolls down.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Up Arrow</keycap></keycombo></entry> <entry><keycombo><keycap>Up</keycap></keycombo></entry>
<entry><action>Scrolls up.</action></entry> <entry><action>Scrolls up.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Page Up</keycap></keycombo></entry> <entry><keycombo><keycap>PgUp</keycap></keycombo></entry>
<entry><action>Scrolls page up.</action></entry> <entry><action>Scrolls page up.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Page Down</keycap></keycombo></entry> <entry><keycombo><keycap>PgDn</keycap></keycombo></entry>
<entry><action>Scrolls page down.</action></entry> <entry><action>Scrolls page down.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Shft</keycap><keycap>Page Up</keycap> <entry><keycombo><keycap>&Shift;</keycap><keycap>PgUp</keycap>
</keycombo></entry> </keycombo></entry>
<entry><action>Scrolls page left.</action></entry> <entry><action>Scrolls page left.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Shft</keycap><keycap>Page Down</keycap> <entry><keycombo><keycap>&Shift;</keycap><keycap>PgDn</keycap>
</keycombo></entry> </keycombo></entry>
<entry><action>Scrolls page right.</action></entry> <entry><action>Scrolls page right.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Home</keycap></keycombo></entry> <entry><keycombo><keycap>Home</keycap></keycombo></entry>
<entry><action>Scrolls to bottom margin.</action></entry> <entry><action>Scrolls to bottom margin.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>End</keycap></keycombo></entry> <entry><keycombo><keycap>End</keycap></keycombo></entry>
<entry><action>Scrolls to top margin.</action></entry> <entry><action>Scrolls to top margin.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>Home</keycap> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>Home</keycap>
</keycombo></entry> </keycombo></entry>
<entry><action>Scrolls to left margin.</action></entry> <entry><action>Scrolls to left margin.</action></entry>
</row> </row>
<row> <row>
<entry><keycombo><keycap>Ctrl</keycap><keycap>End</keycap> <entry><keycombo><keycap>&Ctrl;</keycap><keycap>End</keycap>
</keycombo></entry> </keycombo></entry>
<entry><action>Scrolls to right margin.</action></entry> <entry><action>Scrolls to right margin.</action></entry>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
</informaltable> </informaltable>
</sect1> </sect1>
<sect1 id="toolbar"> <sect1 id="toolbar">
skipping to change at line 1575 skipping to change at line 1607
<row> <row>
<entry><inlinemediaobject><imageobject> <entry><inlinemediaobject><imageobject>
<imagedata fileref="document-new.png" format="PNG"/> <imagedata fileref="document-new.png" format="PNG"/>
</imageobject></inlinemediaobject></entry> </imageobject></inlinemediaobject></entry>
<entry>New</entry> <entry>New</entry>
<entry><action>Opens a new plot file.</action></entry> <entry><action>Opens a new plot file.</action></entry>
</row> </row>
<row> <row>
<entry><inlinemediaobject><imageobject> <entry><inlinemediaobject><imageobject>
<imagedata fileref="kpl-plot.png" format="PNG"/> <imagedata fileref="kpl-document-open.png" format="PNG"/>
</imageobject></inlinemediaobject></entry> </imageobject></inlinemediaobject></entry>
<entry>Open Plot File</entry> <entry>Open Plot File</entry>
<entry><action>Opens an existing plot file.</action></entry> <entry><action>Opens an existing plot file.</action></entry>
</row> </row>
<row> <row>
<entry><inlinemediaobject><imageobject> <entry><inlinemediaobject><imageobject>
<imagedata fileref="document-open.png" format="PNG"/> <imagedata fileref="document-open.png" format="PNG"/>
</imageobject></inlinemediaobject></entry> </imageobject></inlinemediaobject></entry>
<entry>Open Data File</entry> <entry>Open Data File</entry>
skipping to change at line 1624 skipping to change at line 1656
<entry><inlinemediaobject><imageobject> <entry><inlinemediaobject><imageobject>
<imagedata fileref="edit-redo.png" format="PNG"/> <imagedata fileref="edit-redo.png" format="PNG"/>
</imageobject></inlinemediaobject></entry> </imageobject></inlinemediaobject></entry>
<entry>Redo</entry> <entry>Redo</entry>
<entry><action>Reverses the last change of the plot made using </action> <entry><action>Reverses the last change of the plot made using </action>
<guimenuitem>Undo</guimenuitem>.</entry> <guimenuitem>Undo</guimenuitem>.</entry>
</row> </row>
<row> <row>
<entry><inlinemediaobject><imageobject> <entry><inlinemediaobject><imageobject>
<imagedata fileref="list-add.png" format="PNG"/> <imagedata fileref="archive-insert.png" format="PNG"/>
</imageobject></inlinemediaobject></entry> </imageobject></inlinemediaobject></entry>
<entry>New Item</entry> <entry>New Item</entry>
<entry><action>Opens the dialog <link linkend="newitem">New <entry><action>Opens the dialog <link linkend="newitem">New
item</link></action> to choose a new item to be inserted.</entry> item</link></action> to choose a new item to be inserted.</entry>
</row> </row>
<row> <row>
<entry><inlinemediaobject><imageobject> <entry><inlinemediaobject><imageobject>
<imagedata fileref="document-edit.png" format="PNG"/> <imagedata fileref="document-edit.png" format="PNG"/>
</imageobject></inlinemediaobject></entry> </imageobject></inlinemediaobject></entry>
<entry>Edit</entry> <entry>Edit</entry>
<entry><action>Opens a dialog to edit</action> the selected item.</entry> <entry><action>Opens a dialog to edit</action> the selected item.</entry>
</row> </row>
<row> <row>
<entry><inlinemediaobject><imageobject> <entry><inlinemediaobject><imageobject>
<imagedata fileref="configure.png" format="PNG"/> <imagedata fileref="kpl-fit.png" format="PNG"/>
</imageobject></inlinemediaobject></entry> </imageobject></inlinemediaobject></entry>
<entry>Fit</entry> <entry>Fit</entry>
<entry><action>Opens a dialog to perform a parameter or spline <entry><action>Opens a dialog to perform a parameter or spline
fit.</action></entry> fit.</action></entry>
</row> </row>
<row> <row>
<entry><inlinemediaobject><imageobject> <entry><inlinemediaobject><imageobject>
<imagedata fileref="list-remove.png" format="PNG"/> <imagedata fileref="archive-remove.png" format="PNG"/>
</imageobject></inlinemediaobject></entry> </imageobject></inlinemediaobject></entry>
<entry>Delete</entry> <entry>Delete</entry>
<entry><action>Deletes</action> the selected item.</entry> <entry><action>Deletes</action> the selected item.</entry>
</row> </row>
<row> <row>
<entry><inlinemediaobject><imageobject> <entry><inlinemediaobject><imageobject>
<imagedata fileref="go-up.png" format="PNG"/> <imagedata fileref="go-up.png" format="PNG"/>
</imageobject></inlinemediaobject></entry> </imageobject></inlinemediaobject></entry>
<entry>Up</entry> <entry>Up</entry>
skipping to change at line 1747 skipping to change at line 1779
<para> <para>
Here the settings for frame and labels may be performed.</para> Here the settings for frame and labels may be performed.</para>
<para> <para>
In the group <guilabel>Axis mode</guilabel> one can choose between only a frame In the group <guilabel>Axis mode</guilabel> one can choose between only a frame
around the data window or additional tick marks on the left and lower sides of around the data window or additional tick marks on the left and lower sides of
the frame or a grid. Tick marks and grid may be labeled with numeric the frame or a grid. Tick marks and grid may be labeled with numeric
values.</para> values.</para>
<para> <para>
In the group <guilabel>Colors</guilabel> the colors for frame and ticks or In the group <guilabel>Colors</guilabel> the colors for frame and ticks or
grid are selected with the dialog <guilabel>Select Color</guilabel>, displayed grid are selected with the dialog&nbsp; <guilabel>Select Color</guilabel>,
by using the color buttons.</para> displayed by using the color buttons.</para>
<para> <para>
The group <guilabel>Automatic</guilabel> allows convenient scaling of the The group <guilabel>Automatic</guilabel> allows convenient scaling of the
presentation by using the button <guibutton>Autoscale</guibutton>, when arrays presentation by using the button <guibutton>Autoscale</guibutton>, when arrays
or functions are already set in subsequent items of the presentation. When or functions are already set in subsequent items of the presentation.
<guilabel>Normalization</guilabel> is checked, at this time also powers of ten When&nbsp; <guilabel>Normalization</guilabel> is checked, at this time also
are evaluated to be multiplied with the numeric data values in case of huge or powers of ten are evaluated to be multiplied with the numeric data values in
tiny numbers. If not equal to 1, these normalization factors are included in case of huge or tiny numbers. If not equal to 1, these normalization factors
the axis labels.</para> are included in the axis labels.</para>
<para> <para>
In the group <guilabel>Window</guilabel> position and size of the data window In the group <guilabel>Window</guilabel> position and size of the data window
may be set.</para> may be set.</para>
<para> <para>
The group <guilabel>Scaling</guilabel> allows manual scaling of the The group <guilabel>Scaling</guilabel> allows manual scaling of the
presentation by specifying data values for the lower left and the upper right presentation by specifying data values for the lower left and the upper right
corner of the data window. The settings also may be performed by using the corner of the data window. The settings also may be performed by using the
button <guibutton>Autoscale</guibutton>. The scaling can be set to logarithmic button <guibutton>Autoscale</guibutton>. The scaling can be set to logarithmic
individually for the axes by checking <guilabel>log</guilabel>.</para> individually for the axes by checking <guilabel>log</guilabel>.</para>
<para> <para>
skipping to change at line 1785 skipping to change at line 1817
be selected by <guilabel>ndigx</guilabel> and <guilabel>ndigy</guilabel>. Here be selected by <guilabel>ndigx</guilabel> and <guilabel>ndigy</guilabel>. Here
values of -1 are used to suppress the output of the decimal point. The settings values of -1 are used to suppress the output of the decimal point. The settings
also may be performed by using the button also may be performed by using the button
<guibutton>Autoscale</guibutton>.</para> <guibutton>Autoscale</guibutton>.</para>
<para> <para>
For logarithmic scales the controls have a different meaning. For logarithmic scales the controls have a different meaning.
<guilabel>ndigx</guilabel> and <guilabel>ndigy</guilabel> are disabled, the <guilabel>ndigx</guilabel> and <guilabel>ndigy</guilabel> are disabled, the
number of digits is determined automatically. The values of number of digits is determined automatically. The values of
<guilabel>xtic</guilabel> and <guilabel>ytic</guilabel> give the factor between <guilabel>xtic</guilabel> and <guilabel>ytic</guilabel> give the factor between
first and second major tick mark and will be rounded to 2, 5, or 10. Always ten first and second major tick mark and will be rounded to 2, 5, or 10. Always ten
minor tick marks per decade will be drawn when <guilabel>mticx</guilabel> and minor tick marks per decade will be drawn when&nbsp; <guilabel>mticx</guilabel>
<guilabel>mticy</guilabel> are set larger than 1. In contrast to linear scales and <guilabel>mticy</guilabel> are set larger than 1. In contrast to linear
minor ticks will be shown as grid lines in case of grid axis modes. The scales minor ticks will be shown as grid lines in case of grid axis modes. The
normalization option for autoscaling will be deselected in case of logarithmic normalization option for autoscaling will be deselected in case of logarithmic
scales.</para> scales.</para>
<para> <para>
In the group <guilabel>Labels</guilabel> text for the axis labels and a In the group <guilabel>Labels</guilabel> text for the axis labels and a
heading may be entered. Text with special characters is entered more heading may be entered. Text with special characters is entered more
conveniently in the dialog <link linkend="edit-text">Edit text</link> conveniently in the dialog <link linkend="edit-text">Edit text</link>
which shows up when using the buttons right to the entry fields. Powers of ten which shows up when using the buttons right to the entry fields. Powers of ten
for normalization factors to be included in the axis labels may be specified for normalization factors to be included in the axis labels may be specified
manually by <guilabel>iex</guilabel> and <guilabel>iey</guilabel>. The manually by <guilabel>iex</guilabel> and <guilabel>iey</guilabel>. The
placement of the x axis labels can be set by checking placement of the x axis labels can be set by checking
skipping to change at line 1867 skipping to change at line 1899
Factors for <guilabel>x normalization</guilabel> and Factors for <guilabel>x normalization</guilabel> and
<guilabel>y normalization</guilabel> may be entered manually. These factors <guilabel>y normalization</guilabel> may be entered manually. These factors
also may be determined automatically using <guibutton>Autoscale</guibutton> also may be determined automatically using <guibutton>Autoscale</guibutton>
with checked <guilabel>Normalization</guilabel> in the dialog with checked <guilabel>Normalization</guilabel> in the dialog
<link linkend="frame">Frame</link>.</para> <link linkend="frame">Frame</link>.</para>
<para> <para>
Markers (<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) or lines Markers (<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) or lines
(<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0) may be chosen to present the (<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0) may be chosen to present the
data points. This is done most convenient using the dialog data points. This is done most convenient using the dialog
<guilabel>Lines and Markers</guilabel>, to be opened with the button right to <guilabel>Lines and Markers</guilabel>, to be opened with the button right to
the spin box, showing the actual line or marker.</para> the spin box, showing the actual representation.</para>
<para> <para>
The <guilabel>Size</guilabel> of lines or markers may be chosen as an The <guilabel>Size</guilabel> of lines or markers may be chosen as an
additional individual factor to the global setting of the corresponding frame additional individual factor to the global setting of the corresponding frame
item.</para> item.</para>
<para> <para>
The <guilabel>Color</guilabel> of lines or markers may be chosen using the The <guilabel>Color</guilabel> of lines or markers may be chosen using the
dialog <guilabel>Select Color</guilabel>, opened with the colored dialog <guilabel>Select Color</guilabel>, opened with the colored
button.</para> button.</para>
<para> <para>
By choosing a <guilabel>Fill pattern</guilabel> the polygon given by the points By choosing a <guilabel>Fill pattern</guilabel> the polygon given by the points
skipping to change at line 1940 skipping to change at line 1972
Factors for <guilabel>x normalization</guilabel> and Factors for <guilabel>x normalization</guilabel> and
<guilabel>y normalization</guilabel> may be entered manually. These factors <guilabel>y normalization</guilabel> may be entered manually. These factors
also may be determined automatically using <guibutton>Autoscale</guibutton> also may be determined automatically using <guibutton>Autoscale</guibutton>
with checked <guilabel>Normalization</guilabel> in the dialog with checked <guilabel>Normalization</guilabel> in the dialog
<link linkend="frame">Frame</link>.</para> <link linkend="frame">Frame</link>.</para>
<para> <para>
Markers (<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) or lines Markers (<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) or lines
(<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0) may be chosen to present the (<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0) may be chosen to present the
function. This is done most convenient using the dialog function. This is done most convenient using the dialog
<guilabel>Lines and Markers</guilabel>, to be opened with the button right to <guilabel>Lines and Markers</guilabel>, to be opened with the button right to
the spin box, showing the actual line or marker.</para> the spin box, showing the actual representation.</para>
<para> <para>
The <guilabel>Size</guilabel> of lines or markers may be chosen as an The <guilabel>Size</guilabel> of lines or markers may be chosen as an
additional individual factor to the global setting of the corresponding additional individual factor to the global setting of the corresponding
frame item.</para> frame item.</para>
<para> <para>
The <guilabel>Color</guilabel> of lines or markers may be chosen using the The <guilabel>Color</guilabel> of lines or markers may be chosen using the
dialog <guilabel>Select Color</guilabel>, opened with the colored dialog <guilabel>Select Color</guilabel>, opened with the colored
button.</para> button.</para>
<para> <para>
By choosing a <guilabel>Fill pattern</guilabel> the polygon given by the By choosing a <guilabel>Fill pattern</guilabel> the polygon given by the
skipping to change at line 2023 skipping to change at line 2055
Factors for <guilabel>x normalization</guilabel> and Factors for <guilabel>x normalization</guilabel> and
<guilabel>y normalization</guilabel> may be entered manually. These factors <guilabel>y normalization</guilabel> may be entered manually. These factors
also may be determined automatically using <guibutton>Autoscale</guibutton> also may be determined automatically using <guibutton>Autoscale</guibutton>
with checked <guilabel>Normalization</guilabel> in the dialog with checked <guilabel>Normalization</guilabel> in the dialog
<link linkend="frame">Frame</link>.</para> <link linkend="frame">Frame</link>.</para>
<para> <para>
Markers (<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) or lines Markers (<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) or lines
(<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0) may be chosen to present the (<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0) may be chosen to present the
functions. This is done most convenient using the dialog functions. This is done most convenient using the dialog
<guilabel>Lines and Markers</guilabel>, to be opened with the button right to <guilabel>Lines and Markers</guilabel>, to be opened with the button right to
the spin box, showing the actual line or marker.</para> the spin box, showing the actual representation.</para>
<para> <para>
The <guilabel>Size</guilabel> of lines or markers may be chosen as an The <guilabel>Size</guilabel> of lines or markers may be chosen as an
additional individual factor to the global setting of the corresponding frame additional individual factor to the global setting of the corresponding frame
item.</para> item.</para>
<para> <para>
The <guilabel>Color</guilabel> of lines or markers may be chosen using the The <guilabel>Color</guilabel> of lines or markers may be chosen using the
dialog <guilabel>Select Color</guilabel>, opened with the colored dialog <guilabel>Select Color</guilabel>, opened with the colored
button.</para> button.</para>
<para> <para>
By choosing a <guilabel>Fill pattern</guilabel> the polygon given by the points By choosing a <guilabel>Fill pattern</guilabel> the polygon given by the points
skipping to change at line 2088 skipping to change at line 2120
Factors for <guilabel>x normalization</guilabel> and Factors for <guilabel>x normalization</guilabel> and
<guilabel>y normalization</guilabel> may be entered manually. These factors <guilabel>y normalization</guilabel> may be entered manually. These factors
also may be determined automatically using <guibutton>Autoscale</guibutton> also may be determined automatically using <guibutton>Autoscale</guibutton>
with checked <guilabel>Normalization</guilabel> in the dialog with checked <guilabel>Normalization</guilabel> in the dialog
<link linkend="frame">Frame</link>.</para> <link linkend="frame">Frame</link>.</para>
<para> <para>
Markers (<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) or lines Markers (<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) or lines
(<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0) may be chosen to present the (<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0) may be chosen to present the
function. This is done most convenient using the dialog function. This is done most convenient using the dialog
<guilabel>Lines and Markers</guilabel>, to be opened with the button right to <guilabel>Lines and Markers</guilabel>, to be opened with the button right to
the spin box, showing the actual line or marker.</para> the spin box, showing the actual representation.</para>
<para> <para>
The <guilabel>Size</guilabel> of lines or markers may be chosen as an The <guilabel>Size</guilabel> of lines or markers may be chosen as an
additional individual factor to the global setting of the corresponding frame additional individual factor to the global setting of the corresponding frame
item.</para> item.</para>
<para> <para>
The <guilabel>Color</guilabel> of lines or markers may be chosen using the The <guilabel>Color</guilabel> of lines or markers may be chosen using the
dialog <guilabel>Select Color</guilabel>, opened with the colored dialog <guilabel>Select Color</guilabel>, opened with the colored
button.</para> button.</para>
<para> <para>
By choosing a <guilabel>Fill pattern</guilabel> the polygon given by the points By choosing a <guilabel>Fill pattern</guilabel> the polygon given by the points
skipping to change at line 2169 skipping to change at line 2201
<guilabel>Error column</guilabel> is not checked, the value of the smoothing <guilabel>Error column</guilabel> is not checked, the value of the smoothing
factor is taken as the constant standard deviation of the y values.</para> factor is taken as the constant standard deviation of the y values.</para>
<para> <para>
The <guilabel>Start index</guilabel> is the row index for the first data point The <guilabel>Start index</guilabel> is the row index for the first data point
to be taken to calculate the surface y(x,z). 0 corresponds to the first row of to be taken to calculate the surface y(x,z). 0 corresponds to the first row of
the data file, not counting comment lines. Together with the the data file, not counting comment lines. Together with the
<guilabel>Number of points</guilabel> the portion of the file used for <guilabel>Number of points</guilabel> the portion of the file used for
calculating the spline is selected. With <guilabel>xmin</guilabel>, calculating the spline is selected. With <guilabel>xmin</guilabel>,
<guilabel>xmax</guilabel>, <guilabel>zmin</guilabel>, and <guilabel>xmax</guilabel>, <guilabel>zmin</guilabel>, and
<guilabel>zmax</guilabel> the limits for the displayed region of the surface <guilabel>zmax</guilabel> the limits for the displayed region of the surface
y(x,z) and for the x and z axis are set. The step sizes y(x,z) and for the x and z axis are set. The step sizes&nbsp;
<guilabel>&Delta;x</guilabel> and <guilabel>&Delta;z</guilabel> determine the <guilabel>&Delta;x</guilabel> and <guilabel>&Delta;z</guilabel> determine the
intervals of the grid which represents the surface. Values of 0 result in intervals of the grid which represents the surface. Values of 0 result in
automatically dividing the respective range into 40 intervals. With automatically dividing the respective range into 40 intervals. With
<guilabel>ymin</guilabel> and <guilabel>ymax</guilabel> the limits of the y <guilabel>ymin</guilabel> and <guilabel>ymax</guilabel> the limits of the y
axis are set. The scaling can be set to logarithmic individually for the axes axis are set. The scaling can be set to logarithmic individually for the axes
by checking <guilabel>log</guilabel>.</para> by checking <guilabel>log</guilabel>.</para>
</sect2> </sect2>
<sect2 id="array3d-p2"> <sect2 id="array3d-p2">
skipping to change at line 2203 skipping to change at line 2235
the three-dimensional plot can be set in cm.</para> the three-dimensional plot can be set in cm.</para>
<para> <para>
The <guilabel>Rotation</guilabel> of the coordinate frame can be set by the The <guilabel>Rotation</guilabel> of the coordinate frame can be set by the
angles <guilabel>phi</guilabel> and <guilabel>theta</guilabel>. The value of angles <guilabel>phi</guilabel> and <guilabel>theta</guilabel>. The value of
<guilabel>phi</guilabel> determines the rotation around the y axis, the value <guilabel>phi</guilabel> determines the rotation around the y axis, the value
of <guilabel>theta</guilabel> determines the tilt of the y axis.</para> of <guilabel>theta</guilabel> determines the tilt of the y axis.</para>
<para> <para>
The group <guilabel>Axes</guilabel> allows to specify the distances The group <guilabel>Axes</guilabel> allows to specify the distances
<guilabel>xtic</guilabel>, <guilabel>ytic</guilabel>, and <guilabel>xtic</guilabel>, <guilabel>ytic</guilabel>, and
<guilabel>ztic</guilabel> of major (labeled) tick marks. The number of <guilabel>ztic</guilabel> of major (labeled) tick marks. The number of
intervals dividing the distance between the major ticks can be specified by intervals dividing the distance between the major ticks can be specified
<guilabel>mticx</guilabel>, <guilabel>mticy</guilabel>, and by&nbsp; <guilabel>mticx</guilabel>, <guilabel>mticy</guilabel>, and
<guilabel>mticz</guilabel>. For axes with numeric labels the number of digits <guilabel>mticz</guilabel>. For axes with numeric labels the number of digits
behind the decimal point may be selected by <guilabel>ndigx</guilabel> and behind the decimal point may be selected by&nbsp; <guilabel>ndigx</guilabel>
<guilabel>ndigy</guilabel>. Here values of -1 are used to suppress the output and <guilabel>ndigy</guilabel>. Here values of -1 are used to suppress the
of the decimal point.</para> output of the decimal point.</para>
<para> <para>
Factors for <guilabel>Normalization</guilabel> of the x, y, and z axis may be Factors for <guilabel>Normalization</guilabel> of the x, y, and z axis may be
entered manually. These factors also may be determined automatically using entered manually. These factors also may be determined automatically using
<guibutton>Autoscale</guibutton> with checked <guibutton>Autoscale</guibutton> with checked
<guilabel>Normalization</guilabel>. Autoscaling also sets the limits of the <guilabel>Normalization</guilabel>. Autoscaling also sets the limits of the
axes, the distances between major tick marks, the number of intervals between axes, the distances between major tick marks, the number of intervals between
major tick marks, the number of digits for numeric labels, the major tick marks, the number of digits for numeric labels, the
<guilabel>Reference Point</guilabel>, and the lengths of the axes.</para> <guilabel>Reference Point</guilabel>, and the lengths of the axes.</para>
</sect2> </sect2>
skipping to change at line 2243 skipping to change at line 2275
the surface representing the data may be chosen using the dialog the surface representing the data may be chosen using the dialog
<guilabel>Select Color</guilabel>, opened with the colored buttons.</para> <guilabel>Select Color</guilabel>, opened with the colored buttons.</para>
<para> <para>
By <guilabel>Show frame</guilabel> the display of a frame around the By <guilabel>Show frame</guilabel> the display of a frame around the
rectangular window of the plot can be selected. The relative rectangular window of the plot can be selected. The relative
<guilabel>Line width</guilabel> of the surface grid (proportional to the width <guilabel>Line width</guilabel> of the surface grid (proportional to the width
of the data window) may be specified. A setting of 100&nbsp;% corresponds to of the data window) may be specified. A setting of 100&nbsp;% corresponds to
the default.</para> the default.</para>
<para> <para>
A table with values of the plotted surfaces can be exported as a data file A table with values of the plotted surfaces can be exported as a data file
using the button <guibutton>Export</guibutton>. A file selection dialog will be using the button&nbsp; <guibutton>Export</guibutton>. A file selection dialog
opened for this purpose.</para> will be opened for this purpose.</para>
<para> <para>
The dialog may be canceled without saving by use of the button The dialog may be canceled without saving by use of the button
<guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> <guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton>
changes are saved without closing the dialog. With <guibutton>OK</guibutton> changes are saved without closing the dialog. With <guibutton>OK</guibutton>
changes are saved and the dialog is closed.</para> changes are saved and the dialog is closed.</para>
</sect2> </sect2>
</sect1> </sect1>
skipping to change at line 2288 skipping to change at line 2320
<para> <para>
With the button <guibutton>Edit</guibutton> a dialog With the button <guibutton>Edit</guibutton> a dialog
<guilabel>Parameter</guilabel> may be opened, which allows to enter the values <guilabel>Parameter</guilabel> may be opened, which allows to enter the values
of up to 20 parameters of the function. When the option of up to 20 parameters of the function. When the option
<guilabel>Show Function Source</guilabel> is activated in the <guilabel>Show Function Source</guilabel> is activated in the
<link linkend="settings-menu">Settings</link> menu and a C or C++ language <link linkend="settings-menu">Settings</link> menu and a C or C++ language
source file with the same name as the shared library with the extension source file with the same name as the shared library with the extension
<literal role="extension">.c</literal> or <literal role="extension">.c</literal> or
<literal role="extension">.cpp</literal>, respectively, is present in the same <literal role="extension">.cpp</literal>, respectively, is present in the same
directory, its contents is displayed right to the parameter fields, too. The directory, its contents is displayed right to the parameter fields, too. The
button <guibutton>Load</guibutton> opens a file selection dialog for loading button&nbsp; <guibutton>Load</guibutton> opens a file selection dialog for
the parameters from an text file (one parameter each line). The button loading the parameters from an text file (one parameter each line). The
<guibutton>Save</guibutton> opens a file selection dialog for saving the button&nbsp; <guibutton>Save</guibutton> opens a file selection dialog for
parameters in an text file.</para> saving the parameters in an text file.</para>
<para> <para>
In the group <guilabel>y(x,z)</guilabel> the limits for the function's In the group <guilabel>y(x,z)</guilabel> the limits for the function's
arguments and the x and z axes are entered using the fields arguments and the x and z axes are entered using the fields
<guilabel>xmin</guilabel>, <guilabel>xmax</guilabel>, <guilabel>xmin</guilabel>, <guilabel>xmax</guilabel>,
<guilabel>zmin</guilabel>, and <guilabel>zmax</guilabel>. With <guilabel>zmin</guilabel>, and <guilabel>zmax</guilabel>. With
<guilabel>&Delta;x</guilabel> and <guilabel>&Delta;z</guilabel> the step sizes <guilabel>&Delta;x</guilabel> and <guilabel>&Delta;z</guilabel> the step sizes
for the arguments are set. A value of 0 results in automatically dividing the for the arguments are set. A value of 0 results in automatically dividing the
respective range into 40 intervals. With <guilabel>ymin</guilabel> and respective range into 40 intervals. With <guilabel>ymin</guilabel> and
<guilabel>ymax</guilabel> the limits of the y axis are set. The scaling can be <guilabel>ymax</guilabel> the limits of the y axis are set. The scaling can be
set to logarithmic individually for the axes by checking set to logarithmic individually for the axes by checking
skipping to change at line 2330 skipping to change at line 2362
the three-dimensional plot can be set in cm.</para> the three-dimensional plot can be set in cm.</para>
<para> <para>
The <guilabel>Rotation</guilabel> of the coordinate frame can be set by the The <guilabel>Rotation</guilabel> of the coordinate frame can be set by the
angles <guilabel>phi</guilabel> and <guilabel>theta</guilabel>. The value of angles <guilabel>phi</guilabel> and <guilabel>theta</guilabel>. The value of
<guilabel>phi</guilabel> determines the rotation around the y axis, the value <guilabel>phi</guilabel> determines the rotation around the y axis, the value
of <guilabel>theta</guilabel> determines the tilt of the y axis.</para> of <guilabel>theta</guilabel> determines the tilt of the y axis.</para>
<para> <para>
The group <guilabel>Axes</guilabel> allows to specify the distances The group <guilabel>Axes</guilabel> allows to specify the distances
<guilabel>xtic</guilabel>, <guilabel>ytic</guilabel>, and <guilabel>xtic</guilabel>, <guilabel>ytic</guilabel>, and
<guilabel>ztic</guilabel> of major (labeled) tick marks. The number of <guilabel>ztic</guilabel> of major (labeled) tick marks. The number of
intervals dividing the distance between the major ticks can be specified by intervals dividing the distance between the major ticks can be specified
<guilabel>mticx</guilabel>, <guilabel>mticy</guilabel>, and by&nbsp; <guilabel>mticx</guilabel>, <guilabel>mticy</guilabel>, and
<guilabel>mticz</guilabel>. For axes with numeric labels the number of digits <guilabel>mticz</guilabel>. For axes with numeric labels the number of digits
behind the decimal point may be selected by <guilabel>ndigx</guilabel> and behind the decimal point may be selected by&nbsp; <guilabel>ndigx</guilabel>
<guilabel>ndigy</guilabel>. Here values of -1 are used to suppress the output and <guilabel>ndigy</guilabel>. Here values of -1 are used to suppress the
of the decimal point.</para> output of the decimal point.</para>
<para> <para>
Factors for <guilabel>Normalization</guilabel> of the x, y, and z axis may be Factors for <guilabel>Normalization</guilabel> of the x, y, and z axis may be
entered manually. These factors also may be determined automatically using entered manually. These factors also may be determined automatically using
<guibutton>Autoscale</guibutton> with checked <guibutton>Autoscale</guibutton> with checked
<guilabel>Normalization</guilabel>. Autoscaling also sets the limits of the <guilabel>Normalization</guilabel>. Autoscaling also sets the limits of the
axes, the distances between major tick marks, the number of intervals between axes, the distances between major tick marks, the number of intervals between
major tick marks, the number of digits for numeric labels, the major tick marks, the number of digits for numeric labels, the
<guilabel>Reference Point</guilabel>, and the lengths of the axes.</para> <guilabel>Reference Point</guilabel>, and the lengths of the axes.</para>
</sect2> </sect2>
skipping to change at line 2370 skipping to change at line 2402
the surface representing the data may be chosen using the dialog the surface representing the data may be chosen using the dialog
<guilabel>Select Color</guilabel>, opened with the colored buttons.</para> <guilabel>Select Color</guilabel>, opened with the colored buttons.</para>
<para> <para>
By <guilabel>Show frame</guilabel> the display of a frame around the By <guilabel>Show frame</guilabel> the display of a frame around the
rectangular window of the plot can be selected. The relative rectangular window of the plot can be selected. The relative
<guilabel>Line width</guilabel> of the surface grid (proportional to the width <guilabel>Line width</guilabel> of the surface grid (proportional to the width
of the data window) may be specified. A setting of 100&nbsp;% corresponds to of the data window) may be specified. A setting of 100&nbsp;% corresponds to
the default.</para> the default.</para>
<para> <para>
A table with values of the plotted surfaces can be exported as a data file A table with values of the plotted surfaces can be exported as a data file
using the button <guibutton>Export</guibutton>. A file selection dialog will be using the button&nbsp; <guibutton>Export</guibutton>. A file selection dialog
opened for this purpose.</para> will be opened for this purpose.</para>
<para> <para>
The dialog may be canceled without saving by use of the button The dialog may be canceled without saving by use of the button
<guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes <guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes
are saved without closing the dialog. With <guibutton>OK</guibutton> changes are saved without closing the dialog. With <guibutton>OK</guibutton> changes
are saved and the dialog is closed.</para> are saved and the dialog is closed.</para>
</sect2> </sect2>
</sect1> </sect1>
<sect1 id="image"> <sect1 id="image">
<title>Image</title> <title>Image</title>
<anchor id="sec-image"/> <anchor id="sec-image"/>
<para> <para>
The dialog <guilabel>Image</guilabel> allows to embed an EPS (Encapsulated The dialog <guilabel>Image</guilabel> allows to embed an EPS (Encapsulated
PostScript) figure in a plot.</para> PostScript) figure in a plot.</para>
<para> <para>
A file selection dialog is opened with the button <guilabel>...</guilabel> to A file selection dialog is opened with the button <guilabel>...</guilabel> to
select the EPS <guilabel>File</guilabel>. With <guilabel>x0</guilabel> and select the EPS <guilabel>File</guilabel>. The <guilabel>Rotation</guilabel> of
the figure around the left bottom corner can be entered in degrees.
With <guilabel>x0</guilabel> and
<guilabel>y0</guilabel> the position of the left bottom corner may be <guilabel>y0</guilabel> the position of the left bottom corner may be
set.</para> set.</para>
<para> <para>
<guilabel>x Scaling</guilabel> and <guilabel>y Scaling</guilabel> allow <guilabel>x Scaling</guilabel> and <guilabel>y Scaling</guilabel> allow
to set horizontal and vertical scaling factors. Values of 100&nbsp;% correspond to set horizontal and vertical scaling factors. Values of 100&nbsp;% correspond
to the original size of the figure. The same scaling factor for x and y to the original size of the figure. The same scaling factor for x and y
direction is used when <guilabel>Maintain aspect ratio</guilabel> direction is used when <guilabel>Maintain aspect ratio</guilabel>
is checked.</para> is checked.</para>
<para> <para>
The dialog may be canceled without saving by use of the button The dialog may be canceled without saving by use of the button
skipping to change at line 2420 skipping to change at line 2454
<anchor id="sec-legend"/> <anchor id="sec-legend"/>
<para> <para>
The dialog <guilabel>Legend</guilabel> is used to perform the settings for the The dialog <guilabel>Legend</guilabel> is used to perform the settings for the
explanation of line types and symbols as well as for additional explanation of line types and symbols as well as for additional
labels.</para> labels.</para>
<para> <para>
In the group <guilabel>Data</guilabel> a <guilabel>Symbol</guilabel> to be In the group <guilabel>Data</guilabel> a <guilabel>Symbol</guilabel> to be
explained is selected. This is done most convenient using the dialog explained is selected. This is done most convenient using the dialog
<guilabel>Lines and Markers</guilabel>, opened using the button right to the <guilabel>Lines and Markers</guilabel>, opened using the button right to the
spin box, showing the actual line or marker. The symbol number -17 may be spin box, showing the actual representation. The symbol number -17 may be
chosen to draw labels without markers or lines. The <guilabel>Size</guilabel> chosen to draw labels without markers or lines. The <guilabel>Size</guilabel>
of lines or markers may be chosen as an additional individual factor to the of lines or markers may be chosen as an additional individual factor to the
global setting of the corresponding frame item. The <guilabel>Color</guilabel> global setting of the corresponding frame item. The <guilabel>Color</guilabel>
of lines and markers is selected in the dialog of lines and markers is selected in the dialog
<guilabel>Select Color</guilabel>, opened with the colored button. With <guilabel>Select Color</guilabel>, opened with the colored button. With
<guilabel>x</guilabel> and <guilabel>y</guilabel> the position with respect to <guilabel>x</guilabel> and <guilabel>y</guilabel> the position with respect to
the lower left corner of the window may be set.</para> the lower left corner of the window may be set.</para>
<para> <para>
In the group <guilabel>Label</guilabel> the <guilabel>Text</guilabel> may be In the group <guilabel>Label</guilabel> the <guilabel>Text</guilabel> may be
entered. Text with special characters is entered most conveniently using the entered. Text with special characters is entered most conveniently using the
skipping to change at line 2459 skipping to change at line 2493
<para> <para>
The dialog <guilabel>Text</guilabel> is used to perform the settings for a text The dialog <guilabel>Text</guilabel> is used to perform the settings for a text
to decorate the plot.</para> to decorate the plot.</para>
<para> <para>
The <guilabel>Text</guilabel> may be entered in the corresponding entry field. The <guilabel>Text</guilabel> may be entered in the corresponding entry field.
Text with special characters is entered most conveniently using the dialog Text with special characters is entered most conveniently using the dialog
<link linkend="edit-text">Edit text</link>, opened using the button right to <link linkend="edit-text">Edit text</link>, opened using the button right to
the entry field. The <guilabel>Direction</guilabel> of the text can be entered the entry field. The <guilabel>Direction</guilabel> of the text can be entered
in degrees. The <guilabel>Alignment</guilabel> of the text with respect to the in degrees. The <guilabel>Alignment</guilabel> of the text with respect to the
position may be chosen to be left, centered, or right. With position may be chosen to be left, centered, or right. With&nbsp;
<guilabel>x0</guilabel> and <guilabel>y0</guilabel> the position of the text <guilabel>x0</guilabel> and <guilabel>y0</guilabel> the position of the text
may be set in cm.</para> may be set in cm.</para>
<para> <para>
With <guilabel>Size</guilabel> the relative size of the characters may be set. With <guilabel>Size</guilabel> the relative size of the characters may be set.
A setting of 100&nbsp;% corresponds to a normal value. The A setting of 100&nbsp;% corresponds to a normal value. The&nbsp;
<guilabel>Color</guilabel> of the line is selected in the dialog <guilabel>Color</guilabel> of the line is selected in the dialog
<guilabel>Select Color</guilabel>, opened with the colored button.</para> <guilabel>Select Color</guilabel>, opened with the colored button.</para>
<para> <para>
The dialog may be canceled without saving by use of the button The dialog may be canceled without saving by use of the button
<guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes <guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes
are saved without closing the dialog. With <guibutton>OK</guibutton> changes are saved without closing the dialog. With <guibutton>OK</guibutton> changes
are saved and the dialog is closed.</para> are saved and the dialog is closed.</para>
</sect1> </sect1>
skipping to change at line 2489 skipping to change at line 2523
<para> <para>
The dialog <guilabel>Line</guilabel> is used to perform the settings for a line The dialog <guilabel>Line</guilabel> is used to perform the settings for a line
to decorate the plot.</para> to decorate the plot.</para>
<para> <para>
The <guilabel>Direction</guilabel> of the line can be entered in degrees. With The <guilabel>Direction</guilabel> of the line can be entered in degrees. With
<guilabel>Length</guilabel> the length is set in cm. With <guilabel>Length</guilabel> the length is set in cm. With
<guilabel>x0</guilabel> and <guilabel>y0</guilabel> the start position of the <guilabel>x0</guilabel> and <guilabel>y0</guilabel> the start position of the
line may be set.</para> line may be set.</para>
<para> <para>
With <guilabel>Width</guilabel> the relative width of the line maybe set. A With <guilabel>Width</guilabel> the relative width of the line maybe set. A
setting of 100&nbsp;% corresponds to a normal value. The setting of 100&nbsp;% corresponds to a normal value. The&nbsp;
<guilabel>Color</guilabel> of the line is selected in the dialog <guilabel>Color</guilabel> of the line is selected in the dialog
<guilabel>Select Color</guilabel>, opened with the colored button.</para> <guilabel>Select Color</guilabel>, opened with the colored button.</para>
<para> <para>
The <guilabel>Type</guilabel> of the line is selected most convenient using the The <guilabel>Type</guilabel> of the line is selected most convenient using the
dialog <guilabel>Lines</guilabel>, opened using the button right to the spin dialog&nbsp; <guilabel>Lines</guilabel>, opened using the button right to the
box, showing the actual line.</para> spin box, showing the actual representation.</para>
<para> <para>
The dialog may be canceled without saving by use of the button The dialog may be canceled without saving by use of the button
<guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes <guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes
are saved without closing the dialog. With <guibutton>OK</guibutton> changes are saved without closing the dialog. With <guibutton>OK</guibutton> changes
are saved and the dialog is closed.</para> are saved and the dialog is closed.</para>
</sect1> </sect1>
<sect1 id="arrow"> <sect1 id="arrow">
<title>Arrow</title> <title>Arrow</title>
<anchor id="sec-arrow"/> <anchor id="sec-arrow"/>
<para> <para>
The dialog <guilabel>Arrow</guilabel> is used to perform the settings for an The dialog <guilabel>Arrow</guilabel> is used to perform the settings for an
arrow to decorate the plot.</para> arrow to decorate the plot.</para>
<para> <para>
The <guilabel>Direction</guilabel> of the arrow can be entered in degrees. With The <guilabel>Direction</guilabel> of the arrow can be entered in degrees.
<guilabel>Length</guilabel> the total length is set in cm. With With&nbsp; <guilabel>Length</guilabel> the total length is set in cm. With
<guilabel>x0</guilabel> and <guilabel>y0</guilabel> the <guilabel>x0</guilabel> and <guilabel>y0</guilabel> the
<guilabel>Coordinates</guilabel> of either the <guilabel>Head</guilabel>, the <guilabel>Coordinates</guilabel> of either the <guilabel>Head</guilabel>, the
<guilabel>Center</guilabel>, or the <guilabel>End</guilabel>, may be <guilabel>Center</guilabel>, or the <guilabel>End</guilabel>, may be
set.</para> set.</para>
<para> <para>
With <guilabel>Size</guilabel> the relative size of the arrow head With <guilabel>Size</guilabel> the relative size of the arrow head
may be set. A setting of 100&nbsp;% corresponds to a normal value. The may be set. A setting of 100&nbsp;% corresponds to a normal value. The
<guilabel>Color</guilabel> of the arrow is selected in the dialog <guilabel>Color</guilabel> of the arrow is selected in the dialog
<guilabel>Select Color</guilabel>, opened with the colored button.</para> <guilabel>Select Color</guilabel>, opened with the colored button.</para>
<para> <para>
The <guilabel>Type</guilabel> of the line is selected most convenient using the
dialog&nbsp; <guilabel>Lines</guilabel>, opened using the button right to the
spin box, showing the actual representation.</para>
<para>
The arrow can be set to be <guilabel>Double headed</guilabel>.</para> The arrow can be set to be <guilabel>Double headed</guilabel>.</para>
<para> <para>
The dialog may be canceled without saving by use of the button The dialog may be canceled without saving by use of the button
<guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes <guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes
are saved without closing the dialog. With <guibutton>OK</guibutton> changes are saved without closing the dialog. With <guibutton>OK</guibutton> changes
are saved and the dialog is closed.</para> are saved and the dialog is closed.</para>
</sect1> </sect1>
<sect1 id="arc"> <sect1 id="arc">
<title>Arc</title> <title>Arc</title>
<anchor id="sec-arc"/> <anchor id="sec-arc"/>
<para> <para>
The dialog <guilabel>Arc</guilabel> is used to perform the settings for an The dialog <guilabel>Arc</guilabel> is used to perform the settings for an
elliptic arc to decorate the plot.</para> elliptic arc to decorate the plot.</para>
<para> <para>
The <guilabel>Width</guilabel> and <guilabel>Height</guilabel> of the ellipse The <guilabel>Width</guilabel> and <guilabel>Height</guilabel> of the ellipse
can be entered in cm. The height is set equal to the width when can be entered in cm. The height is set equal to the width when&nbsp;
<guilabel>Circular arc</guilabel> is checked. With <guilabel>Start</guilabel> <guilabel>Circular arc</guilabel> is checked. With <guilabel>Start</guilabel>
and <guilabel>Length</guilabel> the arc's start angle and length can be set in and <guilabel>Length</guilabel> the arc's start angle and length can be set in
degrees. The <guilabel>Rotation</guilabel> of the ellipse around the left degrees. The <guilabel>Rotation</guilabel> of the ellipse around the left
bottom corner can be entered in degrees. With <guilabel>x0</guilabel> and bottom corner can be entered in degrees.
<guilabel>y0</guilabel> the position of the center may be set.</para> With&nbsp; <guilabel>x0</guilabel> and <guilabel>y0</guilabel> the position of
the center may be set.</para>
<para> <para>
With <guilabel>Line width</guilabel> the relative width of the line to draw the With <guilabel>Line width</guilabel> the relative width of the line to draw the
arc may be set. A setting of 100&nbsp;% corresponds to a normal value. The arc may be set. A setting of 100&nbsp;% corresponds to a normal value. The
<guilabel>Color</guilabel> of the arc is selected in the dialog <guilabel>Color</guilabel> of the arc is selected in the dialog
<guilabel>Select Color</guilabel>, opened with the colored button.</para> <guilabel>Select Color</guilabel>, opened with the colored button.</para>
<para> <para>
The <guilabel>Type</guilabel> of the line is selected most convenient using the
dialog&nbsp; <guilabel>Lines</guilabel>, opened using the button right to the
spin box, showing the actual representation.</para>
<para>
The dialog may be canceled without saving by use of the button The dialog may be canceled without saving by use of the button
<guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes <guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes
are saved without closing the dialog. With <guibutton>OK</guibutton> changes are saved without closing the dialog. With <guibutton>OK</guibutton> changes
are saved and the dialog is closed.</para> are saved and the dialog is closed.</para>
</sect1> </sect1>
<sect1 id="rect"> <sect1 id="rect">
<title>Rectangle</title> <title>Rectangle</title>
<anchor id="sec-rect"/> <anchor id="sec-rect"/>
<para> <para>
The dialog <guilabel>Rectangle</guilabel> is used to perform the settings for a The dialog <guilabel>Rectangle</guilabel> is used to perform the settings for a
rectangle to decorate the plot.</para> rectangle to decorate the plot.</para>
<para> <para>
The <guilabel>Width</guilabel> and <guilabel>Height</guilabel> of the rectangle The <guilabel>Width</guilabel> and <guilabel>Height</guilabel> of the rectangle
can be entered in cm. The height is set equal to the width when can be entered in cm. The height is set equal to the width when&nbsp;
<guilabel>Square</guilabel> is checked. The <guilabel>Rotation</guilabel> of <guilabel>Square</guilabel> is checked. The <guilabel>Rotation</guilabel> of
the rectangle around the left bottom corner can be entered in degrees. With the rectangle around the left bottom corner can be entered in degrees.
<guilabel>x0</guilabel> and <guilabel>y0</guilabel> the position of the left With&nbsp; <guilabel>x0</guilabel> and <guilabel>y0</guilabel> the position of
bottom corner may be set.</para> the left bottom corner may be set.</para>
<para> <para>
With <guilabel>Line width</guilabel> the relative width of the line to draw the With <guilabel>Line width</guilabel> the relative width of the line to draw the
rectangle may be set. A setting of 100&nbsp;% corresponds to a normal value. rectangle may be set. A setting of 100&nbsp;% corresponds to a normal value.
The <guilabel>Color</guilabel> of the rectangle is selected in the dialog The <guilabel>Color</guilabel> of the rectangle is selected in the dialog
<guilabel>Select Color</guilabel>, opened with the colored button.</para> <guilabel>Select Color</guilabel>, opened with the colored button.</para>
<para> <para>
The <guilabel>Type</guilabel> of the line is selected most convenient using the
dialog&nbsp; <guilabel>Lines</guilabel>, opened using the button right to the
spin box, showing the actual representation.</para>
<para>
By choosing a <guilabel>Fill pattern</guilabel> the rectangle can be filled By choosing a <guilabel>Fill pattern</guilabel> the rectangle can be filled
with a solid color or a pattern instead of being represented by a line.</para> with a solid color or a pattern instead of being represented by a line.</para>
<para> <para>
The dialog may be canceled without saving by use of the button The dialog may be canceled without saving by use of the button
<guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes <guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes
are saved without closing the dialog. With <guibutton>OK</guibutton> changes are saved without closing the dialog. With <guibutton>OK</guibutton> changes
are saved and the dialog is closed.</para> are saved and the dialog is closed.</para>
</sect1> </sect1>
<sect1 id="ellipse"> <sect1 id="ellipse">
<title>Ellipse</title> <title>Ellipse</title>
<anchor id="sec-ellipse"/> <anchor id="sec-ellipse"/>
<para> <para>
The dialog <guilabel>Ellipse</guilabel> is used to perform the settings for an The dialog <guilabel>Ellipse</guilabel> is used to perform the settings for an
ellipse to decorate the plot.</para> ellipse to decorate the plot.</para>
<para> <para>
The <guilabel>Width</guilabel> and <guilabel>Height</guilabel> of the ellipse The <guilabel>Width</guilabel> and <guilabel>Height</guilabel> of the ellipse
can be entered in cm. The height is set equal to the width when can be entered in cm. The height is set equal to the width when&nbsp;
<guilabel>Circle</guilabel> is checked. The <guilabel>Rotation</guilabel> of <guilabel>Circle</guilabel> is checked. The <guilabel>Rotation</guilabel> of
the ellipse can be entered in degrees. With <guilabel>x0</guilabel> and the ellipse can be entered in degrees. With&nbsp; <guilabel>x0</guilabel> and
<guilabel>y0</guilabel> the position of the center may be set.</para> <guilabel>y0</guilabel> the position of the center may be set.</para>
<para> <para>
With <guilabel>Line width</guilabel> the relative width of the line to draw the With <guilabel>Line width</guilabel> the relative width of the line to draw the
ellipse may be set. A setting of 100&nbsp;% corresponds to a normal value. The ellipse may be set. A setting of 100&nbsp;% corresponds to a normal value. The
<guilabel>Color</guilabel> of the ellipse is selected in the dialog <guilabel>Color</guilabel> of the ellipse is selected in the dialog
<guilabel>Select Color</guilabel>, opened with the colored button.</para> <guilabel>Select Color</guilabel>, opened with the colored button.</para>
<para> <para>
The <guilabel>Type</guilabel> of the line is selected most convenient using the
dialog&nbsp; <guilabel>Lines</guilabel>, opened using the button right to the
spin box, showing the actual representation.</para>
<para>
By choosing a <guilabel>Fill pattern</guilabel> the ellipse can be filled with By choosing a <guilabel>Fill pattern</guilabel> the ellipse can be filled with
a solid color or a pattern instead of being represented by a line.</para> a solid color or a pattern instead of being represented by a line.</para>
<para> <para>
The dialog may be canceled without saving by use of the button The dialog may be canceled without saving by use of the button
<guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes <guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes
are saved without closing the dialog. With <guibutton>OK</guibutton> changes are saved without closing the dialog. With <guibutton>OK</guibutton> changes
are saved and the dialog is closed.</para> are saved and the dialog is closed.</para>
</sect1> </sect1>
<sect1 id="scalebar"> <sect1 id="scalebar">
<title>Scale Bar</title> <title>Scale Bar</title>
<anchor id="sec-scalebar"/> <anchor id="sec-scalebar"/>
<para> <para>
The dialog <guilabel>Scale Bar</guilabel> is used to perform the settings for a The dialog <guilabel>Scale Bar</guilabel> is used to perform the settings for a
bar showing a length scale. The <guilabel>Orientation</guilabel> of the bar may bar showing a length scale. The <guilabel>Orientation</guilabel> of the bar may
be chosen to be <guilabel>Horizontal</guilabel> or be chosen to be <guilabel>Horizontal</guilabel> or
<guilabel>Vertical</guilabel>. A <guilabel>Text</guilabel> (usually a length <guilabel>Vertical</guilabel>. A <guilabel>Text</guilabel> (usually a length
the bar should represent) can be entered. The actual the bar should represent) can be entered. The
<guilabel>Length</guilabel> of the bar in the plot has to be supplied in cm. actual&nbsp; <guilabel>Length</guilabel> of the bar in the plot has to be
With <guilabel>x0</guilabel> and <guilabel>y0</guilabel> the position of the supplied in cm. With <guilabel>x0</guilabel> and <guilabel>y0</guilabel> the
left bottom corner may be set.</para> position of the left bottom corner may be set.</para>
<para> <para>
With <guilabel>Size</guilabel> the relative size of the text and the relative With <guilabel>Size</guilabel> the relative size of the text and the relative
linewidth may be set. A setting of 100&nbsp;% corresponds to a normal value. linewidth may be set. A setting of 100&nbsp;% corresponds to a normal value.
The <guilabel>Color</guilabel> of the scale bar is selected in the dialog The <guilabel>Color</guilabel> of the scale bar is selected in the dialog
<guilabel>Select Color</guilabel>, opened with the colored button.</para> <guilabel>Select Color</guilabel>, opened with the colored button.</para>
<para> <para>
The dialog may be canceled without saving by use of the button The dialog may be canceled without saving by use of the button
<guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes <guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> changes
are saved without closing the dialog. With <guibutton>OK</guibutton> changes are saved without closing the dialog. With <guibutton>OK</guibutton> changes
are saved and the dialog is closed.</para> are saved and the dialog is closed.</para>
skipping to change at line 2693 skipping to change at line 2744
In the group <guilabel>Data errors</guilabel> the settings for weighing the In the group <guilabel>Data errors</guilabel> the settings for weighing the
data points may be formed. The selected <guilabel>Array</guilabel> for which data points may be formed. The selected <guilabel>Array</guilabel> for which
the settings are performed is shown by its filename and the column indices for the settings are performed is shown by its filename and the column indices for
x, y, and errors. In case of multidimensional fits the array can be selected x, y, and errors. In case of multidimensional fits the array can be selected
with a spin box showing its index within the list of arrays. Then the settings with a spin box showing its index within the list of arrays. Then the settings
can be performed individually for each array.</para> can be performed individually for each array.</para>
<anchor id="errormodel"/> <anchor id="errormodel"/>
<para> <para>
When the box <guilabel>Error column</guilabel> is checked, the corresponding When the box <guilabel>Error column</guilabel> is checked, the corresponding
column of the data set, selected in the dialog <guilabel>Array</guilabel>, is column of the data set, selected in the
used as the standard deviation of the y values for calculation of chi-square. dialog&nbsp; <guilabel>Array</guilabel>, is used as the standard deviation of
Otherwise the standard deviation will be estimated by an error model function the y values for calculation of chi-square. Otherwise the standard deviation
taking the x or the y value as its argument. This function and their parameters will be estimated by an error model function taking the x or the y value as
may be selected in a dialog which is displayed by clicking its argument. This function and their parameters may be selected in a dialog
<guibutton>Model</guibutton>. A simple error model might be selected by which is displayed by clicking <guibutton>Model</guibutton>. A simple error
choosing a polynomial with p1&nbsp;=&nbsp;0.01, resulting in standard model might be selected by choosing a polynomial with p1&nbsp;=&nbsp;0.01,
deviations of 1&nbsp;%.</para> resulting in standard deviations of 1&nbsp;%.</para>
<para> <para>
Termination of the iterative nonlinear parameter fit algorithm may be Termination of the iterative nonlinear parameter fit algorithm may be
controlled by setting a <guilabel>Maximum iterations</guilabel> number and a controlled by setting a <guilabel>Maximum iterations</guilabel> number and a
<guilabel>Tolerance</guilabel> value. Fitting is terminated when either the <guilabel>Tolerance</guilabel> value. Fitting is terminated when either the
maximum number of iterations is reached or the relative errors of chi-square or maximum number of iterations is reached or the relative errors of chi-square or
of the parameters have decreased down to the tolerance value.</para> of the parameters have decreased down to the tolerance value.</para>
<para> <para>
The fit is started by clicking the <guibutton>Start</guibutton> button. The fit is started by clicking the <guibutton>Start</guibutton> button.
Progress of the chi-square values during the iterations is displayed in the Progress of the chi-square values during the iterations is displayed in the
listbox in the lower part of the dialog. Fitting can be terminated by use of listbox in the lower part of the dialog. Fitting can be terminated by use of
the button <guibutton>Cancel</guibutton>. At the end the termination reason is the button&nbsp; <guibutton>Cancel</guibutton>. At the end the termination
displayed as well as the average deviation of the y values, the number of the reason is displayed as well as the average deviation of the y values, the
degrees of freedom ny, and the significance Q, giving the probability that number of the degrees of freedom nu, and the significance Q, giving the
chi-square should exceed the achieved value. The matrix of the resulting probability that chi-square should exceed the achieved value. The matrix of the
parameter correlation coefficients is displayed by use of the button resulting parameter correlation coefficients is displayed by use of the button
<guibutton>Correlations</guibutton>.</para> <guibutton>Correlations</guibutton>.</para>
<para> <para>
The residuals of the fit (the differences between data and function values) The residuals of the fit (the differences between data and function values)
can be plotted graphically by use of the button can be plotted graphically by use of the button
<guibutton>Residuals</guibutton>. The plot displayed in a new window then can <guibutton>Residuals</guibutton>. The plot displayed in a new window then can
be printed and saved as a new plot file with the residual data stored be printed and saved as a new plot file with the residual data stored
internally.</para> internally.</para>
<para> <para>
The dialog may be canceled without saving the parameters by use of the button The dialog may be canceled without saving the parameters by use of the button
<guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> the <guibutton>Cancel</guibutton>. By using <guibutton>Apply</guibutton> the
skipping to change at line 2747 skipping to change at line 2798
The dialog <guilabel>Smoothing spline fit</guilabel> is used to performa fit of The dialog <guilabel>Smoothing spline fit</guilabel> is used to performa fit of
a smoothing spline to a data set. The dialog is opened by selecting a smoothing spline to a data set. The dialog is opened by selecting
<guibutton>Fit</guibutton> from the <link linkend="edit-menu">Edit</link> <guibutton>Fit</guibutton> from the <link linkend="edit-menu">Edit</link>
menu.</para> menu.</para>
<para> <para>
In the group <guilabel>Spline</guilabel> the <guilabel>Degree</guilabel> of the In the group <guilabel>Spline</guilabel> the <guilabel>Degree</guilabel> of the
spline function as well as the boundaries <guilabel>xmin</guilabel> and spline function as well as the boundaries <guilabel>xmin</guilabel> and
<guilabel>xmax</guilabel> of the approximation interval may be set. They give <guilabel>xmax</guilabel> of the approximation interval may be set. They give
the limits of the range for which the spline can be represented and cover at the limits of the range for which the spline can be represented and cover at
least the x values of the data set's range selected in the dialog least the x values of the data set's range selected in the dialog
<guilabel>Feld</guilabel>. The <guilabel>Smoothing factor</guilabel> affects <guilabel>Array</guilabel>. The <guilabel>Smoothing factor</guilabel> affects
the averaged deviation of the spline function from the y values of the data set the averaged deviation of the spline function from the y values of the data set
and is equal to the factor, by which the deviations should differ in the and is equal to the factor, by which the deviations should differ in the
average from the error of the data points. A value of 0 leads to a average from the error of the data points. A value of 0 leads to a
non-smoothing spline.</para> non-smoothing spline.</para>
<para> <para>
In the group <guilabel>Data errors</guilabel> the settings for weighing the In the group <guilabel>Data errors</guilabel> the settings for weighing the
data points may be formed. The <guilabel>Array</guilabel> for which the data points may be formed. The <guilabel>Array</guilabel> for which the
settings are performed is shown by its filename and the column indices for x, settings are performed is shown by its filename and the column indices for x,
y, and errors. When the box <guilabel>Error column</guilabel> is checked, the y, and errors. When the box&nbsp; <guilabel>Error column</guilabel> is checked,
corresponding column of the data set, selected in the dialog the corresponding column of the data set, selected in the dialog&nbsp;
<guilabel>Array</guilabel>, is used as the standard deviation of the y values <guilabel>Array</guilabel>, is used as the standard deviation of the y values
for performing of the fit. Otherwise the standard deviation will be estimated for performing of the fit. Otherwise the standard deviation will be estimated
by an error model function taking the x or the y value as its argument. This by an error model function taking the x or the y value as its argument. This
function and their parameters may be selected in a dialog which is displayed by function and their parameters may be selected in a dialog which is displayed by
clicking <guibutton>Model</guibutton>. A simple error model might be selected clicking <guibutton>Model</guibutton>. A simple error model might be selected
by choosing a polynomial with p1&nbsp;=&nbsp;0.01, resulting in standard by choosing a polynomial with p1&nbsp;=&nbsp;0.01, resulting in standard
deviations of 1&nbsp;%.</para> deviations of 1&nbsp;%.</para>
<para> <para>
The fit is performed by clicking the <guibutton>Start</guibutton> button. The The fit is performed by clicking the <guibutton>Start</guibutton> button. The
obtained number of knots of the spline, the resulting chi-square value as well obtained number of knots of the spline, the resulting chi-square value as well
skipping to change at line 2804 skipping to change at line 2855
The dialog <guilabel>Roots</guilabel> can be opened using the button The dialog <guilabel>Roots</guilabel> can be opened using the button
<guibutton>Roots</guibutton> of the dialogs <guilabel>Function</guilabel>, <guibutton>Roots</guibutton> of the dialogs <guilabel>Function</guilabel>,
<guilabel>Smoothing spline</guilabel>, and <guilabel>Smoothing spline</guilabel>, and
<guilabel>Smoothing spline fit</guilabel>. It is used to find roots of the <guilabel>Smoothing spline fit</guilabel>. It is used to find roots of the
function or spline, respectively, or of its derivatives. In case of a function function or spline, respectively, or of its derivatives. In case of a function
an interpolating (non-smoothing) cubic spline representation is employed, in an interpolating (non-smoothing) cubic spline representation is employed, in
case of a smoothing spline the current spline is used; its degree has to be case of a smoothing spline the current spline is used; its degree has to be
cubic.</para> cubic.</para>
<para> <para>
The <guilabel>Condition</guilabel> for roots to be searched and displayed can The <guilabel>Condition</guilabel> for roots to be searched and displayed can
be selected. A constant <guilabel>c</guilabel> may be used to find points with be selected. A constant&nbsp; <guilabel>c</guilabel> may be used to find points
nonzero values of the spline or its derivatives. The button with nonzero values of the spline or its derivatives. The button
<guilabel>Update</guilabel> is used to update the displayed list of points <guilabel>Update</guilabel> is used to update the displayed list of points
after changing the constant <guilabel>c</guilabel>. The after changing the constant <guilabel>c</guilabel>. The
<guilabel>Condition</guilabel> can also be set to <guilabel>Minimum</guilabel> <guilabel>Condition</guilabel> can also be set to <guilabel>Minimum</guilabel>
or <guilabel>Maximum</guilabel>. Then points with a vanishing first derivative or <guilabel>Maximum</guilabel>. Then points with a vanishing first derivative
and a positive (minimum) or negative (maximum) second derivative are and a positive (minimum) or negative (maximum) second derivative are
listed.</para> listed.</para>
<para> <para>
The list of points, consisting of columns with their x, y, y', and y" values, The list of points, consisting of columns with their x, y, y', and y" values,
can be exported to a text file using the button <guibutton>Export</guibutton>. can be exported as a text file using the button <guibutton>Export</guibutton>.
A file selection dialog will be opened for this purpose.</para> A file selection dialog will be opened for this purpose.</para>
<para> <para>
The dialog is closed by using the button <guibutton>Close</guibutton>.</para> The dialog is closed by using the button <guibutton>Close</guibutton>.</para>
</sect1> </sect1>
<sect1 id="edit-text"> <sect1 id="edit-text">
<title>Edit text</title> <title>Edit text</title>
<anchor id="sec-edit-text"/> <anchor id="sec-edit-text"/>
<para> <para>
The dialog <guilabel>Edit text</guilabel> is used to enter a text containing The dialog <guilabel>Edit text</guilabel> is used to enter a text containing
superscripts, subscripts, and characters of different fonts.</para> superscripts, subscripts, and characters of different fonts.</para>
<para> <para>
The selection of a <guilabel>Font</guilabel> and a The selection of a <guilabel>Font</guilabel> and a
<guilabel>Position</guilabel> is determined by a control sequence starting with <guilabel>Position</guilabel> is determined by a control sequence starting with
the character <keycap>#</keycap> and containing two additional characters in the character&nbsp; <keycap>#</keycap> and containing two additional characters
the field located right to the button with the symbol in the field located right to the button with the symbol
<guilabel>&lt;</guilabel>. Using this button inserts the control sequence (or <guilabel>&lt;</guilabel>. Using this button inserts the control sequence (or
another string, entered manually) at the cursor position to the current text in another string, entered manually) at the cursor position to the current text in
the field left to the button. Text may be inserted manually at any position in the field left to the button. Text may be inserted manually at any position in
the field. The resulting view is shown immediately in a window above the input the field. The resulting view is shown immediately in a window above the input
field.</para> field.</para>
<para> <para>
The dialog may be canceled without saving by use of the button The dialog may be canceled without saving by use of the button
<guibutton>Cancel</guibutton>. With <guibutton>OK</guibutton> changes are saved <guibutton>Cancel</guibutton>. With <guibutton>OK</guibutton> changes are saved
and the dialog is closed. and the dialog is closed.
</para> </para>
skipping to change at line 2871 skipping to change at line 2922
<sect2 id="basic"> <sect2 id="basic">
<title>Basic settings</title> <title>Basic settings</title>
<anchor id="sec-basic"/> <anchor id="sec-basic"/>
<para> <para>
The page <guilabel>Basic settings</guilabel> is used to perform basic The page <guilabel>Basic settings</guilabel> is used to perform basic
presettings.</para> presettings.</para>
<para> <para>
In the group <guilabel>Page format</guilabel> the size of the plot page may be In the group <guilabel>Page format</guilabel> the size of the plot page may be
selected using the combobox. The setting <guilabel>Custom</guilabel> allows to selected using the combobox. The setting&nbsp; <guilabel>Custom</guilabel> allow s to
set user defined <guilabel>Width</guilabel> and <guilabel>Height</guilabel> set user defined <guilabel>Width</guilabel> and <guilabel>Height</guilabel>
values.</para> values.</para>
<para> <para>
In the group <guilabel>Default colors</guilabel> the preselections of the In the group <guilabel>Default colors</guilabel> the preselections of the
colors for <guilabel>Frame</guilabel>, <guilabel>Grid</guilabel>, and colors for&nbsp; <guilabel>Frame</guilabel>, <guilabel>Grid</guilabel>, and
<guilabel>Data</guilabel> may be performed. Selection is done in the dialog <guilabel>Data</guilabel> may be performed. Selection is done in the dialog
<guilabel>Select Color</guilabel>, opened with the colored buttons.</para> <guilabel>Select Color</guilabel>, opened with the colored buttons.</para>
<para> <para>
The presetting of the <guilabel>Decimal symbol</guilabel> for reading data The presetting of the <guilabel>Decimal symbol</guilabel> for reading data
files can be chosen to be point or comma.</para> files can be chosen to be point or comma.</para>
<para> <para>
In the group <guilabel>Output format</guilabel>, the double value In the group <guilabel>Output format</guilabel>, the double value
<guilabel>Presentation</guilabel> and the <guilabel>Precision</guilabel> for <guilabel>Presentation</guilabel> and the <guilabel>Precision</guilabel> for
function parameters and ranges in output files and dialogs may be set, function parameters and ranges in output files and dialogs may be set,
corresponding to the format identifier of the C function corresponding to the format identifier of the C function
<function>printf()</function>. The separator char used to separate columns in <function>printf()</function>. The separator char used to separate columns in
exported data files can be selected using the combobox exported data files can be selected using the combobox&nbsp;
<guilabel>Separator</guilabel>. Space, tab or comma characters may be <guilabel>Separator</guilabel>. Space, tab or comma characters may be
selected.</para> selected.</para>
<para>Also the toggle options of the <para>Also the toggle options of the
<link linkend="settings-menu">Settings</link> menu can be set here at <link linkend="settings-menu">Settings</link> menu can be set here at
once.</para> once.</para>
<para>When <guilabel>Autofit</guilabel> is checked, an automatic parameter fit <para>When <guilabel>Autofit</guilabel> is checked, an automatic parameter fit
will be performed after loading the data file, corresponding to the settings will be performed after loading the data file, corresponding to the settings
performed on the <guilabel>Autofit settings</guilabel> page.</para> performed on the&nbsp; <guilabel>Autofit settings</guilabel> page.</para>
<para>
When <guilabel>Use internal PS encoding</guilabel> is checked, PostScript
output will be created, which can be edited easily. For example, the
coordinates of 2D data points are stored without scaling, according to the
values from data files or function evaluations.</para>
<para> <para>
When <guilabel>Use multiple cores</guilabel> is checked on machines with more When <guilabel>Use multiple cores</guilabel> is checked on machines with more
than one CPU, all CPUs will be used for parallel computation of function than one CPU, all CPUs will be used for parallel computation of function
values for plots and parameter fits.</para> values for plots and parameter fits.</para>
</sect2> </sect2>
<sect2 id="autoplot"> <sect2 id="autoplot">
<title>Autoplot settings</title> <title>Autoplot settings</title>
<anchor id="sec-autoplot"/> <anchor id="sec-autoplot"/>
skipping to change at line 2945 skipping to change at line 2991
scaling can be selected individually by checking <guilabel>log</guilabel>. When scaling can be selected individually by checking <guilabel>log</guilabel>. When
<guilabel>Error bar</guilabel> is checked, the column chosen by <guilabel>Error bar</guilabel> is checked, the column chosen by
<guilabel>Error column</guilabel> is used for displaying error bars. When <guilabel>Error column</guilabel> is used for displaying error bars. When
<guilabel>Normalization</guilabel> is checked, powers of ten are evaluated to <guilabel>Normalization</guilabel> is checked, powers of ten are evaluated to
be multiplied with the numeric data values in case of huge or tiny numbers. If be multiplied with the numeric data values in case of huge or tiny numbers. If
not equal to 1, these normalization factors are included in the axis not equal to 1, these normalization factors are included in the axis
labels.</para> labels.</para>
<para> <para>
In the group <guilabel>Representation</guilabel> the presentation of the array In the group <guilabel>Representation</guilabel> the presentation of the array
data is set. Data may be presented by markers data is set. Data may be presented by markers
(<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) or lines ( &lt;guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) or lines
(<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0). Most conveniently this is (<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0). Most conveniently this is
selected in the dialog <guilabel>Lines and Markers</guilabel>, opened by the selected in the dialog <guilabel>Lines and Markers</guilabel>, opened by the
button right to the spin box, showing the actual line or marker. With button right to the spin box, showing the actual representation. With
<guilabel>Symbol size</guilabel> the relative size of characters and markers as <guilabel>Symbol size</guilabel> the relative size of characters and markers as
well as the relative line widths (proportional to the width of the data window) well as the relative line widths (proportional to the width of the data window)
may be specified. A setting of 100&nbsp;% corresponds to the default. may be specified. A setting of 100&nbsp;% corresponds to the default.
By choosing a <guilabel>Fill pattern</guilabel> the polygon given by the points By choosing a <guilabel>Fill pattern</guilabel> the polygon given by the points
of the array can be filled with a solid color or a pattern instead of being of the array can be filled with a solid color or a pattern instead of being
represented by lines or markers.</para> represented by lines or markers.</para>
</sect2> </sect2>
<sect2 id="autofit"> <sect2 id="autofit">
skipping to change at line 2982 skipping to change at line 3028
<para> <para>
The name of the <guilabel>Function</guilabel> is entered in another field. The The name of the <guilabel>Function</guilabel> is entered in another field. The
function may be chosen from a list in the dialog function may be chosen from a list in the dialog
<guilabel>Functions</guilabel>, opened with the button right to the entry <guilabel>Functions</guilabel>, opened with the button right to the entry
field.</para> field.</para>
<para> <para>
With the button <guibutton>Edit</guibutton> a dialog With the button <guibutton>Edit</guibutton> a dialog
<guilabel>Parameter</guilabel> may be opened, which allows to enter the values <guilabel>Parameter</guilabel> may be opened, which allows to enter the values
of up to 20 initial parameters of the function. Also the parameters which of up to 20 initial parameters of the function. Also the parameters which
should be fitted and not kept constant may be selected by checkboxes. When the should be fitted and not kept constant may be selected by checkboxes. When the
option <guilabel>Show Function Source</guilabel> is activated in the Settings option&nbsp; <guilabel>Show Function Source</guilabel> is activated in the
menu and a C or C++ language source file with the same name as the shared Settings menu and a C or C++ language source file with the same name as the
library but the extension <literal role="extension">.c</literal> or shared library but the extension&nbsp; <literal role="extension">.c</literal>
<literal role="extension">.cpp</literal>, respectively, is present in the same or <literal role="extension">.cpp</literal>, respectively, is present in the
directory, its contents is displayed right to the parameter fields, too. The same directory, its contents is displayed right to the parameter fields, too.
button <guibutton>Load</guibutton> opens a file selection dialog for loading The button&nbsp; <guibutton>Load</guibutton> opens a file selection dialog for
the parameters from an text file (one parameter each line). The button loading the parameters from an text file (one parameter each line). The button
<guibutton>Save</guibutton> opens a file selection dialog for saving the <guibutton>Save</guibutton> opens a file selection dialog for saving the
parameters in an text file.</para> parameters in an text file.</para>
<para> <para>
When the box <guilabel>Nonlinear fit</guilabel> is checked, nonlinear parameter When the box <guilabel>Nonlinear fit</guilabel> is checked, nonlinear parameter
fits by employing the iterative Levenberg-Marquardt method will be performed. fits by employing the iterative Levenberg-Marquardt method will be performed.
Otherwise noniterative general linear least square parameter fits are selected. Otherwise noniterative general linear least square parameter fits are selected.
In this case the function must depend linearly on all parameters chosen to be In this case the function must depend linearly on all parameters chosen to be
fitted.</para> fitted.</para>
<para> <para>
When the box <guilabel>Error column</guilabel> is checked, the corresponding When the box <guilabel>Error column</guilabel> is checked, the corresponding
skipping to change at line 3030 skipping to change at line 3076
option <guilabel>Save parameters</guilabel> is active. The filename is derived option <guilabel>Save parameters</guilabel> is active. The filename is derived
from the name of the data file. The extension is set to from the name of the data file. The extension is set to
<filename>.par</filename>.</para> <filename>.par</filename>.</para>
<para> <para>
When <guilabel>Follow parameters</guilabel> is active, the set of initial When <guilabel>Follow parameters</guilabel> is active, the set of initial
parameters will not be reset before starting a fit to the next data set of a parameters will not be reset before starting a fit to the next data set of a
series of data files.</para> series of data files.</para>
<para> <para>
In the group <guilabel>Representation</guilabel> the presentation of the In the group <guilabel>Representation</guilabel> the presentation of the
fitted function is set. It may be presented by markers fitted function is set. It may be presented by markers
(<guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) or lines ( &lt;guilabel>Symbol</guilabel>&nbsp;&lt;=&nbsp;0) or lines
(<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0). Most conveniently this is (<guilabel>Symbol</guilabel>&nbsp;&gt;&nbsp;0). Most conveniently this is
selected in the dialog <guilabel>Lines and Markers</guilabel>, opened by the selected in the dialog <guilabel>Lines and Markers</guilabel>, opened by the
button right to the spin box, showing the actual line or marker. The button right to the spin box, showing the actual representation. The
<guilabel>Color</guilabel> of lines or markers may be chosen using the <guilabel>Color</guilabel> of lines or markers may be chosen using the
dialog <guilabel>Select Color</guilabel>, opened with the colored button. dialog <guilabel>Select Color</guilabel>, opened with the colored button.
By choosing a <guilabel>Fill pattern</guilabel> the polygon given by the By choosing a <guilabel>Fill pattern</guilabel> the polygon given by the
points of the function values can be filled with a solid color or a pattern points of the function values can be filled with a solid color or a pattern
instead of being represented by lines or markers.</para> instead of being represented by lines or markers.</para>
</sect2> </sect2>
</sect1> </sect1>
skipping to change at line 3073 skipping to change at line 3119
and a pointer to a <type>double</type> array of up to 20 parameters:</para> and a pointer to a <type>double</type> array of up to 20 parameters:</para>
<programlisting> <programlisting>
double my3Dfunction(double x, double z, const double *p);</programlisting> double my3Dfunction(double x, double z, const double *p);</programlisting>
<para> <para>
Module definition files (of the type <literal role="extension">.def</literal> Module definition files (of the type <literal role="extension">.def</literal>
and the same name as source and library files) can be used as a lookup table and the same name as source and library files) can be used as a lookup table
by &kpl;. They correspond to the output of the program by &kpl;. They correspond to the output of the program
<command>nm</command>.</para> <command>nm</command>.</para>
<para> <para>
In the directory In the directory
$<envar>KDEDIR</envar><filename>/lib/kde4/plugins/kpl</filename> $<envar>KDEDIR</envar><filename>/lib/qt5/plugins/kpl</filename>
or $<envar>KDEDIR</envar><filename>/lib64/kde4/plugins/kpl</filename> in case or $<envar>KDEDIR</envar><filename>/lib64/qt5/plugins/kpl</filename> in case
of 32 or 64 bit installations, respectively, a shared library of 32 or 64 bit installations, respectively, a shared library
<filename>fkt.so</filename> as well as the source file <filename>fkt.so</filename> as well as the source file
<filename>fkt.c</filename>, the module definition file <filename>fkt.c</filename>, the module definition file
<filename>fkt.def</filename>, and a make file <filename>Makefile.fkt</filename> <filename>fkt.def</filename>, and a make file <filename>Makefile.fkt</filename>
are already installed. The files <filename>fkt.c</filename> and are already installed. The files <filename>fkt.c</filename> and
<filename>Makefile.fkt</filename> may be used as examples and have to be <filename>Makefile.fkt</filename> may be used as examples and have to be
customized in this case. The example plot files <filename>demo2.plo</filename>, customized in this case. The example plot files <filename>demo2.plo</filename>,
<filename>demo3.plo</filename>, <filename>demo4.plo</filename>, <filename>demo3.plo</filename>, <filename>demo4.plo</filename>,
<filename>demo5.plo</filename>, <filename>demo6.plo</filename> and <filename>demo5.plo</filename>, <filename>demo6.plo</filename> and
<filename>demo11.plo</filename> in the same directory make use of the functions <filename>demo11.plo</filename> in the same directory make use of the functions
skipping to change at line 3099 skipping to change at line 3145
<filename>fcompl.so</filename>, <filename>fcompl.def</filename>, and <filename>fcompl.so</filename>, <filename>fcompl.def</filename>, and
<filename>Makefile.fcompl</filename> are provided in the same directory. Here <filename>Makefile.fcompl</filename> are provided in the same directory. Here
two <type>double</type> valued functions make use of the real and imaginary two <type>double</type> valued functions make use of the real and imaginary
part of a complex function, implemented with the class part of a complex function, implemented with the class
<classname>complex</classname>. The example plot files <classname>complex</classname>. The example plot files
<filename>demo7.plo</filename> and <filename>demo8.plo</filename> make use of <filename>demo7.plo</filename> and <filename>demo8.plo</filename> make use of
the functions of <filename>fcompl.so</filename>.</para> the functions of <filename>fcompl.so</filename>.</para>
</sect1> </sect1>
<sect1 id="d-bus"> <sect1 id="D-Bus">
<title>D-BUS Interface</title> <title>D-Bus Interface</title>
<para> <para>
The <acronym>D-BUS</acronym> interface allows to control &kpl; by other KDE The <acronym>D-Bus</acronym> interface allows to control &kpl; by other KDE
applications and scripts.</para> applications and scripts.</para>
<para> <para>
A C++ example <filename>demo1.cpp</filename> for a KDE application using the A C++ example <filename>demo1.cpp</filename> for a KDE application using the
<acronym>D-BUS</acronym> interface of &kpl; is provided in the directory <acronym>D-Bus</acronym> interface of &kpl; is provided in the directory
$<envar>KDEDIR</envar><filename>/lib/kde4/plugins/kpl</filename> or $<envar>KDEDIR</envar><filename>/lib/qt5/plugins/kpl</filename> or
$<envar>KDEDIR</envar><filename>/lib64/kde4/plugins/kpl</filename> in case of $<envar>KDEDIR</envar><filename>/lib64/qt5/plugins/kpl</filename> in case of
32 or 64 bit installations, respectively, together with a 32 or 64 bit installations, respectively, together with
<command>cmake</command> project file <filename>CMakeLists.txt</filename>. a&nbsp; <command>cmake</command> project file
To compile it, copy these two files to some directory and run <filename>CMakeLists.txt</filename>. To compile it, copy these two files to
<command>cmake ./</command> and <command>make</command> there.</para> some directory and run&nbsp; <command>cmake ./</command> and
<command>make</command> there.</para>
<para> <para>
An example <filename>demo1.py</filename> for a Python script using the An example <filename>demo1.py</filename> for a Python script using the
<acronym>D-BUS</acronym> interface of &kpl; is also provided in that directory. <acronym>D-Bus</acronym> interface of &kpl; is also provided in that directory.
It essentially does the same as the C++ example.</para> It essentially does the same as the C++ example.</para>
<para> <para>
To test the <acronym>D-BUS</acronym> interface of &kpl; you also can use the To test the <acronym>D-Bus</acronym> interface of &kpl; you also can use the
<acronym>D-BUS</acronym> utilities <command>qdbus</command> (command line) and <acronym>D-Bus</acronym> utilities <command>qdbus</command> (command line) and
<command>qdbusviewer</command> (GUI).</para> <command>qdbusviewer</command> (GUI).</para>
<para> <para>
The <acronym>D-BUS</acronym> interface of &kpl; provides the following The <acronym>D-Bus</acronym> interface of &kpl; provides the following
functions:</para> functions:</para>
<sect2> <sect2>
<title>newPlot</title> <title>newPlot</title>
<synopsis> <synopsis>
void newPlot(); void newPlot();
</synopsis> </synopsis>
<para> <para>
Erases the current plot. Erases the current plot.
</para> </para>
skipping to change at line 3220 skipping to change at line 3267
</term> </term>
<listitem><para>true for landscape orientation. <listitem><para>true for landscape orientation.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Returns: true when succeeded. <para>Returns: true when succeeded.
</para> </para>
</sect2> </sect2>
<sect2> <sect2>
<title>exportImage</title>
<synopsis>
bool exportImage(const QString&amp; <replaceable class="parameter">url</replacea
ble>);
</synopsis>
<para>Exports as a PDF, PNG, PPM, BMP, JPEG, TIFF, or SVG image file.</para>
<para>Parameters:</para>
<variablelist>
<varlistentry>
<term><replaceable class="parameter">url</replaceable>
</term>
<listitem><para>URL of the file.
</para></listitem>
</varlistentry>
</variablelist>
<para>Returns: true when succeeded.
</para>
</sect2>
<sect2>
<title>printPlot</title> <title>printPlot</title>
<synopsis> <synopsis>
bool printPlot(const QString&amp; <replaceable class="parameter">printerName</re placeable>, bool printPlot(const QString&amp; <replaceable class="parameter">printerName</re placeable>,
const QString&amp; <replaceable class="parameter">fileName</repla ceable>, const QString&amp; <replaceable class="parameter">fileName</repla ceable>,
bool <replaceable class="parameter">landscape</replaceable>, bool <replaceable class="parameter">landscape</replaceable>,
int <replaceable class="parameter">numCopies</replaceable>); int <replaceable class="parameter">numCopies</replaceable>);
</synopsis> </synopsis>
<para>Prints current plot.</para> <para>Prints current plot.</para>
<para>Parameters:</para> <para>Parameters:</para>
<variablelist> <variablelist>
skipping to change at line 3298 skipping to change at line 3364
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
<sect2> <sect2>
<title>setBoundingBoxOption</title> <title>setBoundingBoxOption</title>
<synopsis> <synopsis>
void setBoundingBoxOption(bool <replaceable class="parameter">calculate</replace able>); void setBoundingBoxOption(bool <replaceable class="parameter">calculate</replace able>);
</synopsis> </synopsis>
<para>Sets calculate PS bounding box option.</para> <para>Sets calculate bounding box option.</para>
<para>Parameters:</para> <para>Parameters:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">calculate</replaceable> <term><replaceable class="parameter">calculate</replaceable>
</term> </term>
<listitem><para>true to calculate automatically the box. <listitem><para>true to calculate automatically the box.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
skipping to change at line 5667 skipping to change at line 5733
</term> </term>
<listitem><para>true for visible item. <listitem><para>true for visible item.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
<sect2> <sect2>
<title>newArrowItem</title> <title>newArrowItem</title>
<synopsis> <synopsis>
void newArrowItem(const QString&amp; <replaceable class="parameter">color</repla void newArrowItem(int <replaceable class="parameter">type</replaceable>,
ceable>, const QString&amp; <replaceable class="parameter">color</repla
ceable>,
double <replaceable class="parameter">x</replaceable>, double <replaceable class="parameter">x</replaceable>,
double <replaceable class="parameter">y</replaceable>, double <replaceable class="parameter">y</replaceable>,
double <replaceable class="parameter">dir</replaceable>, double <replaceable class="parameter">dir</replaceable>,
double <replaceable class="parameter">len</replaceable>, double <replaceable class="parameter">len</replaceable>,
double <replaceable class="parameter">relSize</replaceable>, double <replaceable class="parameter">relSize</replaceable>,
bool <replaceable class="parameter">doubleHeaded</replaceable> , bool <replaceable class="parameter">doubleHeaded</replaceable> ,
bool <replaceable class="parameter">active</replaceable>); bool <replaceable class="parameter">active</replaceable>);
</synopsis> </synopsis>
<para>Appends new arrow item.</para> <para>Appends new arrow item.</para>
<para>Parameters:</para> <para>Parameters:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">type</replaceable>
</term>
<listitem><para>1 to 9 for different line types.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">color</replaceable> <term><replaceable class="parameter">color</replaceable>
</term> </term>
<listitem><para>color for arrow. <listitem><para>color for arrow.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">x</replaceable> <term><replaceable class="parameter">x</replaceable>
</term> </term>
<listitem><para>x position of head in cm. <listitem><para>x position of head in cm.
</para></listitem> </para></listitem>
skipping to change at line 5735 skipping to change at line 5808
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Returns: true when succeeded. <para>Returns: true when succeeded.
</para> </para>
</sect2> </sect2>
<sect2> <sect2>
<title>newArcItem</title> <title>newArcItem</title>
<synopsis> <synopsis>
void newArcItem(const QString&amp; <replaceable class="parameter">color</replace void newArcItem(int <replaceable class="parameter">type</replaceable>,
able>, const QString&amp; <replaceable class="parameter">color</replace
able>,
double <replaceable class="parameter">x</replaceable>, double <replaceable class="parameter">x</replaceable>,
double <replaceable class="parameter">y</replaceable>, double <replaceable class="parameter">y</replaceable>,
double <replaceable class="parameter">w</replaceable>, double <replaceable class="parameter">w</replaceable>,
double <replaceable class="parameter">h</replaceable>, double <replaceable class="parameter">h</replaceable>,
double <replaceable class="parameter">start</replaceable>, double <replaceable class="parameter">start</replaceable>,
double <replaceable class="parameter">span</replaceable>, double <replaceable class="parameter">span</replaceable>,
double <replaceable class="parameter">relSize</replaceable>, double <replaceable class="parameter">relSize</replaceable>,
double <replaceable class="parameter">dir</replaceable>, double <replaceable class="parameter">dir</replaceable>,
bool <replaceable class="parameter">active</replaceable>); bool <replaceable class="parameter">active</replaceable>);
</synopsis> </synopsis>
<para>Appends new elliptic arc item.</para> <para>Appends new elliptic arc item.</para>
<para>Parameters:</para> <para>Parameters:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">type</replaceable>
</term>
<listitem><para>1 to 9 for different line types.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">color</replaceable> <term><replaceable class="parameter">color</replaceable>
</term> </term>
<listitem><para>color of the arc. <listitem><para>color of the arc.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">x</replaceable> <term><replaceable class="parameter">x</replaceable>
</term> </term>
<listitem><para>x position of center in cm. <listitem><para>x position of center in cm.
</para></listitem> </para></listitem>
skipping to change at line 5815 skipping to change at line 5895
</term> </term>
<listitem><para>true for visible item. <listitem><para>true for visible item.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
<sect2> <sect2>
<title>newRectangleItem</title> <title>newRectangleItem</title>
<synopsis> <synopsis>
void newRectangleItem(const QString&amp; <replaceable class="parameter">color</r void newRectangleItem(int <replaceable class="parameter">type</replaceable>,
eplaceable>, const QString&amp; <replaceable class="parameter">color</r
eplaceable>,
double <replaceable class="parameter">x</replaceable>, double <replaceable class="parameter">x</replaceable>,
double <replaceable class="parameter">y</replaceable>, double <replaceable class="parameter">y</replaceable>,
double <replaceable class="parameter">w</replaceable>, double <replaceable class="parameter">w</replaceable>,
double <replaceable class="parameter">h</replaceable>, double <replaceable class="parameter">h</replaceable>,
double <replaceable class="parameter">relSize</replaceable >, double <replaceable class="parameter">relSize</replaceable >,
int <replaceable class="parameter">fillStyle</replaceable> , int <replaceable class="parameter">fillStyle</replaceable> ,
double <replaceable class="parameter">dir</replaceable>, double <replaceable class="parameter">dir</replaceable>,
bool <replaceable class="parameter">active</replaceable>); bool <replaceable class="parameter">active</replaceable>);
</synopsis> </synopsis>
<para>Appends new rectangle item.</para> <para>Appends new rectangle item.</para>
<para>Parameters:</para> <para>Parameters:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">type</replaceable>
</term>
<listitem><para>1 to 9 for different line types.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">color</replaceable> <term><replaceable class="parameter">color</replaceable>
</term> </term>
<listitem><para>color of the rectangle. <listitem><para>color of the rectangle.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">x</replaceable> <term><replaceable class="parameter">x</replaceable>
</term> </term>
<listitem><para>x position of left side in cm. <listitem><para>x position of left side in cm.
</para></listitem> </para></listitem>
skipping to change at line 5888 skipping to change at line 5975
</term> </term>
<listitem><para>true for visible item. <listitem><para>true for visible item.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
<sect2> <sect2>
<title>newEllipseItem</title> <title>newEllipseItem</title>
<synopsis> <synopsis>
void newEllipseItem(const QString&amp; <replaceable class="parameter">color</rep void newEllipseItem(int <replaceable class="parameter">type</replaceable>,
laceable>, const QString&amp; <replaceable class="parameter">color</rep
laceable>,
double <replaceable class="parameter">x</replaceable>, double <replaceable class="parameter">x</replaceable>,
double <replaceable class="parameter">y</replaceable>, double <replaceable class="parameter">y</replaceable>,
double <replaceable class="parameter">w</replaceable>, double <replaceable class="parameter">w</replaceable>,
double <replaceable class="parameter">h</replaceable>, double <replaceable class="parameter">h</replaceable>,
double <replaceable class="parameter">relSize</replaceable>, double <replaceable class="parameter">relSize</replaceable>,
int <replaceable class="parameter">fillStyle</replaceable>, int <replaceable class="parameter">fillStyle</replaceable>,
double <replaceable class="parameter">dir</replaceable>, double <replaceable class="parameter">dir</replaceable>,
bool <replaceable class="parameter">active</replaceable>); bool <replaceable class="parameter">active</replaceable>);
</synopsis> </synopsis>
<para>Appends new ellipse item.</para> <para>Appends new ellipse item.</para>
<para>Parameters:</para> <para>Parameters:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">type</replaceable>
</term>
<listitem><para>1 to 9 for different line types.
</para></listitem>
</varlistentry>
<varlistentry>
<term><replaceable class="parameter">color</replaceable> <term><replaceable class="parameter">color</replaceable>
</term> </term>
<listitem><para>color of the ellipse. <listitem><para>color of the ellipse.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">x</replaceable> <term><replaceable class="parameter">x</replaceable>
</term> </term>
<listitem><para>x position of center in cm. <listitem><para>x position of center in cm.
</para></listitem> </para></listitem>
skipping to change at line 6399 skipping to change at line 6493
<para>Returns: true when succeeded. <para>Returns: true when succeeded.
</para> </para>
</sect2> </sect2>
<sect2> <sect2>
<title>exportValues</title> <title>exportValues</title>
<synopsis> <synopsis>
bool exportValues(const QString&amp; <replaceable class="parameter">url</replace able>, bool exportValues(const QString&amp; <replaceable class="parameter">url</replace able>,
int <replaceable class="parameter">iItem</replaceable>); int <replaceable class="parameter">iItem</replaceable>);
</synopsis> </synopsis>
<para>Exports function value table to file.</para> <para>Exports function value table as text file.</para>
<para>Parameters:</para> <para>Parameters:</para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">url</replaceable> <term><replaceable class="parameter">url</replaceable>
</term> </term>
<listitem><para>URL of the file. <listitem><para>URL of the file.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><replaceable class="parameter">iItem</replaceable> <term><replaceable class="parameter">iItem</replaceable>
skipping to change at line 6430 skipping to change at line 6524
<sect1 id="library"> <sect1 id="library">
<title>Class Library libkpl</title> <title>Class Library libkpl</title>
<para> <para>
The class library libkpl now allows to use &kpl; classes by other KDE The class library libkpl now allows to use &kpl; classes by other KDE
applications. It provides the classes <classname>KplScene</classname>, applications. It provides the classes <classname>KplScene</classname>,
<classname>KplView</classname> as well as several graphics item classes, <classname>KplView</classname> as well as several graphics item classes,
inheriting from corresponding classes of the Graphics View Framework of Qt. inheriting from corresponding classes of the Graphics View Framework of Qt.
The documentation of its API will be installed at The documentation of its API will be installed at
<ulink url="file:///usr/share/doc/kde/HTML/en/kpl-apidocs/index.html"> <ulink url="file:///usr/share/doc/HTML/en/kpl-apidocs/index.html">
$<envar>KDEDIR</envar>/share/doc/kde/HTML/en/kpl-apidocs/index.html</ulink>.</pa $<envar>KDEDIR</envar>/share/doc/HTML/en/kpl-apidocs/index.html</ulink>.</para>
ra>
</sect1> </sect1>
</chapter> </chapter>
<chapter id="faq"> <chapter id="faq">
<title>Questions and Answers</title> <title>Questions and Answers</title>
<para></para> <para></para>
skipping to change at line 6489 skipping to change at line 6583
</chapter> </chapter>
<chapter id="credits"> <chapter id="credits">
<title>Credits and License</title> <title>Credits and License</title>
<para> <para>
&kpl; &kpl;
</para> </para>
<para> <para>
Program copyright &copy; 2015 Werner Stille <email>stille@uni-freiburg.de</email > Program copyright &copy; 2017 Werner Stille <email>kpl@werner-stille.de</email>
</para> </para>
<para> <para>
Documentation copyright &copy; 2015 Werner Stille Documentation copyright &copy; 2017 Werner Stille
<email>stille@uni-freiburg.de</email> <email>kpl@werner-stille.de</email>
</para> </para>
<para> <para>
Thanks to Thanks to
<itemizedlist> <itemizedlist>
<listitem><para>the KDevelop Team for making KDE programming much more <listitem><para>the KDevelop Team for making KDE programming much more
easy</para></listitem> easy</para></listitem>
<listitem><para>Dimi Shahbaz <email>dshahbaz@ucla.edu</email> for suggestions <listitem><para>Dimi Shahbaz <email>dshahbaz@ucla.edu</email> for suggestions
and patches</para></listitem> and patches</para></listitem>
<listitem><para>Jürgen Siepmann <email>siepmann@kanzlei-siepmann.de</email> for <listitem><para>Jürgen Siepmann <email>siepmann@kanzlei-siepmann.de</email> for
skipping to change at line 6532 skipping to change at line 6626
</chapter> </chapter>
<appendix id="installation"> <appendix id="installation">
<title>Installation</title> <title>Installation</title>
<sect1 id="getting-kpl"> <sect1 id="getting-kpl">
<title>How to Obtain &kpl;</title> <title>How to Obtain &kpl;</title>
<para> <para>
&kpl; can be found on its homepage &kpl; can be found on its homepage
<ulink url="http://omnibus.uni-freiburg.de/~stille/kpl/index.html"> <ulink url="http://kpl.werner-stille.de">http://kpl.werner-stille.de</ulink>.</p
http://omnibus.uni-freiburg.de/~stille/kpl/index.html</ulink>.</para> ara>
</sect1> </sect1>
<sect1 id="requirements"> <sect1 id="requirements">
<title>Requirements</title> <title>Requirements</title>
<para> <para>
In order to successfully use &kpl;, you need KDE. The PostScript interpreter In order to successfully use &kpl;, you need KDE. The PostScript
<application>Ghostscript</application> is required for the automatic interpreter&nbsp; <application>Ghostscript</application> is required for the
calculation of bounding boxes for generated PostScript files.</para> automatic calculation of bounding boxes for generated PostScript files.</para>
</sect1> </sect1>
<sect1 id="compilation"> <sect1 id="compilation">
<title>Compilation and Installation</title> <title>Compilation and Installation</title>
&install.compile.documentation; &install.compile.documentation;
</sect1> </sect1>
</appendix> </appendix>
 End of changes. 155 change blocks. 
256 lines changed or deleted 351 lines changed or added

Home  |  About  |  All  |  Newest  |  Fossies Dox  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTPS