Settings
========

*Settings* is a dialogue in which you can specify how
:doc:`DEXi <DEXi>` handles reports, external files and other advanced
features. For this purpose, it provides three pages: :ref:`Report <DEXiIntSett_rpt>`,
:ref:`Import/Export <DEXiIntSett_iex>` and :ref:`Advanced <DEXiIntSett_adv>`. The selected settings
apply to the current DEXi model and are saved on the corresponding :doc:`DEXi
file <DEXiIntFile>`.

.. _DEXiIntSett_rpt:

Report Page
-----------

Use this page to specify various aspects of
:doc:`report <DEXiIntReport>` formatting.

**Each section on new page**: When checked, each report
:ref:`element <DEXiIntReport_elm>` is strictly started on a new page.
Otherwise, multiple elements may appear on a single page.

**Bad values** and **Good values**: Use these controls to specify the
appearance of 'bad' and 'good' :doc:`scale <DEXiGlosScale>` values.

**Functions**: These controls specify the display of :doc:`utility
functions <DEXiGlosFunct>`:

-  *weights*: specifies whether :doc:`weights <DEXiGlosWei>` are
   displayed or not;
-  *rule numbers*: include or exclude row numbers;
-  *complex rules*: when checked, represent the function with :doc:`complex
   rules <DEXiGlosComplex>`, otherwise use elementary rules;
-  *entered rules only*: when checked, display only rules entered by the
   user, otherwise also show :doc:`non-entered rules <DEXiGlosNonEnt>`.

**Weights**: These controls specify the display of
:doc:`weights <DEXiGlosWei>`. Use these controls to specify the number
of decimal places and to select individual :ref:`weight
types <DEXiGlosWei_rpt>`.

**Evaluation**: These controls specify the display of
:doc:`evaluation <DEXiGlosEval>` results:

-  *Number of columns* refers to the number of options shown together on
   the right hand side of the 'Evaluation results' :ref:`report
   element <DEXiIntReport_elm>`.
-  *Trim characters* specifies the maximum number of characters that can
   be used to display option values in this report element [the shorter
   the strings, the more options can be displayed together].

**Reports in html**: When checked, all reports are prepared in html and
shown in a browser, without activating the standard
:doc:`preview <DEXiIntPreview>`.

**Use default system browser**: When checked, html reports are shown
using the default system browser, that is, externally from DEXi. In this
case, DEXi writes html files to the temporary system folder. Otherwise,
a :doc:`browser <DEXiIntBrowser>` (based on Internet Explorer) is
invoked internally, without writing files to disk.

.. _DEXiIntSett_iex:

Import/Export Page
------------------

This Settings page specifies the format of external data files. which
are imported and exported through :doc:`File Menu <DEXiIntMenuFile>`
commands.

**Option data format**: These controls specify the format and contents
of imported and exported :doc:`option data files <DEXiIntOptFile>`.

-  *Option values*: specifies the format of values, which can be either
   *text* strings or ordinal numbers starting at 0 (*base 0*) or 1
   (*base 1*).
-  *Attributes*: import/export the values of *all* or only *basic*
   :doc:`attributes <DEXiGlosAttr>`.
-  *Orientation* specifies whether data file rows correspond to
   attributes (*normal*) or options (*transposed*).
-  *Indent* specifies whether attribute names are *indent*\ ed or *not*.
   Indentation adds whitespace to outline the
   :doc:`tree <DEXiGlosTree>` structure of attributes.

**Function data format**: These controls specify the format and contents
of exported :doc:`function data files <DEXiIntFunctFile>`.

-  *Attribute values*: specifies the format of attribute values, which
   can be either *text* strings or ordinal numbers starting at 0 (*base
   0*) or 1 (*base 1*).
-  *Rules*: export *all* or only *entered* decision rules.
-  *Interval format* specifies the format of function values, which are
   in general :doc:`intervals <DEXiGlosIntervals>`. Possible formats
   are:

   -  *from:to*,
   -  *from* and *to* separated by the TAB character, or
   -  using interval symbols '\*', '>=', '<=' and ':'.

.. _DEXiIntSett_adv:

Advanced Page
-------------

This page contains three controls:

**Link equal attributes**: specifies whether DEXi performs automatic
:doc:`linking of attributes <DEXiGlosLink>` or not.

**Undo/Redo**: to activate or deactivate the Undo/Redo functionality
when editing models, options and utility functions.

**Report: Show function status**: specifies whether or not the "Function
summary" :doc:`report <DEXiIntReport>` element displays the status of
:doc:`utility functions <DEXiGlosFunct>` in terms of their consistency
and settings related to the handling :doc:`non-entered function
values <DEXiGlosNonEnt>`. Status is composed of two characters.
The first character is either 'o' or 'x', indicating a consistent or
inconsistent function, respectively. An upper-case first character ('O'
or 'X') indicates that :ref:`'Use scale orders' <DEXiGlosNonEnt_scl>`
strategy is in effect. The second character is 'W' or 'w', depending on
whether the :ref:`'Use weights' <DEXiGlosNonEnt_wei>` strategy is in
effect or not.

When *Show function status* is on, a more verbose description of
possible problems with individual functions is also added to the display
of each function in the report. The following problems are reported:

-  function is less than 100% determined,
-  function does not map to all values of the dependent variable,
-  function has inconsistent rules,
-  function's variables use decreasing scales (increasing scales are
   advised),
-  some attribute(s) do not influence function value,
-  some attribute values are undistinguishable (as they affect function
   values in the same way).

**Disable model editing**: specifies whether or not it is possible to
edit the model on the DEXi :doc:`Model <DEXiIntTabMod>` tab. When on,
all model editing commands are suppressed. It is possible to open
:doc:`Function Editor <DEXiIntEditFunct>` to view utility functions,
but saving changes is disabled. The editing of options is unaffected by
this control. Disabling model editing is useful to prevent unintentional
changes after the model has been completed.

.. toctree::
  :hidden: