# Settings and Logs

## Shortcuts

You can create custom shortcut keys to make working in &kst; more efficient. To modify the shortcut keys, select Settings Configure Shortcuts.... The following dialog will be displayed.

Configure Shortcuts Window
Configure Shortcuts Window

A list of available actions and their associated shortcuts are shown in the dialog. Each action is allowed two shortcuts—a primary shortcut and an alternate shortcut. Either shortcut can be used at any time. To define or change a shortcut for an action, simply highlight the appropriate row in the shortcut list. Under Shortcut for Selected Action, there are three choices:

None

  Select this option to disable any shortcut keys for the selected action.

Default

  Select this option to use the default shortcut key(s) for the selected action. Note that not all actions have default shortcuts defined.

Custom

  Select this option to define a custom shortcut for the selected action.

If you select the Custom option, double click on a shortcut, or press the key-shaped button then the Define Shortcut dialog will appear.

Define Shortcut Window
Define Shortcut Window

To define a key combination, select Primary or Alternate. If you wish to define a key sequence, check the Multi-key option. Now enter the key combination or sequence to be used for this action. Click OK when you are done.

The action associated with a multi-key shortcut is performed as soon as only one action matches the keys pressed so far. For example, if a multi-key shortcut of ABC is defined, and no other multi-key shortcuts are defined, the action associated with the shortcut will be performed as soon as A is pressed.

## Global Settings

&kst;'s global settings can be accessed by selecting the Settings Configure &kst;.... The following dialog will be displayed.

&kst; Settings Window
&kst; Settings Window

There are three available tabs. General, Data Sources, and E-Mail.

### General

The "General tab" contains most of &kst;'s global settings.

Plot update timer:

  The period of &kst;'s updates. These will check, for example, for changes in the data files associated with curves and update the plots accordingly.

Base font size:

  The base font size for newly created plots.

Minimum font size:

  The smallest font size which will be allowed in newly created plots (even if they are squeezed for space).

Default plot colors:

  The default foreground and background colours for plots.

Curve color sequence:

  The colours to cycle through as new curves are added to a plot. This should have high contrast so that the curves can be differentiated easily.

Default Plot Grid Lines

  See the Colour and Line Weights section for Plots.

Default X Axis

  See the X/Y Axis Scale section for Plots.

Default Line Weight

  See the Colour and Line Weights section for Plots.

Offset from UTC: / Timezone:

  This allows &kst; to calculate the local time for data given in UTC.

Prompt before closing windows

  &kst; will require confirmation before closing a window (and deleting the plots which it contains!).

Show QuickStart dialog on startup

  Enable if you would like the QuickStart Dialog (see Getting Started - Importing Data for a screenshot) to appear every time &kst; starts up.

Apply tied zoom globally

  If this setting is enabled, tied zoom is applied to all windows, rather than just the current one.

### Data Sources

This pane allows you to choose the default options for &kst;'s data sources. An explanation of the options available for the set of data sources included with &kst; can be found in the Data Sources documentation.

### E-Mail

&kst; can send e-mails for debugging and logging purposes. In this tab, you give &kst; the settings for the SMTP server which you would like to use to send mail.

&kst; Settings Window
&kst; Settings Window

## The Debug Dialog

The Debug Dialog contains the &kst; message log, and information about loaded data sources. To access the debug dialog, select Help Debug &kst;...

&kst; Debug Dialog
&kst; Debug Dialog

The Build Information tab contains the &kst; version number. The Data Sources tab contains a list of the data sources loaded in &kst; and the files which they are being used to read. The Log tab contains a list of messages which &kst; has recorded, and can be useful for debugging. If an error message has been posted, but not read, then &kst; will notify you by placing an excited stop sign in the lower right corner of the main window.

Error notifier
Error notifier

The following lists the different messages that can appear in the debug log, with brief explanations and suggested actions (where appropriate).

Type | Message | Explanation/Suggested Action
--- | --- | ---
Unknown | Kst Extension %1 loaded | None.
Unknown | Error trying to load Kst extension %1. Code=%2, \"%3\" | Make sure extension exists, meets the requirements for a &kst; extension, and is in the correct location.
Unknown | Unable to find required vector [%1] for data object %2. | Ensure the indicated vector exists in the Data Manager. If so, try recreating the data object.
Unknown | Unable to find required scalar [%1] for data object %2. | Ensure that the indicated scalar exists (try searching in View Scalars of the Data menu.
Unknown | Error loading data-source plugin [%1]: %2 | A datasource reader (&kde; plugin) could not be loaded. Make sure the data-source reader meets requirements described in Creating Datasource Readers and is compiled correctly. If it is a built-in datasource reader, try recompiling and installing it again from the source package.
Unknown | Scanning for data-source plugins. | &kst; is scanning for datasource readers. No action required.
Unknown | No data in file %1 | Make sure file is supported by one of the datasource readers, and that the data is formatted correctly and is not corrupt.
Unknown | Unsupported element %1 in file %2 | Ensure that the file is not corrupt, and meets the specifications for the file format.
Unknown | Unable to find X vector for %2: [%1] | ???
Unknown | Unable to find Y vector for %2: [%1] | ???
Unknown | Undefined justification %1 in label \"%2\" | This should not happen. Most likely it is the result of a bug.
Unknown | Internal error: No X scale type checked in %1. | None.
Unknown | Internal error: No Y scale type checked in %1. | None.
Unknown | Unable to load plugin %1 for \"%2\" | Make sure that the plugin meets the requirements described in Creating Additional Plugins. In particular, make sure the shared object and `*.xml` file are in the same directory. If the plugin is a built-in plugin, try re-installing the plugin from the source package.
Unknown | Input vector [%1] for plugin %2 not found. Unable to continue. | Ensure that the `*.xml` file for the plugin specifies all the inputs correctly and in the correct order. Check the source code for the shared object to ensure that it is using the correct arrays from the input array. Also ensure that the specified input vector still exists (check in the Data Manager).
Unknown | Output vector [%1] for plugin %2 not found. Unable to continue. | Ensure that the `*.xml` file for the plugin specifies all the outputs correctly and in the correct order. Check the source code for the shared object to ensure that it is outputting the correct arrays in the output array.
Unknown | Data file for vector %1 was not opened. | ???
Unknown | Error parsing XML file %1; skipping. | Check the XML file to make sure it has correct syntax and form for the intended use. If is an XML file for a plugin, check Creating Additional Plugins for more information.
Unknown | Detected disappearance of %1. | None.
Unknown | Could not parse xml file %1. | Check the XML file to make sure it has correct syntax and form for the intended use. If is an XML file for a plugin, check Creating Additional Plugins for more information.
Unknown | Could not find library %1 while loading plugin. | Make sure the library exists and is in the correct location. If this is a built-in plugin, try recompiling and installing the plugin again.
Unknown | Could not find symbol %1 in plugin %2. | A required C symbol could not be found in the plugin. Make sure the plugin meets the requirements described in Creating Additional Plugins. If this is a built-in plugin, try recompiling and re-installing the plugin.
Unknown | The %1 font was not found and was replaced by the %2 font; as a result, some labels may not display correctly." | If this causes problems, install the missing font.