Значок
Связанные новости и статьи
ПРАКТИЧЕСКОЕ РУКОВОДСТВО
Версия 1.0
Скачать
Использование
Для использования плагина необходимо выбрать существующую или создать новую конфигурацию. Для создания новой конфигурации нажмите 
Выбранную конфигурацию можно переименовать, введя название в текстовое поле с подсказкой «Введите название конфигурации», дублировать, нажав кнопку 
или удалить, нажав кнопку 
:
Дублирование конфигураций доступно только в полной версии плагина.
Каждая конфигурация содержит набор стратегий. Стратегии различаются алгоритмом обработки элементов. При нажатии на кнопку Добавить стратегию появится диалоговое окно со списком доступных стратегий с коротким описанием:
В списке стратегия имеет чекбокс, позволяющий отключать/включать стратегию, системное название стратегии, пользовательское название стратегии, а также кнопки дублирования и удаления .png)
стратегии, которые отображаются при наведении курсора:
Дублирование стратегий доступно только в полной версии плагина.
Стратегии текущей конфигурации можно экспортировать в Excel, нажав кнопку Экспорт и импортировать из Excel, нажав кнопку Импорт.
В нижней левой части окна плагина расположены кнопки, позволяющие поставить флажки напротив всех стратегий в текущей конфигурации 
, снять все флажки 
и удалить все стратегии в текущей конфигурации 
.
Когда стратегия выбрана, в правой части окна плагина отображается ее содержимое, включающее текстовое поле для ввода пользовательского названия, описание стратегии, таблицу правил:
Для некоторых стратегий могут иметься общие настройки, находящиеся в панели настроек, вызываемой нажатием соответствующей кнопки в правом верхнем углу окна:
Каждая стратегия состоит из правил. Правило задает способы фильтрации обрабатываемых элементов и формулу, применяемую к обрабатываемым элементам. Для фильтрации элементов используются фильтры элементов по категориям и параметрам. В зависимости от стратегии правило может содержать фильтры для условно исходных элементов (для стратегии InHost это элементы-основы, для стратегии InGroup это группы, для стратегии SolidTouch это касаемые элементы и т.д.). Также, в зависимости от стратегии, фильтры по категории могут отсутствовать.
Для добавления правила в таблицу используется . Для удаления выбранных правил используется , а для дублирования выбранных правил – .
Дублирование правил доступно только в полной версии плагина.
Правила текущей стратегии можно скопировать в буфер обмена 
и вставить из буфера обмена 
как в текущую стратегию, так и в другие.
Правила текущей стратегии можно экспортировать в Excel, нажав 
или импортировать из 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 и т.п.) не рекомендуется использовать данный вариант выборки, так как у элементов будет браться геометрия, не учитывающая взаимодействие с другими элементами, что может привести к некорректному результату.
Для запуска параметризации нажмите кнопку Выполнить и дождитесь результатов работы.
РАБОТА С ГЕОМЕТРИЕЙ
Для стратегий InRoom, InSpace, InMass, InSolid присутствует возможность выбрать один из двух алгоритмов определения вхождения объемных форм:
Определение вхождения выполняется через вспомогательные лучи, опущенные из центроида объемной формы целевого элемента в 4-х направлениях в плоскости XY. Если все 4 луча пересекаются с объемной формой родительского элемента, то считается, что целевой элемент находится внутри родительского:
При этом для стратегии InRoom пересечение 3 из 4 лучей считается положительным результатом.
Данный алгоритм работает быстро, но позволяет определить вхождение объемной формы лишь в одну родительскую объемную форму. При этом важно положение центроида объемной формы.
Определение вхождения выполняется через булевы операции, представленные в Revit API. По сути, данный алгоритм определяет пересечение объемных форм. Например, алгоритм будет считать попадание балки в обе стены:
Данный алгоритм работает медленно, но позволяет определить вхождение объемной формы в несколько пересекаемых родительских объемных форм.
Для обоих алгоритмов присутствует проверка объема объемных форм – объем родительской объемной формы должен быть больше объема целевой объемной формы.
В стратегии SolidTouch соприкасание проверяется только через параллельные плоские грани объемных форм элементов.