.. _output:

.. index:: Выдачи результатов расчёта

==============================
Результаты моделирования
==============================

Задать выдачи результатов моделирования можно в дереве вкладки **Параметры модели**.

.. var_dialog_output:
.. figure:: pictures\\variant_dialog_output.png
            :align: center
            :scale: 80%

            Красным выделен диалог для задания выдач

Информацию, получаемая в результате расчета модели, может быть сохранена в виде:

  * :ref:`Водный баланс<water_budget_out>`;
  * :ref:`Изоповерхности/изообъемы <iso_out>`;
  * :ref:`2D карты <surfer_out>` (карты величин по слоям в формате «GRD»);
  * :ref:`Точечные карты <scatter_out>` (наборы точек со значениями величин по слоям);
  * :ref:`Записи основных величин<cp_out>` (значения величин по всей модели);
  * :ref:`Траектории<path_out>` (траектории и линии тока от заданных точек).  
   
Тип выдач представлен в таблице ниже.

========================== ====================================================
Выдача                     Тип
========================== ====================================================
Водный баланс              текст. файл, экран, двоичн. файл БД
Изоповерхности             :ref:`двоичн. файл БД<BD>` 
2D карты                   текст. файл
Точечные карты             текст. файл
Записи основных величин    двоичн. файл БД
Траектории                 двоичн. файл БД
========================== ====================================================

.. note::
    Дополнительно для выдач могут быть заданы:
      
       * Наблюдательные скважины - для накопления изменения величины в точке.
       * Балансовые зоны - для детализации водного баланса внутри заданного объема.

.. _water_budget_out:
    
--------------------------------
Водный баланс
--------------------------------

Выдачи водного баланса задаются во вкладке **Водный баланс**.
Данный вид выдач используется для оценки того, как распределены входящие и выходящие потоки
массы (воды) в модели.

.. figure:: pictures\\variant_output_water_balance.png
            :align: center
            :scale: 80%

            Задание выдач водного баланса

* **Записывать водный баланс в текстовый файл(дополнительно)** - выдавать баланс системы в текстовый файл 
  (по умолчанию запись производится только в двоичную файловую базу данных);            
* **Выдавать водный баланс на экран** - выводить водный баланс 
  на экран в процессе счета (в конце стресс-периода);
  
  .. index:: Детализация водного баланса
  
* **Детализация баланса по рекам и водоемам** - выдавать в текстовый файл 
  детализацию по балансу в реках и водоемах;
* **Число знаков после запятой** - для выдач в текстовый файл и на экран 
  можно также отрегулировать отображение вещественной части, задав нужное число знаков
  после запятой (по умолчанию 2).
  
.. * **Записывать баланс в м3/сут** - выдавать баланс с заданной размерностью.
..  (Применимо в задачах с постоянной плотностью жидкости. 
..   В противном случае выдачи производятся в кг/сут (массовые).) 
 
.. _iso_out:

-------------------------------
Изоповерхности/изобъемы
-------------------------------

Выдачи 3D изоповерхностей величин задаются во вкладке **Изоповерхности/изобъемы**:

.. figure:: pictures\\variant_output_isosurface.png
            :align: center
            :scale: 80%

            Задание выдач изоповерхностей


Производятся выдачи наборов координат, нормалей треугольных граней 
изоповерхностей/изобъемов и привязки к значению. 
Как правило данный вид выдач используется 
для последующего создания видео или визуализации ореолов загрязнения.
Для задания данного вида выдач можно дополнительно указать:

 * число изоповерхностей величин;
 * значение величин.

Данный тип выдач можно заказать для следующих величин:

 * «Напор»;             
 * «Давление»;
 * «Концентрация»;
 * «Водонасыщенность».

Чтобы получить выдачу «Изоповерхности» для конкретной величины (например «Напора»)
необходимо в дереве поставить галочку напротив соответствующей величин.  
 
В диалоге «Режим выдачи» в опции **Выдавать по времени или числу выдач** можно задать условие, 
по которому данный тип выдач будет производиться:

  * «Нет» - не производить выдачу;
  * «В заданные времена» - указать массив определенных моментов времени; 
  * «Через интервал времени» - например, с заданием
    «величины временного интервала» через 365.25 [сут];
  * «Количество выдач» - все время задачи бьется на заданное число времен, в которые будет производиться выдача.
  
Чтобы в конце стресс-периода была произведена запись данных, 
необходимо установить галочку в поле **Сохранять в конце стресс-периода**.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Дополнительные параметры
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Для задания данного вида выдач в диалоге «Дополнительные параметры» можно дополнительно указать:

 * **Тип** - каким образом строить изоповерхности
   
   *   «Число изоповерхностей величины» - изоповерхности строятся в интервале минимума и 
       максимума величины, разбитым на заданное число;
   *   «Значения величины» - изоповерхности строятся для конкретных значений величины.
   
 * **Число изоповерхностей величины** - отображается в случае выбора 
   «Число изоповерхностей величины» в поле **Тип**;
 * Таблица **Значений величины** - отображается в случае выбора «Значения величины»
   в поле **Тип**.
 
.. _surfer_out:

-------------------------------
2D карты
-------------------------------

Выдачи карт по слоям задаются во вкладке **2D Карты**:

.. figure:: pictures\\variant_output_surfer.png
            :align: center
            :scale: 80%

            Задание выдач карт

Производятся выдачи величин по ячейкам модельных слоев, интерполированных на 
регулярную сетку методом «Nearest Neighbour». 
Данный вид выдач используется для 
быстрой в сторонних программных средствах.
 
Данный тип выдач можно заказать для следующих величин:

 * «Напор»;             
 * «Давление»;
 * «Концентрация»;
 * «Водонасыщенность»;
 * «А.О. водного столба».
 
Чтобы получить выдачу «2D карты» для конкретной величины (например «Напора»)
необходимо в дереве поставить галочку напротив соответствующей величин.  
 
В диалоге «Режим выдачи» в опции **Выдавать по времени или числу выдач** можно задать условие, 
по которому данный тип выдач будет производиться:

  * «Нет» - не производить выдачу;
  * «В заданные времена» - указать массив определенных моментов времени; 
  * «Через интервал времени» - например, с заданием
    «величины временного интервала» через 365.25 [сут];
  * «Количество выдач» - все время задачи бьется на заданное число времен, в которые будет производиться выдача.
  
Чтобы в конце стресс-периода была произведена запись данных, 
необходимо установить галочку в поле **Сохранять в конце стресс-периода**.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Дополнительные параметры
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Для данного вида выдач в диалоге «Дополнительные параметры» можно дополнительно указать:

 * **Разбиение по X,Y** - каким образом строить изоповерхности;
   
   *   «Число строк, колонок» - регулярная сетка строится по двумерным габаритам области, 
       разбитым на заданные числа строк и колонок;
   *   «Шаг по X и Y» - регулярная сетка строится по двумерным габаритам области с заданным
       шагом разбиения пространства.
   
 * **Число колонн** - отображается в случае выбора «Число строк, колонок» в поле **Разбиение по X,Y**;
 * **Число строк** - отображается в случае выбора «Число строк, колонок» в поле **Разбиение по X,Y**;
 * **Шаг** - отображается в случае выбора «Шаг по X и Y» в поле **Разбиение по X,Y**.
 
.. _scatter_out:
    
--------------------------------
Точечные карты
--------------------------------

Точечные выдачи по слоям задаются во вкладке **Точечные карты**.

.. figure:: pictures\\variant_output_scatter_point.png
            :align: center
            :scale: 80%

            Задание точечных выдач по слоям



Выдачи значений заданных величин модельных слоев производятся 
в точках с координатами *(x, y, z)* центров ячеек. 
Данный вид выдач используется для построения двумерных карт.

Данный тип выдач можно заказать для следующих величин:

 * «Напор»             
 * «Давление»
 * «Концентрация»
 * «Водонасыщенность»
 * «А.О. водного столба»

Чтобы получить выдачу «Точечные карты» для конкретной величины (например «Напора»),
необходимо в дереве поставить галочку напротив соответствующей величин.  
 
В диалоге «Режим выдачи» в опции **Выдавать по времени или числу выдач** можно задать условие, 
по которому данный тип выдач будет производиться:

  * «Нет» - не производить выдачу;
  * «В заданные времена» - указать массив определенных моментов времени; 
  * «Через интервал времени» - например, с заданием
    «величины временного интервала» через 365.25 [сут];
  * «Количество выдач» - все время задачи бьется на заданное число времен, в которые будет производиться выдача.
  
Чтобы в конце стресс-периода была произведена запись данных, 
необходимо установить галочку в поле **Сохранять в конце стресс-периода**.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Дополнительные параметры
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Для данного вида выдач в диалоге «Дополнительные параметры» можно дополнительно указать:

 * **Сохранить полную карту** - сохранение двумерной карты;
 * **Число знаков после запятой** - данное число будет использоваться
   при записи вещественных чисел в текстовый файл.

.. note::
  Для концентрации в диалоге «Дополнительные параметры» присутствует дополнительная
  опция:
  
    * **Записывать максимальную по пластам** - дополнительно при выборе такой опции
      будет записываться максимальная концентрация    

.. _cp_out:

-------------------------------
Записи основных величин
-------------------------------

Выдачи основных искомых величин в задаче задаются во вкладке **Записи основных величин**:

.. figure:: pictures\\variant_output_control_point.png
            :align: center
            :scale: 80%

            Задание выдач контрольных точек
            
            
Производятся выдачи указанных величин для соответствующего процесса по ячейкам всех модельных слоев.           
Данный вид выдач используется для последующей 2D и 3D визуализаций и 
дополнительных функций постобработки.

Таблица доступных величин для записи представлена ниже

===================== ============= ====================
Фильтрация            Миграция      Поверхностный сток
===================== ============= ====================
Напор                 Концентрация  А.О. водного столба
Давление
Водонасыщенность
А.О. водного столба
===================== ============= ====================

Чтобы получить выдачу **Записи основных величин** для конкретного процесса (например «Фильтрация»)
необходимо в дереве выбрать соответствующий процесс в элементе **Записи основных величин**. После нажатия на название процесса
будет открыт диалог «Записи, фильтрация», в котором надо поставить галочки
напротив нужных величин. 

В диалоге «Режим выдачи» в опции **Выдавать по времени или числу выдач** можно задать условие, 
по которому данный тип выдач будет производиться:

  * «Нет» - не производить выдачу;
  * «В заданные времена» - указать массив определенных моментов времени; 
  * «Через интервал времени» - например, с заданием
    «величины временного интервала» через 365.25 [сут];
  * «Количество выдач» - все время задачи бьется на заданное число времен, в которые будет производиться выдача.
  
Чтобы в конце стресс-периода была произведена запись данных, 
необходимо установить галочку в поле **Сохранять в конце стресс-периода**.

.. _path_out:
    
--------------------------------
Траектории
--------------------------------

Параметры расчета траекторий задаются во вкладке **Траектории**.
Данный вид выдач используется для визуальной оценки того, как выглядят траектории течения загрязнения в модели.
Опции, заданные в данной вкладке распространяются на все частицы, заданные в :ref:`2D редакторе<views>`.

.. figure:: pictures\\trajectory.png
            :align: center
            :scale: 80%

            Задание траекторий

* **Макс время полета частицы** - время в течении которого расчитывается полет частицы;            
* **Сохранять в конце стресс-периода** - производить ли выдачи траекторий.

.. attention:: Для расчета траекторий необходимо задание пористости, которая необходима для вычисления скорости фильтрации.
