.. _section-Query Results Language Options:

Query Results Language Options
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Query results can also be shown in Flora or English.  The 2 radio buttons to the right of the Table and Tree radio buttons, highlighted in :numref:`figure-QueryResults-FloraEnglish.png`, can be used to choose between these 2 language modes.

.. _figure-QueryResults-FloraEnglish.png:

.. figure:: ../../figs/QueryResults-FloraEnglish.png
   :alt: Use Flora or English radio button to choose between 2 language modes

   Use Flora or English radio button to choose between 2 language modes


By default, query results are presented in Flora.  If English is selected, then results are shown using equivalent expressions defined in the KB such as the label property.  To see an example of this, in the **Text Editor**, modify individual **Anne** to have an additional property label -> "Sweet Pea"^^\\string", as shown in :numref:`figure-QueryResults-label-sweetpea.png`, and save family.flr.

.. _figure-QueryResults-label-sweetpea.png:

.. figure:: ../../figs/QueryResults-label-sweetpea.png
   :alt: Add label -> "Sweet Pea" to **Anne**

   Add label -> "Sweet Pea" to **Anne**

Click **Queries** and execute query ’Who is a mother-in-law?’. One of the results in the returned list is **Anne**.  In the **Query Results** window, select **English** by clicking its radio button.  Instead of **Anne**, the result now shows **Sweet Pea**, as shown in :numref:`figure-QueryResults-sweetpea.png`.  This is because, in **English** mode, individuals are displayed using their equivalent names such as values given to the property label.

.. _figure-QueryResults-sweetpea.png:

.. figure:: ../../figs/QueryResults-sweetpea.png
   :alt: In **English** mode, **"Sweet Pea"** is shown instead of **Anne**

   In **English** mode, **"Sweet Pea"** is shown instead of **Anne**

.. When both the **Display Labels** option and the **Display Generated Labels** option are enabled, auto-generated labels with prefixes removed and camel-casing replaced by spaces are used instead of names for individuals in the query results.

.. If we modify the **Woman** class to have an additional property label -> "Sweet Heart"^^\\string, as shown below, and again save family.flr.

.. .. figure:: ../../figs/QueryResults-label-sweetheart.png
      :alt: Add label -> "Sweet Heart" to **Woman**
 
      Add label -> "Sweet Heart" to **Woman**

.. Rerun the query ’Who is a mother-in-law?’. This time all query results returned are displayed as **"Sweet Heart"**, except **Anne** which is displayed as **"Sweet Pea"**. This is because the label **"Sweet Heart"** is automatically inherited by individuals in the **Woman** class, and the combination of **Display Labels** and **Display Generated Labels** makes use of such auto-generated labels. In the case of **Anne**, since **"Sweet Pea"** is asserted directly as a label to the individual, it takes precedence over any inherited label.

.. In general, **Display Generated Labels** will display results with auto-generated labels only when it is used in conjunction with **Display Labels**. On the other hand, **Display Labels** can be used alone to display query results with directly asserted labels.

.. .. figure:: ../../figs/QueryResults-sweetheart.png
      :alt: **"Sweet Pea"** and **"Sweet Heart"** are shown instead of individual names

      **"Sweet Pea"** and **"Sweet Heart"** are shown instead of individual names

.. The **Round Values** option rounds decimal values and replaces scientific E notations with numbers in query results. The number of rounding places can be specified by selecting **View Options** in the downward pointing triangle menu.

.. Additional options are available under **Windows > Preferences > Sunflower Preferences > Query Results Preferences** for changing the appearance of results displayed in **Qery Results**. See Section :ref:`section-Query Result Preferences` for these options.

.. Also see Section :ref:`section-NL` on how to use manual annotations to help display and explain query results in everyday English.

.. Remove label 'Sweet Pea' from individual Anne, and label 'Sweet Heart from class Woman, then save family.flr before advancing to the next section.