Summarize
=========

The application, as depicted in the :ref:`Figure below <Summary Application Principle>`,
efficiently summarizes text linked to a Data within `Geoscience ANALYST`_.
It operates by aggregating all associated text into a comprehensive document.
This unified text is then processed to create a concise summary.

.. image:: ../images/summary_principle.svg
    :name: Summary Application Principle
    :align: center

An option also allows users to pass a question to the language model. Then, as presented on the :ref:`Figure below <Ask Application Principle>`, the model performs a mechanism similar to the one used for summarization, but instead of generating a summary, it provides an answer to the question based on the text data.

.. image:: ../images/ask_principle.svg
    :name: Ask Application Principle
    :align: center

The resulting summary or answer is conveniently provided as a text file in `Geoscience ANALYST`_,
directly linked to the corresponding data object.

.. _Geoscience ANALYST: https://www.mirageoscience.com/mining-industry-software/geoscience-analyst/

Interface
---------

You can run the application using the interface depicted in :ref:`Figure below <Summary Interface>`.

.. image:: ../images/summary_uijson.png
    :name: Summary Interface
    :align: center

The interface contains the following parameters:

* **Drillhole data**: The drillhole group and the associated text data to summarize.
* **Object**: The object containing the text data to summarize.
* **Data**: The text data to summarize.
* **Language model**: The language model to use for summarization. The available models are listed in the `Models Available <../index.rst>`_ table.
* **Output name**: The name of the output file.
* **Question** (optional): The question to answer. When provided, the application operates in "ask" mode, answering the question based on the text data instead of generating a summary.

* **OK**: Clicking "OK" runs the application with the specified parameters.

Advanced parameters
~~~~~~~~~~~~~~~~~~~

.. image:: ../images/summary_uijson_optional.png
    :name: Summary Interface Optional
    :align: center

* **Context** (optional): The context to use for the summarization. It can be used to provide additional information to the model.

The application opens a console displaying the progress of the summarization or question-answering process.
Upon completion, the summary or answer is made available as a ``.txt`` file within the `Geoscience ANALYST`_ project.

Results
-------

The summary or answer can be viewed in Geoscience ANALYST, as illustrated in the :ref:`figure below <Summary Result>`. The output is attached to the object selected in the application (**1.** ``DrillholeData`` or ``Object`` in the :ref:`Interface <Summary Interface>`), under the Files section (**2.**). Simply double-click on the file to open it and access the summary or answer (**3.**).

.. image:: ../images/result_summary.svg
    :name: Summary Result
    :align: center