Значок
Связанные новости и статьи
ПРАКТИЧЕСКОЕ РУКОВОДСТВО
Версия руководства 3.1Скачать
Использование
Для использования плагина необходимо выбрать существующую или создать новую конфигурацию. Для создания новой конфигурации нажмите
.
Выбранную конфигурацию можно переименовать, введя название в текстовое поле с подсказкой "Введите название конфигурации", дублировать 
, экспортировать 
и импортировать 
со всеми настройками в формате xml, а также удалить
с помощью соответствующих кнопок:
Дублирование конфигураций доступно только в полной версии плагина.
Каждая конфигурация содержит набор стратегий. Стратегии различаются алгоритмом обработки элементов. При нажатии на кнопку Добавить стратегию появится диалоговое окно со списком доступных стратегий с коротким описанием:
В списке стратегия имеет чекбокс, позволяющий отключать/включать стратегию, системное название стратегии, пользовательское название стратегии, а также кнопки дублирования 
, изменения фона стратегии в списке
и удаления.png)
стратегии, которые отображаются при наведении курсора:
Дублирование стратегий доступно только в полной версии плагина.
Стратегии текущей конфигурации можно экспортировать в Excel, нажав кнопку Экспорт и импортировать из Excel, нажав кнопку Импорт.
В нижней левой части окна плагина расположены кнопки, позволяющие поставить флажки напротив всех стратегий в текущей конфигурации 
, снять все флажки 
и удалить все стратегии в текущей конфигурации 
.
Когда стратегия выбрана, в правой части окна плагина отображается ее содержимое, включающее текстовое поле для ввода пользовательского названия, описание стратегии, источник данных, фильтры стратегии и таблицу правил:
Для некоторых стратегий могут иметься общие настройки конфигурации, находящиеся в панели настроек, вызываемой нажатием соответствующей кнопки в правом верхнем углу окна:
Фиксация изменений в документе – опция, определяющая момент, когда изменения фиксируются в документе: после установки каждого значения в параметр каждого элемента, после обработки всех выражений каждого правила или после обработки всех правил каждой стратегии. Выбор варианта фиксации изменений может повлиять на время работы плагина: при варианте При установке значения в параметр потребуется больше времени, чем при варианте При обработке стратегии.
Каждая стратегия состоит из правил. Правило задает способы фильтрации обрабатываемых элементов и формулу, применяемую к обрабатываемым элементам. Для фильтрации элементов используются фильтры элементов по категориям и параметрам. В зависимости от стратегии правило может содержать фильтры для условно исходных элементов (для стратегии InHost это элементы-основы, для стратегии InGroup это группы, для стратегии SolidTouch это касаемые элементы и т.д.). Также, в зависимости от стратегии, фильтры по категории могут отсутствовать.
Фильтры стратегии распространяются на все правила, для которых не заполнены собственные фильтры элементов. Если в фильтре стратегии заполнен только фильтр по категориям, а фильтре правила – только фильтр по параметрам, то в результате будет получаться совмещенный фильтр с заданными категориями и параметрами. И наоборот – в фильтре стратегии можно задать только категории, а в фильтре правила только параметры. Если же в правиле будут заполнены и фильтр по категориям, и фильтр по параметрам, то фильтр стратегии будет игнорироваться.
К стратегии можно подключить источник данных в виде листа из указанного Excel-файла. Файл подключается
и отключается 
в стратегии с помощью соответствующих кнопок, лист выбирается из выпадающего списка листов выбранного файла.
Для добавления правила в таблицу используется . Для удаления выбранных правил используется 
, а для дублирования выбранных правил – .
Дублирование правил доступно только в полной версии плагина.
Правила текущей стратегии можно скопировать в буфер обмена 
и вставить из буфера обмена 
как в текущую стратегию, так и в другие. Список правил можно развернуть с помощью кнопки .png)
:
Правила текущей стратегии можно экспортировать, нажав или импортировать, нажав . Доступно два формата файлов экспорта/импорта: XML и Excel. При импорте правил в незаполненную стратегию, а также при импорте с заменой текущих правил, будут импортированы имя и описание стратегии.
Все правила стратегии можно отметить с помощью и снять отметки со всех выбранных правил, нажав . Также можно изменить цвет фона первой ячейки выбранных правил с помощью кнопки .
Правила в списке можно перемещать мышкой, а также перетаскивать в другие стратегии. После перемещения правил можно выполнить их перенумерацию согласно положению в таблице, нажав 
.
Каждое правило можно исключить из работы, снявфлажок с чекбокса в соответствующей ячейке в таблице.
При двойном клике в ячейке Формула или в ячейке Свойства формулы открывается редактор формулы:
В самой верхней части редактора формулы расположена ссылка, при клике по которой открывается подробная инструкция к редактору формул:
Формула состоит из выражений, что позволяет выполнять несколько расчетов к элементам, подходящих под критерии фильтрации родительского правила. Помимо выражений формула содержит несколько свойств:
- Допуск – задает допуск, который используется при сравнении числовых значений. Например, если допуск установлен 0.1, то условие "10.05 = 10.06" будет считаться верным.
- С учетом регистра – задает правило сравнения строковых значений: сравнивать ли их с учетом регистра или нет.
- Записывать пустой результат – указывает, записывать ли пустой результат, полученный при вычислении выражения, в целевой параметр. Для строковых параметров пустой результат – пустая строка. Для числовых параметров пустой результат – значение 0.
- Отвязать – позволяет удалить связь целевого параметра с глобальным параметром проекта при наличии связи.
Справа от поля редактирования формулы имеются вспомогательные кнопки:
используется для добавления в формулу параметра целевого элемента. Список параметров доступен при соблюдении двух условий: 1. В фильтре целевого элемента указана хотя бы одна категория; 2. В модели имеется хотя бы один экземпляр элемента указанных категорий. Если оба условия не соблюдаются, то кнопка будет неактивной.
используется для добавления в формулу параметров условно исходного элемента. Список параметров доступен при соблюдении двух условий: 1. В фильтре условно исходного элемента указана хотя бы одна категория; 2. В модели имеется хотя бы один экземпляр элемента указанных категорий. Если оба условия не соблюдаются, то кнопка будет неактивной. Если родительская стратегия не предполагает условного исходного элемента, то данная кнопка не будет отображаться.
используется для добавления в формулу арифметической или условной функции.
В окне настроек плагина расположена кнопка Маппинг имен функций, открывающая окно, в котором можно задать свои собственные имена для функций из редактора формул:
В правой части окна редактора формулы располагаются Поля, позволяющие заменять части формул ключами. Поля можно вставлять друг в друга.
Для добавления нового поля нужно нажать на кнопку в правой части окна или выделить часть формулы в поле редактирования и, кликнув правой кнопкой мыши, выбрать команду Создать поле.
При наведении на поле становятся доступными команды, позволяющие дублировать поле , удалить поле , добавить 
или убрать 
поле из списка избранных полей. С помощью кнопки 
в правой части окна открывается редактор, из которого можно вставить выбранные избранные поля (выбирать можно с помощью Ctrl или Shift) в список полей текущей формулы. Данный редактор можно также открыть из окна настроек плагина для редактирования существующих или добавления новых избранных полей. Поля из списка избранных полей можно использовать в формулах других правил и обновлять значения полей во всех правилах всех конфигураций 
:
При наведении курсора на ячейку Формула появляется кнопка, позволяющая показать/скрыть формулу в списке правил:
Перед запуском параметризации по текущей конфигурации необходимо указать вариант выборки элементов:
Каждый вариант выборки имеет нюансы в зависимости от стратегий:
Обработка выбранных элементов. В случае, если имеется стратегия Types, будут обрабатываться типоразмеры только выбранных элементов. В случае, если имеется стратегия, в которой обрабатываются элементы внутри других элементов (InRoom, InSolid, InMass и т.п.), выбирать нужно все элементы, а не только родительские.
Обработка элементов на текущем виде. Рекомендуемый вариант! В случае, если имеется стратегия Types, будут обрабатываться типоразмеры элементов на текущем виде. Для некоторых стратегий важно учитывать текущий вид. Например, стратегия InRoom не будет работать на 3D виде, так как помещения не имеют геометрии на 3D виде. Также нужно учитывать, что уровень детализации текущего вида может влиять на результат работы стратегий, связанных с геометрией (InRoom, InSolid, SolidTouch и т.п.).
Обработка элементов на выбранных видах. В открывшемся окне необходимо отметить те виды, на которых располагаются обрабатываемые элементы. Аналогичен варианту Обработка элементов на текущем виде.
Обработка элементов в документе. В случае, если имеется стратегия Types, будут обрабатываться все типоразмеры документа. Для стратегий, работающих с геометрией элементов (таких как InRoom, InSolid, SolidTouch и т.п.) не рекомендуется использовать данный вариант выборки, так как у элементов будет браться геометрия, не учитывающая взаимодействие с другими элементами, что может привести к некорректному результату.
Для запуска параметризации нажмите кнопку Выполнить и дождитесь результатов работы.
В окне результатов отображается общая информация о количестве выполненных стратегий и правил, затраченном времени и количестве обработанных элементов. Ниже приводится список выполненных стратегий с указанием количества обработанных элементов и затраченного времени. Развернув содержимое списка, можно увидеть количество элементов, обработанных каждым из выражений правил.
Для выбранного в списке выражения в правой части окна отображается список ID обработанных элементов с возможностью выбрать или изолировать все элементы с помощью соответствующих кнопок. В случае если были обработаны элементы из связанных файлов, то их ID также будут в списке, но выбрать эти элементы будет невозможно.
РАБОТА С ГЕОМЕТРИЕЙ
Для стратегий InRoom, InSpace, InMass, InSolid присутствует возможность выбрать один из двух алгоритмов определения вхождения объемных форм:
Определение вхождения выполняется через вспомогательные лучи, опущенные из центроида объемной формы целевого элемента в 4-х направлениях в плоскости XY. Если все 4 луча пересекаются с объемной формой родительского элемента, то считается, что целевой элемент находится внутри родительского:
При этом для стратегии InRoom пересечение 3 из 4 лучей считается положительным результатом.
Данный алгоритм работает быстро, но позволяет определить вхождение объемной формы лишь в одну родительскую объемную форму. При этом важно положение центроида объемной формы.
Определение вхождения выполняется через булевы операции, представленные в Revit API. По сути, данный алгоритм определяет пересечение объемных форм. Например, алгоритм будет считать попадание балки в обе стены:
Данный алгоритм работает медленно, но позволяет определить вхождение объемной формы в несколько пересекаемых родительских объемных форм.
Для обоих алгоритмов присутствует проверка объема объемных форм – объем родительской объемной формы должен быть больше объема целевой объемной формы.
В стратегии SolidTouch соприкасание проверяется только через параллельные плоские грани объемных форм элементов.
