﻿.. include:: RESOURCE.rst

.. _hydro:

.. role:: underline
    :class: underline
    
.. index:: Создание объектов

************************
Создание объектов
************************

В :ref:`2D редакторе<views>` реализованы различные способы создания объектов.
В данном разделе руководства пользователя рассмотрен каждый из этих способов.

.. contents:: Способы создания



..  * :ref:`вручную<creating_manual>`;
..  * :ref:`с помощью специальных инструментов<creating_tool>`;
..  * :ref:`импорт объектов<creating_by_import>`;
..  * :ref:`копирование объектов<copy_objects>`;
..  * :ref:`создание объектов из других объектов<create_from_object>`.
  
.. Подробное описание способов создания будет описано в разделах других.
  

.. _creating_manual:

=================================
Создание объектов «вручную»
=================================

Данный способ создания объектов используется в двух случаях:

  1. когда производится оцифровка объектов по :ref:`фоновой карте<background_property>`;
  2. при создании тестовых моделей и задании тестовых объектов для проведения оценочных расчетов 
     (для отладки моделей).

Режим ручного создания объектов включается командой |creating| 
:ref:`панели управления<control_panel>` 2D редактора. 
После включения режима создания объектов на панели управления 
необходимо выбрать тип создаваемого объекта.   

Создание :ref:`точечных объектов<point_creating>` производится нажатием левой клавиши мыши
в окне :ref:`редактирования геометрии<view_active_window>` 2D редактора.

Создание :ref:`полигонов<poly_creating>` и :ref:`полилиний<poliline_creating>` 
производится по следующему алгоритму:

  #. нажать левой кнопкой мыши в окно редактирования геометрии 2D редактора;
  #. переместить курсор мыши;
  #. снова нажать левой кнопкой мыши в окно редактирования геометрии; 
  #. повторить действия пунктов 1-3 (если это необходимо);
  #. завершить процесс создания полигона (полилинии) 
     :numref:`(Рис. %s)<create_objects_manual_image>` 
     одной из команд контекстного меню:
     
       * «Создать полигон»;
       * «Создать ЗАМКНУТУЮ полилинию»;
       * «Создать ОТКРЫТУЮ полилинию».
       
       .. * «Замкнуть полилинию».
       
.. _create_objects_manual_image:
.. figure:: pictures\\geom_mode\\create_objects_manual.png 
            :align: center
            :scale: 90%

            Создание полигона и полилинии вручную
            

Завершить процесс создания полигона также можно, 
соединив его первую и последнюю вершины.
      
Чтобы отменить создание объекта, нужно воспользоваться командой меню 
«Отменить изменения геометрии» или нажать клавишу «Escape».   


-----------------------
Особые случаи
-----------------------
       
Для создания отрезков накопления профиля заданной величины, 
а также отрезков для моделирования одномерных и профильных задач 
достаточно установить точки их начала и конца.
           
При создании линий бокового ГУ можно использовать две дополнительных
опции меню:
           
  #. «Привязать ГУ по трем узлам» - позволяет создавать ГУ из набора отрезков
     контура области моделирования, заключенных между тремя заданными узлами ГУ 
     (начальный узел, любой внутренний узел, последний узел);
              
  #. «Привязать ГУ по контуру» - при добавлении узла ГУ к полилинии координаты узла пересчитываются 
     к координатам ближайшего узла контура (находится узел контура, 
     который расположен вблизи установленного узла ГУ).
     
===============================     ===============================
Привязка ГУ по трем узлам           Привязка ГУ по контуру
===============================     ===============================
|BC_by_points_1|                     |BC_by_contour_1| 

|BC_by_points_2|                     |BC_by_contour_2|      

|BC_by_points_3|                     |BC_by_contour_3|      
===============================     ===============================


.. _creating_tool:

==================================================================
Создание объектов с помощью инструментов ленты
==================================================================

Для удобства создания объектов в 2D редакторе реализован ряд инструментов. 
Состав инструментов зависит от геометрического типа создаваемых объектов. 
Все инструменты создания расположены в ленте 2D редактора и открываются, 
если на панели управления 2D редактора выбран режим создания объектов |creating|, 
а также указан тип создаваемого объекта. 
 

.. _polygon:

-----------------------
Полигоны
-----------------------
 
На :numref:`(Рис. %s)<create_polygon_tools_image>` представлены инструменты 
создания полигональных объектов в ленте 2D редактора.

.. _create_polygon_tools_image:
.. figure:: pictures\\create_objects_tools\\create_polygon_tools.png 
            :align: center
            :scale: 90%

            Инструменты создания полигональных объектов в ленте 2D редактора

* |load_object| - открыть диалог выбора файла формата :strong:`*.bln` 
  для импорта полигональных объектов. После импорта полигонам будет присвоен тип, 
  который выбран на :ref:`панели управления<control_panel>` 2D редактора 
  в момент вызова диалога импорта. Если в :strong:`*.bln` файле задана геометрия 
  более чем для одного полигона, то пользователю будет предложено автоматически создать группу 
  из этих объектов :numref:`(Рис. %s)<load_objects_from_bln_group_mes_image>`. 
  
  .. _load_objects_from_bln_group_mes_image:
  .. figure:: pictures\\create_objects_tools\\from_bln_group_mes.png 
            :align: center
            :scale: 90%
  
  В случае согласия группе будет присвоено имя, соответствующее имени :strong:`*.bln` 
  файла. Однако, если объекты из :strong:`*.bln` файла были импортированы как объекты типа 
  «Водоем, площадная река» |lake|, то группе будет присвоено имя «Водоемы». 
  Впоследствии пользователь cможет изменить имя группы, используя инструменты 
  :ref:`менеджера групп<manager_group_options>`.
  
                              
.. _polygon_ref:
                              
* |create_rect| - открыть диалог для создания прямоугольника 
  :numref:`(Рис. %s)<create_polygon_by_points_image>`.
  
.. _create_polygon_by_points_image:
.. figure:: pictures\\create_objects_tools\\create_rect_dialog.png
                :align: center
                :scale: 80%

                Диалог для создания прямоугольника
                
                
В диалоге необходимо выбрать «способ создания» прямоугольника:

  1. «По двум точкам» - создать прямоугольник по координатам левой нижней и правой верхней точек;             
  2. «Точка и габариты» - создать прямоугольник по координатам левой нижней точки, а также по значениям  
     длины и высоты прямоугольника.
     
В зависимости от выбранного способа создания прямоугольника в диалоге 
необходимо задать либо координаты двух точек, либо координаты точки, а также высоту и длину прямоугольника. 
Единицы измерения вводимых данных - метры.
                 

* |create_circle| - открыть диалог для создания многоугольника 
  :numref:`(Рис. %s)<create_polygon_by_split_circle_image>`. 

.. _create_polygon_by_split_circle_image:  
.. figure:: pictures\\create_objects_tools\\create_polygon_by_split_circle_dialog.png
                :align: center
                :scale: 90%
                                                                              
                Диалог для создания многоугольника

                
Многоугольник создается путем разбиения окружности на N частей.
В диалоге необходимо задать координаты центра и радиус окружности, а также 
указать количество вершин многоугольника.                 
Единицы измерения вводимых данных - метры.
  


-----------------------
Полилинии
-----------------------  

На :numref:`(Рис. %s)<create_polyline_tools_image>` представлены инструменты 
создания полилиний в ленте 2D редактора.

.. _create_polyline_tools_image:
.. figure:: pictures\\create_objects_tools\\create_polyline_tools.png 
            :align: center
            :scale: 90%

            Инструменты создания полилиний в ленте 2D редактора 

* |load_object| - открыть диалог выбора файла формата :strong:`*.bln` 
  для импорта полилиний. После импорта полилиниям будет присвоен тип, 
  который выбран на :ref:`панели управления<control_panel>` 2D редактора 
  в момент вызова диалога импорта. Если в :strong:`*.bln` файле задана геометрия 
  более чем для одной полилинии, то пользователю будет предложено автоматически создать группу 
  из этих объектов :numref:`(Рис. %s)<load_objects_from_bln_group_mes_image>`. 
  В случае согласия группе будет присвоено имя, соответствующее имени :strong:`*.bln` 
  файла. Однако, если объекты из :strong:`*.bln` файла были импортированы как объекты типа 
  «Сегмент реки» |river_knee| или «Линейный водоем» |poly_river_knee|, то группе будет 
  присвоено имя «Лин. реки» или «Лин. водоемы» соответственно.
  Впоследствии пользователь сможет изменить имя группы, используя инструменты 
  :ref:`менеджера групп<manager_group_options>`.

* |create_polyline| - открыть диалог для создания полилинии 
  :numref:`(Рис. %s)<create_polyline_by_coords_image>`.
  
.. _create_polyline_by_coords_image:
.. figure:: pictures\\create_objects_tools\\create_polyline_dialog.png
                :align: center
                :scale: 80%

                Диалог для создания полилинии      

                
В столбцах «X» и «Y» таблицы диалога необходимо задать координаты вершин полилинии.    

Для полилинии типа «Внутреннее граничное условие» |ic_line| в таблице отображается  
дополнительный столбец «Z» :numref:`(Рис. %s)<create_ic_line_image>`. 
Данный столбец предназначен для задания координаты Z (абсолютной отметки рельефа).       

.. _create_ic_line_image:
.. figure:: pictures\\create_objects_tools\\create_ic_line_dialog.png
                :align: center
                :scale: 80%

                Диалог для создания полилинии типа «Внутреннее граничное условие»  

Для создания полилинии необходимо, чтобы в таблице были заданы координаты 
не менее двух вершин. В противном случае на экране появится информационное сообщение 
:numref:`(Рис. %s)<create_polyline_nodata_image>` и полилиния создана не будет.

.. _create_polyline_nodata_image:
.. figure:: pictures\\create_objects_tools\\create_polyline_nodata_mes.png
                :align: center
                :scale: 80%

                Информационное сообщение о недостатке данных для создания полилинии
                
                
Если в таблице будут заданы одинаковые координаты, на экране появится информационное сообщение 
:numref:`(Рис. %s)<create_polyline_dubl_coords_image>` и полилиния создана не будет.

.. _create_polyline_dubl_coords_image:
.. figure:: pictures\\create_objects_tools\\create_polyline_dubl_coords_mes.png
                :align: center
                :scale: 80%

                Информационное сообщение о дублировании данных в таблице

                
Если в таблице будут заданы некорректные данные, например, символьные или разделителем вещественных чисел 
будет являться символ «,» (запятая), на экране появится информационное сообщение 
:numref:`(Рис. %s)<create_polyline_dubl_nocorrect_data_image>` и полилиния создана не будет.

.. _create_polyline_dubl_nocorrect_data_image:
.. figure:: pictures\\create_objects_tools\\create_polyline_dubl_nocorrect_data_mes.png
                :align: center
                :scale: 80%

                Информационное сообщение о некорректных данных в таблице     


Если в диалоге установить галочку в поле «Не закрывать диалог после создания объекта», 
то после создания полилинии диалог не будет закрыть, а таблица для задания координат 
будет очищена.             
            
На :numref:`(Рис. %s)<create_polyline_1D_image>` представлен диалог для создания 
полилиний для моделирования одномерных задач.  

.. _create_polyline_1D_image:
.. figure:: pictures\\create_objects_tools\\create_polyline_1D_dialog.png
                :align: center
                :scale: 80%

                Диалог для создания полилиний для моделирования одномерных задач   

                
В таблице диалога необходимо задать глубину установки полилинии 
:numref:`(Рис. %s)<create_polyline_1d_depth_image>`. 
Например, для объекта в виде отрезка необходимо задать два значения глубины.

.. _create_polyline_1d_depth_image:
.. figure:: pictures\\create_objects_tools\\1d_depth.png
                :align: center
                :scale: 80%

                Задание полилинии по глубине              
     

-----------------------
Точечные объекты
-----------------------

На :numref:`(Рис. %s)<create_point_tools_image>` представлены инструменты 
создания точечных объектов в ленте 2D редактора.

.. _create_point_tools_image:
.. figure:: pictures\\create_objects_tools\\create_point_tools.png 
            :align: center
            :scale: 90%

            Инструменты создания точечных объектов в ленте 2D редактора 

            
* |load_object| - открыть диалог выбора файла формата :strong:`*.bln` 
  для импорта точечных объектов. После импорта точечным объектам будет присвоен тип, 
  который выбран на :ref:`панели управления<control_panel>` 2D редактора в момент вызова диалога импорта. 
  Если в :strong:`*.bln` файле задана геометрия 
  более чем для одного точечного объекта, то пользователю будет предложено автоматически создать группу 
  из этих объектов :numref:`(Рис. %s)<load_objects_from_bln_group_mes_image>`. 
  В случае согласия группе будет присвоено имя, соответствующее имени :strong:`*.bln` 
  файла. Впоследствии пользователь cможет изменить имя группы, используя инструменты 
  :ref:`менеджера групп<manager_group_options>`.
            
            
* |create_point| - открыть диалог для массового создания точечных объектов по координатам 
  :numref:`(Рис. %s)<create_points_image>`.
  
.. _create_points_image:
.. figure:: pictures\\create_objects_tools\\create_points_dialog.png
                :align: center
                :scale: 80%

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

.. note:: 
    В диалогах массового создания точечных объектов реализована возможность импорта данных 
    из файлов :strong:`*.csv, *.xlsx, *.txt`. Открыть диалог импорта данных можно командой 
    «Загрузить данные из файла» меню таблицы. Подробное описание диалога импорта данных приведено 
    в разделе :ref:`«Общие элементы управления. Таблицы»<table_work>`. 
    

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Вертикальные скважины
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

На :numref:`(Рис. %s)<create_v_wells_image>` представлен диалог 
для создания :ref:`вертикальных скважин<v_well>` |v_well|.

.. _create_v_wells_image:
.. figure:: pictures\\create_objects_tools\\create_v_wells_dialog.png
                :align: center
                :scale: 80%

                Диалог для массового создания вертикальных скважин

                
В данном диалоге можно задать время начала работы скважин с заданным расходом с единственным фильтром. 
Более подробное описание параметров скважины приведено в разделе 
:ref:`«Точечные объекты. Вертикальная скважина»<v_well>`. 

Данный диалог :numref:`(Рис. %s)<create_v_wells_image>` может быть использован для создания как скважин, 
у которых режим работы не изменяется в течение всего времени моделирования, так и скважин с переменным по времени
расходом. 

Чтобы задать переменный расход по времени необходимо производить ввод данных по следующему формату:


+-----------------+------+-------+-------------+----------------------+
|  Имя скважины   |X,    |Y,     |Время начала |Расход скважины,м3/сут|
|                 |м     |м      |работы, сут  |                      |
+=================+======+=======+=============+======================+
|      4а         |  365 | 539   |   20        |     30               |
+-----------------+------+-------+-------------+----------------------+
|      4а         |  340 |562    |15           |15                    |
+-----------------+------+-------+-------------+----------------------+

.. important::
    главное правило ввода в данной таблице - это наличие одинакового имени скважины в нескольких строках.

.. index: Импорт многодебитных скважин
   
"""""""""""""""""""""""""""""""""""""""""
Импорт многодебитных скважин
"""""""""""""""""""""""""""""""""""""""""
    
Для скважин, у которых меняется режим работы с течением времени дополнительно реализован специальный импорт.
Чтобы вызвать диалог импорта таких скважин необходимо нажать кнопку |import_many_rates_well| в ленте.
Импортируемый файл может иметь расширения XLSX, TXT.

Импортируемый файл расширения **XLSX** должен иметь один из двух приведенных ниже форматов:

Для скважин у которых расход задан с привязкой ко времени

+-----------------+--------------+-------------+----------------+-----------------+------------------+-------------------+----------------+
|  Имя скважины   | Координаты, м|Абс. отм. установки фильтра, м|Расход скважины, м3/сут                                                  |
|                 +------+-------+-------------+----------------+-----------------+------------------+-------------------+----------------+
|                 |X     |Y      |Низ          |Верх            |начало периода 1 | начало периода 2 |  начало периода n |конец периода n |
|                 |      |       |             |                |                 |                  |                   |                |
+=================+======+=======+=============+================+=================+==================+===================+================+
|                 |      |       |             |                |      01.01.1950 | 01.01.1951       |  01.01.2000       |01.01.2020      |
+-----------------+------+-------+-------------+----------------+-----------------+------------------+-------------------+----------------+
|      4а         |  365 | 539   |   20        |     30         |        -20      |    -10           |      0            |                |
+-----------------+------+-------+-------------+----------------+-----------------+------------------+-------------------+----------------+
|      5          |  340 |562    |15           |15              | 25              |          0       |      -5           |                |
+-----------------+------+-------+-------------+----------------+-----------------+------------------+-------------------+----------------+

Для скважин у которых расход задан с привязкой к периоду

+-----------------+--------------+-------------+----------------+-----------------+------------------+-------------------+
|  Имя скважины   | Координаты, м|Абс. отм. установки фильтра, м|Расход скважины, м3/сут                                 |
|                 +------+-------+-------------+----------------+-----------------+------------------+-------------------+
|                 |X     |Y      |Низ          |Верх            |стресс период 1  | стресс период 2  |  стресс период n  |
|                 |      |       |             |                |                 |                  |                   |
+=================+======+=======+=============+================+=================+==================+===================+
|                 |      |       |             |                |      01.01.1950 | 01.01.1951       |  01.01.2000       |
+-----------------+------+-------+-------------+----------------+-----------------+------------------+-------------------+
|      4а         |  365 | 539   |   20        |     30         |        -20      |    -10           |      0            |
+-----------------+------+-------+-------------+----------------+-----------------+------------------+-------------------+
|      5          |  340 |562    |15           |15              | 25              |          0       |      -5           |
+-----------------+------+-------+-------------+----------------+-----------------+------------------+-------------------+

Импортируемый файл расширения **TXT** должен иметь один из двух приведенных ниже форматов (единицы измерения аналогичны единицам измерения из формата выше):

+-----------------+------+-------+-------------+----------------+-----------------+------------------+-------------------+----------------+
|  Имя скважины   |X     |Y      |Низ фильтра  |Верх фильтра    |Расход скважины, | Расход скважины, |  Расход скважины, |Расход скважины,|
|                 |      |       |             |                | начало периода 1|  начало периода 2|   начало периода n| конец периода n|
|                 |      |       |             |                |      01.01.1950 |   01.01.1951     |    01.01.2000     |  01.01.2020    |
+=================+======+=======+=============+================+=================+==================+===================+================+
|      4а         |  365 | 539   |   20        |     30         |        -20      |    -10           |      0            |                |
+-----------------+------+-------+-------------+----------------+-----------------+------------------+-------------------+----------------+
|      5          |  340 |562    |15           |15              | 25              |          0       |      -5           |                |
+-----------------+------+-------+-------------+----------------+-----------------+------------------+-------------------+----------------+

+-----------------+------+-------+-------------+----------------+-----------------+------------------+-------------------+
|  Имя скважины   |X     |Y      |Низ фильтра  |Верх фильтра    |Расход скважины, | Расход скважины, |  Расход скважины, |
|                 |      |       |             |                | стресс период 1 |  стресс период 2 |   стресс период n |
|                 |      |       |             |                |  01.01.1950     |   01.01.1951     |    01.01.2000     |
+=================+======+=======+=============+================+=================+==================+===================+
|      4а         |  365 | 539   |   20        |     30         |        -20      |    -10           |      0            |                
+-----------------+------+-------+-------------+----------------+-----------------+------------------+-------------------+
|      5          |  340 |562    |15           |15              | 25              |          0       |      -5           |                
+-----------------+------+-------+-------------+----------------+-----------------+------------------+-------------------+

.. warning:: в TXT формате первая строка является смешанной - то есть она несет названия заголовков и информацию по датам изменения режима работы скважин

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Точечный источник массы
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

На :numref:`(Рис. %s)<create_source_mass_image>` представлен диалог 
для создания :ref:`точечных источников массы<mass_point>` |mass_point|.

.. _create_source_mass_image:
.. figure:: pictures\\create_objects_tools\\create_source_mass_dialog.png
                :align: center
                :scale: 80%

                Диалог для массового создания точ. источников массы

                
В данном диалоге можно задать параметры поступающего компонента-загрязнителя и 
режим его поступления в модель. Такой способ массового задания 
точечных источников массы подходит для подготовки стационарных моделей.

Более подробное описание параметров приведено в разделе 
:ref:`«Точечные объекты. Точечный источник массы»<masspoint>`. 


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Наблюдательные скважины  
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  
На :numref:`(Рис. %s)<create_obs_well_image>` представлен диалог 
для создания :ref:`наблюдательных скважин<observation_borehole>` |observation_borehole|.

.. _create_obs_well_image:
.. figure:: pictures\\create_objects_tools\\create_obs_params.png
                :align: center
                :scale: 80%

                Диалог для массового создания наблюдательных скважин

Диалог прменяется для создания наблюдательных скважин с единственным фильтром.

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

Если в поле «Установка фильтра» выбран способ «Задам позже», то такие скважины 
будут созданы, но данные в них будут неполными. При расчете параметры установки 
будут взяты из реальной :ref:`привязки<binding>` скважин.

Если в поле «Установка фильтра» выбран способ «По привязке (к слою или модели)», 
то в диалоге отображается группа дополнительных столбцов 
:numref:`(Рис. %s)<create_obs_well_bind_image>`, в которых можно детально 
задать параметры установки скважин к слоям (подслоям) модели.

.. _create_obs_well_bind_image:
.. figure:: pictures\\create_objects_tools\\create_obs_bind_params.png
                :align: center
                :scale: 80%

                Задание параметров установки наблюдательных скважин к слоям (подслоям) модели
                
                
Если в поле «Установка фильтра» выбран способ «По координате Z», 
то в диалоге отображается группа дополнительных столбцов 
:numref:`(Рис. %s)<create_obs_z1_z2_image>`, в которых можно 
задать абсолютные отметки фильтра скважин.

.. _create_obs_z1_z2_image:
.. figure:: pictures\\create_objects_tools\\create_obs_z1_z2_params.png
                :align: center
                :scale: 80%

                Задание абсолютных отметок фильтра скважин                
                
Более подробное описание параметров установки наблюдательных скважин приведено в разделе 
:ref:`«Точечные объекты. Наблюдательные скважины»<observation_borehole>`. 


.. МЕНЕДЖЕР НАБЛ. СКВАЖИН.


В 2D редакторе разработан инструмент управления наблюдательными скважинами модели 
:numref:`(Рис. %s)<obs_well_manager_image>`. 

.. _obs_well_manager_image:
.. figure:: pictures\\create_objects_tools\\obs_well_manager.png
                :align: center
                :scale: 80%

                Диалог управления наблюдательными скважинами модели     

                
Чтобы открыть диалог управления наблюдательными скважинами модели, 
нужно воспользоваться командой |obs_well_manager| ленты 2D редактора 
:numref:`(Рис. %s)<obs_well_manager_strip_image>`. 

.. _obs_well_manager_strip_image:
.. figure:: pictures\\create_objects_tools\\obs_well_manager_strip.png
                :align: center
                :scale: 80%

                Команда вызова диалога управления набл. скважинами модели в ленте 2D редактора               

Диалог управления наблюдательными скважинами не только отображает все наблюдательные скважины, 
которые заданы в модели, но и позволяет создавать новые скважины и удалять ненужные. 
Чтобы создать новую скважину, нужно нажать кнопку «+», расположенную справа от списка скважин модели. 
Чтобы удалить скважину из модели, нужно выбрать ее в списке и нажать кнопку «-». 
При выборе скважины из списка справа от него отображается диалог с заданными параметрами скважины. 
Подробное описание всех параметров скважин приведено в разделе 
:ref:`«Точечные объекты. Наблюдательные скважины»<observation_borehole>`.  

.. note::
    В диалоге реализована возможность автоматической группировки 
    точечных источников массы, а также наблюдательных и вертикальных скважин. 
    Для этого нужно в столбце «Группа» диалога указать название группы.          

                         
             
.. index:: Импорт объектов из файлов
                
.. _creating_by_import:

==================================================================
Импорт объектов из файлов, подготовленных в других программах
==================================================================

В 2D редакторе реализована возможность импорта объектов из 
:strong:`*.bln,*.shp,*.dxf` файлов. 
Импортировать объекты из таких файлов можно двумя способами:

  1. с помощью команды |import| ленты 
     :numref:`(Рис. %s)<import_obj_strip_image>`. После нажатия на данную команду 
     откроется диалог выбора файла (SHP,BLN,DXF).
     
     .. _import_obj_strip_image:
     .. figure:: pictures\\create_objects_tools\\import_obj_strip.png
                    :align: center
                    :scale: 80%

                    Команда для импорта объектов из файлов (SHP,BLN,DXF) в ленте 2D редактора    
    
  
  2. перетаскиванием файла с одним из расширений :strong:`*.bln,*.shp,*.dxf` в 
     :ref:`окно редактирования геометрии<view_active_window>` 2D редактора.
  
  

----------------------------------------------
Импорт объектов из bln файлов
----------------------------------------------
 
На :numref:`(Рис. %s)<bln_reader_image>` представлен диалог импорта объектов из :strong:`*.bln` файлов.
    
.. _bln_reader_image:
.. figure:: pictures\\create_objects_tools\\bln_reader.png
                    :align: center
                    :scale: 80%

                    Диалог импорта объектов из :strong:`*.bln` файлов 
                        
                        
В верхней части диалога приведено имя файла, из которого производится импорт объектов.           
В списке «Импортировать как» диалога необходимо выбрать тип, 
который будет присвоен объектам после импорта.        
Если объекты из файла импортируются как полилинии, 
то в диалоге отобразится дополнительный список «Тип полилинии». 
В этом списке необходимо указать, как импортировать полилинии: 
в виде замкнутых или незамкнутых кривых :numref:`(Рис. %s)<bln_reader_polyline_image>`.
Чтобы завершить импорт объектов из файла, следует нажать кнопку «Импортировать» диалога. 

.. _bln_reader_polyline_image:
.. figure:: pictures\\create_objects_tools\\bln_reader_polyline.png
                    :align: center
                    :scale: 80%

                    Дополнительные опции диалога импорта объектов из BLN файлов 

.. note::
    В диалоге импорта объектов из :strong:`*.bln` файлов 
    реализована возможность импорта объектов из нескольких файлов.

  
----------------------------------------------
Импорт объектов из shp,dxf файлов
----------------------------------------------

При импорте объектов из файлов с расширением :strong:`*.shp,*.dxf` используется один и тот же диалог.
Ниже данный диалог расматривается на примере импорта из :strong:`*.shp` файлов.

На :numref:`(Рис. %s)<shp_reader_image>` представлен диалог импорта объектов из :strong:`*.shp` файлов.
    
.. _shp_reader_image:
.. figure:: pictures\\create_objects_tools\\shp_reader.png
                    :align: center
                    :scale: 80%

                    Диалог импорта объектов из SHP файлов 
         
Диалог импорта состоит из трех основных частей:

  1. дерево объектов;
  2. таблица параметров;
  3. область визуализации.
  
  
В дереве объектов диалога импорта представлены все объекты, которые содержатся 
в :strong:`*.shp` файле :numref:`(Рис. %s)<shp_reader_object_tree_image>`. 
Файл может содержать объекты только одного геометрического типа:  
полигоны, полилинии или точки.

.. _shp_reader_object_tree_image:
.. figure:: pictures\\create_objects_tools\\shp_reader_object_tree.png
                    :align: center
                    :scale: 80%

                    Дерево объектов диалога импорта 
                    
В дереве объектов два столбца. В первом столбце приведены внутренние имена объектов 
(имена, присвоенные объектам внутри диалога импорта), 
во втором - тип, который будет присвоен объектам после импорта в :ref:`2D редактор<views>`. 
Чтобы для всех объектов установить одинаковый тип, который будет присвоен им после 
импорта, нужно в поле  «Одинаковый тип» диалога импорта установить галочку и 
выбрать нужный тип в раскрывающемся списке :numref:`(Рис. %s)<shp_reader_one_type_image>`. 

.. _shp_reader_one_type_image:
.. figure:: pictures\\create_objects_tools\\shp_reader_one_type.png
                    :align: center
                    :scale: 80%

                    Выбор опции «Одинаковый тип» в диалоге импорта объектов

.. note::
         В диалоге импорта для всех объектов можно задать одинаковый тип и другим способом. Для этого необходимо по правй кнопке мыши перейти в контекстное меню геометрического типа (полигон, полилиния, точечный объект), столбца "Имя", нажать "Задать одинаковый тип" и выбрать нужный тип для всех объектов в раскрывшемся списке.

         .. figure:: pictures\\create_objects_tools\\shp_reader_one_type1.png
                    :align: center
                    :scale: 80%

                    Выбор опции «Задать одинаковый тип» в диалоге импорта объектов
		 
					
Если развернуть содержимое объектов дерева, то под именами объектов будут приведены
их внутренние параметры :numref:`(Рис. %s)<shp_reader_object_info_image>`. 

.. _shp_reader_object_info_image:
.. figure:: pictures\\create_objects_tools\\shp_reader_object_info.png
                    :align: center
                    :scale: 80%

                    Внутренние параметры объектов в дереве

Для ряда объектов (зона со свойствами |zone|, 
внутреннее ГУ |ic_line|, абстрактный полигон, наблюдательная скважина |observation_borehole|) 
помимо импорта геометрии реализована возможность импорта параметров. 
Для этого в диалоге импорта должна быть включена опция «Одинаковый тип» и в списке 
выбран один из перечисленных типов объектов. В таком случае в диалоге импорта 
отобразится таблица параметров :numref:`(Рис. %s)<shp_reader_table_params_image>`. 

.. _shp_reader_table_params_image:
.. figure:: pictures\\create_objects_tools\\shp_reader_table_params.png
                    :align: center
                    :scale: 80%

                    Таблица параметров в диалоге импорта объектов
 
С помощью таблицы параметров можно установить соответствие между внутренними параметрами 
объектов из файла с параметрами объектов, предусмотренными в 2D редакторе. 
Внутренние параметры объектов приведены в столбце «Свойство объекта импорта». 
Параметры, предусмотренные в 2D редакторе, приведены в столбце «Свойство объекта в сцене». 
Чтобы установить между ними соответствие, нужно в ячейке столбца 
«Свойство объекта в сцене» выбрать параметр из списка и установить галочку 
в столбце «Связать с» таблицы параметров :numref:`(Рис. %s)<shp_reader_params_map_image>`. 

.. _shp_reader_params_map_image:
.. figure:: pictures\\create_objects_tools\\shp_reader_params_map.png
                    :align: center
                    :scale: 80%

                    Установка соответствия параметров в диалоге импорта объектов


Справа в диалоге импорта расположена область визуализации :numref:`(Рис. %s)<shp_reader_view_image>`.                                        
В области визуализации черной сплошной линией отображаются контуры всех объектов из файла. 
Если в модели на момент импорта объектов был задан контур области моделирования, 
то в области визуализации также будут отображаться его границы 
(красная пунктирная линия) и габаритная коробка (серая пунктирная линия). 
При выборе объекта в дереве соответствующий объект будет подсвечен в области визуализации (зеленым цветом).

.. _shp_reader_view_image:
.. figure:: pictures\\create_objects_tools\\shp_reader_view.png
                    :align: center
                    :scale: 80%
                    
                    Область визуализации в диалоге импорта объектов
  
Чтобы импортировать только те объекты, которые попали внутрь габаритной коробки контура области моделирования, 
необходимо установить галочку в одноименном поле диалога :numref:`(Рис. %s)<shp_reader_contour_out_image>`.

.. _shp_reader_contour_out_image:
.. figure:: pictures\\create_objects_tools\\shp_reader_contour_out.png
                    :align: center
                    :scale: 80%
                    
                    Опция для импорта объектов, попавших внутрь габаритной коробки контура обл. моделирования

Чтобы завершить импорт объектов из файла, нужно нажать кнопку «Импортировать».



.. _copy_objects:

=================================
Копирование объектов
=================================

В :ref:`2D редакторе<views>` реализована возможность копирования объектов. 
Скопировать выбранные объекты в буфер обмена можно двумя способами:

  1. комбинацией клавиш «Ctrl+C»;
  2. командой «Копировать объекты в буфер» меню объектов 
     :numref:`(Рис. %s)<menu2d_copy_obj_image>`. 
  
.. _menu2d_copy_obj_image:
.. figure:: pictures\\create_objects_tools\\menu2d_copy_obj.png
                    :align: center
                    :scale: 80%
                    
                    Команда для копирования объектов в буфер 
  
  
Вставить объекты из буфера можно: 

  1. комбинацией клавиш «Ctrl+V». Данный способ позволяет вставить объекты из буфера в тех же координатах;
  2. командой «Вставить объекты из буфера» меню 2D редактора (раздел «Дополнительно»)
     :numref:`(Рис. %s)<menu2d_paste_obj_image>`. 
     Данная команда имеет подменю, в котором можно выбрать способ вставки объектов из буфера
     в окно 2D редактора: 
     
       * «В том же месте»;
       * «Относительно положения курсора мыши».     
       
.. _menu2d_paste_obj_image:
.. figure:: pictures\\create_objects_tools\\menu2d_paste_obj.png
                    :align: center
                    :scale: 80%
                    
                    Команда для вставки объектов из буфера в меню
       
В 2D редакторе запрещено копировать объекты типа :ref:`«Контур области моделирования»<contour>` |contour| и 
:ref:`«Прямоугольный контур»<poly_contour>` |polycontour|. 
Это ограничение связано с тем, что в модели может быть задан только один 
активный контур области моделирования. 
При копировании объектов также производится копирование заданных в них параметров. 


.. _create_from_object:

==================================================================
Создание объектов из других объектов
==================================================================

В :ref:`2D редакторе<views>` реализована возможность создания объектов из других объектов. 
Создать объект из выбранного объекта можно с помощью команды меню «Создать из объекта». 
Данная команда доступна только для полигонов и полилиний.
Команда «Создать из объекта» имеет подменю, в котором нужно выбрать тип, 
который будет присвоен объекту после создания 
:numref:`(Рис. %s)<menu2d_create_from_polygon_image>`.

.. _menu2d_create_from_polygon_image:
.. figure:: pictures\\create_objects_tools\\menu2d_create_from_polygon.png
                    :align: center
                    :scale: 80%
                    
                    Команда для создания объекта из выбранного объекта
                    
После выбора типа объекта в подменю на экране появится диалог создания объекта 
:numref:`(Рис. %s)<create_from_dialog_image>`. 

.. _create_from_dialog_image:
.. figure:: pictures\\create_objects_tools\\create_from_dialog.png
                    :align: center
                    :scale: 80%
                    
                    Диалог для создания объекта из выбранного объекта
                    
                    
В диалоге нужно выбрать способ создания объекта:

  * «Точный контур» - создать объект, используя точный контур выбранного объекта;
  * «Окаймляющий прямоугольник» - создать объект, используя окаймляющий прямоугольник выбранного объекта.
  
Если выбран способ создания «Окаймляющий прямоугольник», 
в диалоге откроется поле, в котором нужно указать количество объектов, которое будет создано.
Чтобы завершить создание объектов, нужно нажать кнопку «Создать». 

Создание объекта типа «Зона со свойствами» |zone| из контура области моделирования 
|contour| имеет ряд особенностей. 

  1. Если предварительно было произведено разбиение 
     контура области моделирования, а в диалоге создания выбран способ создания объекта
     «Точный контур», то зона со свойствами будет создана не из точной границы контура области моделирования, 
     а по его границе, которая получилась после разбиения :numref:`(Рис. %s)<zone_from_contour_image>`. 

      .. _zone_from_contour_image:
      .. figure:: pictures\\create_objects_tools\\zone_from_contour.png
                        :align: center
                        :scale: 80%
                        
                        Зона, созданная по границе разбиения контура обл. моделирования    

  2. Любое изменение геометрии контура области моделирования (кроме :ref:`подмены<replace_geom_command_2d>`) 
     повлечет за собой изменение геометрии зоны. 
     
  3. Если была произведена подмена геометрии, то после подмены разбиение контура будет «стерто» и зона 
     в таком случае будет создана по точной границе контура области моделирования. 
     
  4. Если предварительно не было произведено разбиение контура, 
     то зона со свойствами будет создана по точной границе контура области моделирования.

Создавать объекты из других объектов также можно с помощью команд меню дерева объектов 
:numref:`(Рис. %s)<create_obj_from_tree_image>`.  

.. _create_obj_from_tree_image:
.. figure:: pictures\\create_objects_tools\\create_obj_from_tree.png
                    :align: center
                    :scale: 80%
                    
                    Команда для создания объекта в меню дерева объектов     

Принцип создания объектов из выбранного объекта с помощью команд меню дерева такой же, 
как и в 2D редакторе.                      
                    
.. note::            
        * С помощью команды меню 2D редактора «Создать из объекта» можно создать объекты 
          из нескольких выбранных объектов одного геометрического типа. 
        
        * С помощью команды меню дерева объектов «Создать из объекта» одновременно 
          можно создать объект только из одного выбранного объекта. 

    
.. |BC_by_points_1| image:: pictures\\create_objects_tools\\bc_bind_three_node2.png

.. |BC_by_points_2| image:: pictures\\create_objects_tools\\bc_bind_three_node.png

.. |BC_by_points_3| image:: pictures\\create_objects_tools\\bc_bind_three_node3_ready.png
                       

.. |BC_by_contour_1| image:: pictures\\create_objects_tools\\bc_bind_polygon_node4.png

.. |BC_by_contour_2| image:: pictures\\create_objects_tools\\bc_bind_polygon_node.png

.. |BC_by_contour_3| image:: pictures\\create_objects_tools\\bc_bind_polygon_node6.png
                      

