Configuration ------------- Since version 2.5, there is no further installation required for Windows. Just download the archive, extract it and launch the :file:`UncertRadio.exe` executable, located in the `/bin` directory. Configuration file: ^^^^^^^^^^^^^^^^^^^ The `UR2_cfg.dat` file found in the `/share/UncertRadio` directory is copied at first start to the users local data directory. The location of the config file depends on the operating system: - On **Linux**, it is stored in :file:`~/.config/UncertRadio/UR2_cfg.dat` (XDG Base Directory). - On **Windows**, it is stored in :file:`%LOCALAPPDATA%\\UncertRadio\\UR2_cfg.dat`. The config file allows some simple adjustments: +----------------------------+--------------------------------------+ || UncertRadio configuration || Explanation | || keyword || | +============================+======================================+ | [Path] | path section indicator | +----------------------------+--------------------------------------+ || log_path= || contains all log_files, needs to be | || || writable, can be 'current' for the | || || current work directory (linux) or | || || the path to the UR binary (windows) | +----------------------------+--------------------------------------+ || results_path= || contains all results_files, | || || must be writable & can be 'current' | +----------------------------+--------------------------------------+ | [Local] | Localisation settings | +----------------------------+--------------------------------------+ || Decimal_point= || set the desired decimal point | || || (possible values: ",", ".") | +----------------------------+--------------------------------------+ || List_separator=; || The character of the list separator | || || in csv files | || || (possible values: ";", ":") | +----------------------------+--------------------------------------+ || Language=DE || Language of UncertRadio | || || (possible values: DE, EN, FR) | +----------------------------+--------------------------------------+ || ContrastMode=F || The contrast mode can be activated | || || (possible values: F, T) | +----------------------------+--------------------------------------+ Log and results files ^^^^^^^^^^^^^^^^^^^^^ The paths for log files and results files are specified in the config file under [Path] as :file:`log_path` and :file:`results_path`. If these entries are left empty, default locations are used depending on the operating system: - On **Linux**, the default locations are: - Log files: :file:`~/.local/state/UncertRadio/logs/` - Results files: :file:`~/.local/share/UncertRadio/results/` - On **Windows**, the default locations are: - Log files: :file:`%LOCALAPPDATA%\\UncertRadio\\logs\\` - Results files: :file:`%LOCALAPPDATA%\\UncertRadio\\results\\` The special value ``current`` can be used for either path to store the files in the current working directory (e.g., ``log_path=current``). Country specific parameters +++++++++++++++++++++++++++ The parameters found in the configuration file :file:`UR2_cfg.dat` under the item [Local] may be defined as follows. a) one may omit the parameter values following the "=" character: Decimal_point= List_separator= Language= From this, the values for the decimal point character and the list separator character (for CSV files) are selected: DE or FR: comma as decimal point; semicolon as list separator character EN: point as decimal point; comma as list separator character note: The language which can be selected in the main menu - Options is only temporarily used, i.e., only within the actual program run. b) If other specifications are desired, their parameter values can be inserted directly after the "="-sign in the configuration file. It may be sufficient to insert explicitly only the desired list separator character: List_separator=; c) The language can also be selected in the dialog of the menu item "Options – Pre-settings" after the program has already been started (but only temporarily; see above). From the language defined there, the characters for decimal point and list separator are determined in the way as described above under a). Additionally, the list separator character can there be selected there explicitly. d) For a graphical presentation the decimal point character is determined by the language shortcut DE, EN or FR Choosing the language +++++++++++++++++++++ The **user** of UncertRadio can be **guided** by the program through its various dialogs **in the three language**. The user can choose between German, English and French. This is controlled via the entry 'language=' in the above-mentioned configuration file :file:`UR2_cfg.dat`, which is read at every program start. The parameter values are: - DE for German, - EN for English, - FR for French. The language can be switched within the running program with using the dialog "Menu – Options – Pre-settings". Since **Version 2.3.07,** this **includes also** **those "GTK stock buttons"**, labelled by an icon and text, which previously were translated only after a new program start. This has been achieved by converting all "stock buttons" into normal buttons; the form of the button icons changed, but only slightly. For the more complex GTK file chooser dialog, most items are translated, but not all. Font and fontsize ^^^^^^^^^^^^^^^^^ UR allows to change the font type and size. The settings are stored in the :file:`Settings.ini` file: .. code-block:: ini :emphasize-lines: 3 :name: settings.ini_ref [Settings] gtk-theme-name=Adwaita gtk-icon-theme-name=Adwaita gtk-font-name=Segoe UI, Adwaita Sans, Sans 11 Note that the strings to the left of the = characters must not be modified. On starting the UR program the :file:`Settings.ini` file is loaded. This file shall be part of the UncertRadio.exe path. Linking project files (.txp) to UncertRadio.exe ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Linking the file type .txp to ``UncertRadio.exe``, can be established as follows in Windows: - highlight a txp file, click by the left mouse button "open with" and select "other app" - set the check mark and click on "further Apps" - scroll down the list of recommended applications - click on "search another App on this PC" - select the Uncertradio.exe With the next double click on the txp filename the program should start successfully. Excel-controlled processing of UncertRadio ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. note:: **Platform compatibility**: The Excel batch mode described in this section is **Windows-only**. It requires **Microsoft Excel** (32-bit or 64-bit) and uses Windows-specific VBA APIs. **LibreOffice Calc and other spreadsheet applications are not supported**. The Excel file is provided as an example to demonstrate the possibility of batch processing, not as a required component for using UncertRadio. The Excel file :file:`UR2_SingleAutoRun_V12.xlsm` has changed compared to that file used by the previous version by extending the filenames to always include the complete path. A further evaluation button "Start (autosep)" was added; see :numref:`batch mode processing with an excel application`. The Excel file can be used in the 32-bit as well as the 64-bit versions of MS Office/Excel; see the notes in the introduction part of the VBA module (Modul_Auto_single_UR) within the Excel file. The VBA module of the Excel file now interprets an UncertRadio exit code which has been introduced with version 2.2.03. An exit code equal to 3 (error occurred during the UncertRadio run) leads to an abortion of the running VBA module.