Konfiguration

<note tip>Die Konfigurierbarkeit betrifft aktuell (2012-01) lediglich die GUI. Und auch hier existieren erst Anfänge, die aber zügig ausgebaut werden.</note>

Das Wichtigste in Stichworten:

• Alle Konfigurationsdateien befinden sich in einem zentralen Verzeichnis.
• Die Konfigurationsdateien folgen im Wesentlichen dem von Windows-INI-Dateien bekannten Schema.
• Die Archive der Toolbox enthalten lediglich Beispieldateien für die Konfiguration (die gleichzeitig der Dokumentation der Konfigurationsdateien dienen). Für die reale Konfiguration muß der Nutzer selbst aus diesen Dateien eine Konfigurationsdatei anlegen (s.u.). Das verhindert gleichzeitig, daß Updates alte Konfigurationen überschreiben.

Da die Konfiguration momentan ausschließlich die GUI betrifft, befinden sich die Konfigurationsdateien in einem Unterverzeichnis der GUI-Funktionen:

$TOOLBOXDIR/GUI/private/conf

Dabei ist $TOOLBOXDIR das Wurzelverzeichnis der Toolbox, also dasjenige Verzeichnis, in das die Toolbox installiert wurde.

Um automatisch einen Satz gültiger Konfigurationsdateien aus den mitgelieferten Dateien (.ini.dist) zu erzeugen, sowie auf Dauer ebenfalls für weitere Aufgaben bezüglich der Konfiguration der Toolbox gibt es eine Funktion:

TAconf

Ohne Argumente aufgerufen ruft sie ihre zugehörige Hilfe auf. Momentan (2011-12) gibt es nur eine einzige „Aktion“:

TAconf('create');

Dieser Aufruf erzeugt aus den mitgelieferten .dist.ini-Dateien gültige Konfigurationsdateien, allerdings nur dann, wenn nicht bereits gültige Konfigurationsdateien vorliegen. Es wird also keine Konfiguration überschrieben.

Eine komfortable und weitere Funktionen bereitstellende Möglichkeit ist das Panel „Configuration“ im Hauptfenster der GUI. Von dort aus können sowohl einzelne Konfigurationsdateien direkt (im MATLAB®-Editor) editiert als auch alle oder einzelne erzeugt bzw. zurückgesetzt werden.

Nachfolgend Beispiele für Konfigurationsdateien.

Zur Beachtung: Die Konfigurationsdateien befinden sich noch stark in der Entwicklung.

Gezeigt ist hier nicht die eigentliche Konfigurationsdatei, sondern die kommentierte Variante (TAgui.ini.dist), wie sie mitgeliefert wird. Diese Datei dient gleichzeitig der Dokumentation. Wie daraus eine gültige Konfigurationsdatei erzeugt wird, ist weiter oben beschrieben.

% Sample configuration file for the TAgui function of the TA toolbox
%
% (c) 2011, Till Biskup <till@till-biskup.de>
%
% This file serves as an example and documentation for the real
% configuration in the file "TAgui.ini" in the same directory.
%
% To automatically generate a valid config file from this file, 
% use TAconf('create') at the MATLAB(r) command line.
% Alternatively, you may use the functions provided by the "Configuration" 
% panel of the GUI.
 
% Configuration for the load panel
%
% The first lines, "combine/loaddir/POC/BGC/labels", are switches setting
% the respective checkboxes of the load panel.
% The "format" field controls which file format gets selected. For a list
% of available formats see the file "TAload.ini" in the same directory as
% the TAload function. The string of interest is the string in the field
% "name" of the respective file format.
% The file formats (that are displayed in the popupmenu) are automatically
% read from TAload.ini as well.
[load]
combine = 0
loaddir = 0
AVG = 0
POC = 0
BGC = 0
labels = 1
format = EP LP920 ASCII
 
% Configuration for the measure panel
[measure]
setslider = 1
 
% Configuration for the display panel
[display]
axislimitsauto = 1
gridzero = 1
gridx = 0
gridy = 0
gridminor = 0
legend = none
normalise = none
highlightactive = 1
export1Dincludeaxis = 1
display3DoffsetAuto = 1
thresholdMin = 0
thresholdMax = 0
 
% Configuration for the configuration panel
[configuration]
overwriteLocal = 0