Next Previous Table of Contents
When items of the presentation already exist, they are listed in the dialog window. In case of a frame its position and size is shown; in case of an array the name of the data file as well as the column indices of x and y values, in case of a function the names of the shared library and the function, in case of a parametric function the names of the shared libraries and the functions for x(t) and y(t), and in case of a legend the number of the marker or line. When the dialog is left open, it will reflect changes in the item list.
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 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 following a frame item, will be plotted without a frame. Function and data set values then will be interpreted as cms. The position of the selected item can be changed using the up and down arrow buttons left to the tree view.
Each item is preceeded by a checkbox, displaying its activation state. Activated items are shown in the plot, deactivated items are hidden. The state can be toggled by clicking an item with the left mouse button, by pressing the space bar after selecting an item with the cursor keys, or by the item´s context menu, which pops up when an item is clicked with the right mouse button. An item can be selected without changing its activation state by clicking it with the right mouse button, or by use of the cursor keys.
For appending a new item to the list, the button New opens the dialog New Item, where the type of the item is to be chosen.
The button Edit opens the according dialog for the setting of the item selected from the list. Editing can also be selected from a context menu, which pops up when an item is clicked with the right mouse button. Double clicking of an item in the list enters the edit mode, too.
The button Fit changes the selection mode of the item list by a first click to allow multiselection of items. Then you are asked (by the short help displayed in the status bar) to select one function item and one array item. A second click then opens the dialog Parameter fit for performing a parameter fit of the chosen function to the data set of the chosen array item. When the item list contains exactly one function and one array item, no multiselection is necessary and the dialog is opened already by the first click.
By using the button Delete the chosen item may be deleted. Deleting of an item can also be selected from its context menu.
The button Copy is used to place a copy of the chosen item at the end of the list. Copying of an item can also be selected from the its context menu.
The dialog is closed by using the button Close. The dialog can be left open during work with kpl.
The type of the new item may be chosen using the buttons Frame, Array, Function, Parametric Function, and Legend.
When the type is chosen, the according dialog for the settings of the new item is displayed.
Here the settings for frame and Labels may be performed.
In the group Axis mode one can choose between only a frame 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 values.
In the group Colors the colors for frame and ticks or grid are selected with the dialog Select Color, displayed by using the color buttons.
The group Automatic allows convenient scaling of the presentation by using the button Autoscale, when arrays or functions are already set in subsequent items of the presentation. When Normalization is checked, at this time also powers of ten are evaluated to 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 labels.
In the group Window position and size of the data window may be set.
The group Scaling allows manual scaling of the 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 button Autoscale.
The group Axes allows to specify the distances xtic and ytic of major tick marks or grid lines. In case of tick marks minor ticks may be drawn between the (labeled) major ticks. The number of intervals dividing the distance between the major ticks can be specified by mticx and mticy. For axes with numeric labels the number of digits behind the decimal point may be selected by ndigx and ndigy. Here values of -1 are used to suppress the output of the decimal point. The settings also may be performed by using the button Autoscale.
In the group Labels text for the axis labels and a heading may be entered. Text with special characters is entered more conveniently in the dialog Edit text which shows up when using the buttons right to the entry fields. Powers of ten for normalization factors to be incuded in the axis labels may be specified manually by iex and iey.
With Symbol size the relative size of characters and markers as well as the relative line widths (proportional to the width of the data window) may be specified. A setting of 100 % corresponds to default.
The dialog may be canceled without saving by use of the button Cancel. By using Apply changes are saved without closing the dialog. With OK changes are saved and the dialog is closed.
The dialog Array is used to perform the settings for a data set from a data file.
The button File is used to open a file selection dialog for selecting a data file. The path of the file is displayed right to the button. Selecting a file results in automatic determination of suitable values for the following settings.
In x column and y column the file columns for abscissa and ordinate values may be chosen. 0 corresponds to the first column.
When Error bar is checked the column chosen in Error column is used for displaying error bars.
The Start index is the row index for the first data point to be displayed. 0 corresponds to the first row of the data file, not counting comment lines. Together with the Number of points the displayed portion of the file is selected.
Factors for x normalization and y normalization may be entered manually. These factors also may be determined automatically using Autoscale with checked Normalization in the dialog Frame.
Markers (Symbol <= 0) or lines (Symbol > 0) may be chosen to present the data points. This is done most convenient using the dialog Lines and Markers, to be opened with the button right to the spinbutton, which shows the actual line or marker.
The Color of lines or markers may be chosen using the dialog Select Color, opened with the colored button.
The dialog may be canceled without saving by use of the button Cancel. By using Apply changes are saved without closing the dialog. With OK changes are saved and the dialog is closed.
The dialog Function is used to perform the settings for function plots.
In the field Library in the group y(x) the path of the shared library containing the function to be chosen may be entered. The button right to the entry field opens a file selection dialog for this purpose.
The name of the Function is entered in another field. When in the same directory as for the shared library a module definition file with the same name but the extension .def is present, the function may be chosen from a list in the dialog Functions, opened with the button right to the entry field.
With the button Edit a dialog Parameter may be opened, which allows to enter the values of up to 20 parameters of the function. When the option Show Function Source is activated in the Options menu and a C language source file with the same name as the shared library with the extension .c is present in the same directory, its contents is displayed right to the parameter fields, too. The button Load opens a file selection dialog for loading the parameters from an ASCII file (one parameter each line). The button Save opens a file selection dialog for saving the parameters in an ASCII file.
The limits for the function's argument are entered using the fields xmin and xmax. With Delta x the step length for the argument is set. A value of 0 results in automatically dividing the range from xmin to xmax into 100 intervals.
Factors for x normalization and y normalization may be entered manually. These factors also may be determined automatically using Autoscale with checked Normalization in the dialog Frame.
A function value table may be exported as a data file by use of the button Export. A file selection dialog will be openened for this purpose.
Markers (Symbol <= 0) or lines (Symbol > 0) may be chosen to present the function. This is done most convenient using the dialog Lines and Markers, to be opened with the button right to the spinbutton, which shows the actual line or marker.
The Color of lines or markers may be chosen using the dialog Select Color, opened with the colored button.
The dialog may be canceled without saving by use of the button Cancel. By using Apply changes are saved without closing the dialog. With OK changes are saved and the dialog is closed.
The dialog Parametric function is used to perform the settings for plots of parametric functions.
In the groups x(t) and y(t) the setting for the abscissa an the ordinate function may be performed in the same way:
In the fields Library the paths of the shared libraries containing the functions to be chosen may be entered. The buttons right to the entry fields open file selection dialogs for this purpose.
The names of the Functions for x(t) and y(t) are entered in the corresponding fields. When in the same directories as for the shared libraries module definition files with the same names but the extension .def are present, the functions may be chosen from a list in the dialog Functions, opened with the buttons right to the entry fields.
With the buttons Edit a dialog Parameter may be opened, which allows to enter the values of up to 20 parameters of the functions. When the option Show Function Source is activated in the Options menu and a C language source file with the same name as the shared library but the extension .c is present in the same directory, its contents is displayed right to the parameter fields, too. The buttons Load open a file selection dialog for loading the parameters from an ASCII file (one parameter each line). The buttons Save open a file selection dialog for saving the parameters in an ASCII file.
The limits for the function's common argument t are entered using the fields tmin and tmax. With Delta t the step length for the argument is set. A value of 0 results in automatically dividing the range from tmin to tmax into 100 intervals.
Factors for x normalization and y normalization may be entered manually. These factors also may be determined automatically using Autoscale with checked Normalization in the dialog Frame.
A function value table may be exported as a data file by use of the button Export. A file selection dialog will be openened for this purpose.
Markers (Symbol <= 0) or lines (Symbol > 0) may be chosen to present the functions. This is done most convenient using the dialog Lines and Markers, to be opened with the button right to the spinbutton, which shows the actual line or marker.
The Color of lines or markers may be chosen using the dialog Select Color, opened with the colored button.
The dialog may be canceled without saving by use of the button Cancel. By using Apply changes are saved without closing the dialog. With OK changes are saved and the dialog is closed.
The dialog Legend is used to perform the settings for the explanation of line types and symbols as well as for additional labels.
In the group Data a Symbol to be explained is selected. This is done most convenient using the dialog Lines and Markers, opened using the button right to the spinbutton, which shows the actual line or marker. The symbol number -17 may be chosen to draw labels without markers or lines. The Color of lines and markers is selected in the dialog Select Color, opened with the colored button. With x and y the position with respect to the lower left corner of the window may be set.
In the group Label the Text may be entered. Text with special characters is entered most convenienly using the dialog Edit text, opened using the button right to the entry field. With Size the relative size of the characters may be set. A setting of 100 % correspond to a normal value. The Color of the text label is selected in the dialog Select Color, opened with the colored button. With xoff and yoff the position of the text with respect to that of the symbol may be entered.
The dialog may be canceled without saving by use of the button Cancel. By using Apply changes are saved without closing the dialog. With OK changes are saved and the dialog is closed.
The dialog Parameter fit is used to perform parameter fits of a function to a data set. The dialog is shown either when fit is selected in the dialog Items, or when a data file is loaded and the options Autofit in the dialog Autoplot settings and Show dialog in the dialog Autofit settings both are activated.
When the box Nonlinear fit is checked, nonlinear parameter fits by employing the iterative Levenberg-Marquardt method will be performed. Otherwise noniterative general linear least square parameter fits are selected. In this case the function must depend linearly on all parameters chosen to be fitted.
Initial values for the parameters may be entered in the corresponding fields. By checking the boxes left to the entry fields the parameters are chosen to be fitted, otherwise their values are kept constant. In case of general linear least square fits no initial values need to be entered for the parameters chosen to be fitted. The estimated standard deviations of the parameter are displayed right to the corresponding entry fields.
The buttons Load and Save are used to load and save the current parameter set from or to text files, respectively. Differing to the format used in the other parameter setting dialogs, here a second column containing the estimated standard deviations of the parameters is saved, too.
When the box Error column is checked, the corresponding column of the data set, selected in the dialog Array, is used as the standard deviation of the y values for calculation of chi-square. Otherwise the standard deviation will be estimated by an error model function taking the y value as its argument. This function and their parameters may be selected in a dialog which is displayed by clicking Model. A simple error model might be selected by choosing a polynomial with p1 = 0.01, resulting in standard deviations of 1 %.
Termination of the iterative nonlinear parameter fit algorithm may be controlled by setting a Maximum iterations number and a Tolerance value. Fitting is terminated when either the maximum number of iterations is reached or the relative errors of chi-square or of the parameters have decreased downto the tolerance value.
The fit is started by clicking the Start button. 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 the button Cancel. At the end the termination reason is displayed as well as the average deviation of the y values, the number of the degrees of freedom ny, and the significance Q, giving the probability that chi-square should exceed the achieved value. The matrix of the resulting parameter correlation coefficients is displayed by use of the button Correlations.
The dialog may be canceled without saving the parameters by use of the button Cancel. By using Apply the parameters are saved without closing the dialog. With OK the parameters are saved and the dialog is closed.
The dialog Edit text is used to enter a text containing superscripts, subscripts, and characters of different fonts.
The selection of a Font and a Position is determined by a control sequence starting with the character # containing two additional characters in the field located right to the button with the symbol <. Using this button appends the control sequence (or another string, entered manually) to the current text 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 field.
The dialog may be canceled without saving by use of the button Cancel. With OK changes are saved and the dialog is closed.
The dialog Basic settings is used to perform the presettings for size and colors of the graphical presentation.
In the group Page format the Width und Height of the page can be set. For convenient setting of the standard sizes Portrait A4 and Landscape A4 two buttons are available.
In the group Default colors the preselections of the colors for Frame, Grid, and Data may be performed. Selection is done in the dialog Select Color, opened with the colored buttons.
In the group Output format the double value Presentation and the Precision for function parameters in output files and dialogs may be set, corresponding to the format identifier of the C function printf().
The dialog Autoplot settings is used to perform the settings for automatic scaling of data files loaded by command line parameters, file menu, or by drag and drop.
In the group Window position and size of the data window may be set.
In the group Axis mode one can choose between only a frame 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 values.
In the group Labels text for the axis labels and a heading may be entered. Text with special characters is entered most conveniently in the dialog Edit text which shows up when using the buttons right to the entry fields. By checking = path the path of the data files is used as the heading label.
In the group Data the file columns for abscissa and ordinate values may be chosen by x column and y column. 0 corresponds to the first column. When Error bar is checked the column chosen in Error column is used for displaying error bars. Data may be presented by markers (Symbol <= 0) or lines (Symbol > 0). Most conveniently this is selected in the dialog Lines and Markers, opened by the button right to the spinbutton, which shows the actual line or marker. When Normalization is checked, powers of ten are evaluated to 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 labels.
The dialog may be canceled without saving by use of the button Cancel. By using Apply changes are saved without closing the dialog. With OK changes are saved and the dialog is closed.
The dialog Autofit settings is used to perform the settings for automatic parameter fits of functions to data sets, which are combined with the autoplot feature when the option Autofit is activated in the Autoplot settings dialog.
In the Library field in the group y(x) the path of the shared library containing the function to be fitted may be entered. The button right to the entry field opens a file selection dialog for this purpose.
The name of the Function is entered in another field. When in the same directory as for the shared library a module definition file with the same name but the extension .def is present, the function may be chosen from a list in the dialog Functions, opened with the button right to the entry field.
With the button Edit a dialog Parameter may be opened, which allows to enter the values 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 option Show Function Source is activated in the Options menu and a C language source file with the same name as the shared library but the extension .c is present in the same directory, its contents is displayed right to the parameter fields, too. The button Load opens a file selection dialog for loading the parameters from an ASCII file (one parameter each line). The button Save opens a file selection dialog for saving the parameters in an ASCII file.
When the box Nonlinear fit is checked, nonlinear parameter fits by employing the iterative Levenberg-Marquardt method will be performed. Otherwise noniterative general linear least square parameter fits are selected. In this case the function must depend linearly on all parameters chosen to be fitted.
When the box Error column is checked, the corresponding column of the data set, selected in the dialog Array, will be used as the standard deviation of the y values for calculation of chi-square. Otherwise the standard deviation will be estimated by an error model function taking the y value as its argument. This function and their parameters may be selected in a dialog which is displayed by clicking Model. A simple error model might be selected by choosing a polynomial with p1 = 0.01, resulting in standard deviations of 1 %.
Termination of the iterative nonlinear parameter fit algorithm may be controlled by setting a Maximum iterations number and a Tolerance value. Fitting will be terminated when either the maximum number of iterations is reached or the relative errors of chi-square or of the parameters have decreased downto the tolerance value.
Markers (Symbol <= 0) or lines (Symbol > 0) may be chosen to present the fitted function. This is done most convenient using the dialog Lines and Markers, to be opened with the button right to the spinbutton, which shows the actual line or marker.
The Color of lines or markers may be chosen using the dialog Select Color, opened with the colored button.
When Show dialog is active, the dialog Parameter fit is shown when performing the fit, allowing monitoring and interaction.
The resulting parameter settings will be saved automatically on disk, when the option Save parameters is active. The filename is derived from the name of the data file. The extension is set to .par.
When Follow parameters is active, the set of initial parameters will not be reset before starting a fit to the next data set of a series of data files.
The dialog may be canceled without saving by use of the button Cancel. With OK changes are saved and the dialog is closed.
Next Previous Table of Contents