Склеить параметры (для бимов)

Подготовка к использованию

1. Модель, в которой планируется запустить “склейку”, должна иметь название файла в соответствии с Правилами хранения и именования файлов;
   •  Если модель по каким-либо причинам имеет наименование файла не соответствующее Правилами хранения и именования файлов или в соответствии с требованиями и наименованием файла, подходит несколько таблиц, тогда в модель должен быть добавлен параметр проекта из ФОП (файл общих параметров) Путь к таблице, расположенный в группе параметров Общие. Данный параметр необходимо добавить к категории Сведения о проекте. В сведениях о проекте данный параметр должен содержать название таблицы, в которой заданы правила заполнения параметров. Пример заполнения параметра: ОВ_1.0ГПМСК. Талица должна обязательно располагаться в определенной папке на диске L. Путь к папке: \\picompany.ru\pikp\lib\02_Revit\70_PIKTools\ИОС-ОВ-ВК-ЭОМ-СС\Вспомогательные материалы\Склеить параметры\
2. Расположить в модели элементы;
3. В модель должны быть добавлены параметры проекта из ФОП (файл общих параметров) BI_Требования BIM, расположенный в группе параметров Общие;
   • Данный параметр необходимо добавить к категории Сведения о проекте;
   • В сведениях о проекте данный параметр должен содержать значение стандарта, в котором выполняется данная модель (данные из 1С) см. Алгоритм назначения требований BIM;
4. В модель должны быть добавлены параметры проекта из ФОП (файл общих параметров), которые указаны в таблицах склейки, для соответствующих категорий. Заполняемые параметры должны быть добавлены, как параметры экземпляра;
5. Заполняемые параметры, не должны быть заблокированы для записи (формулами в семействе);
6. Вторая таблица, с которой работает плагин - таблица для изоляции. Путь к таблице по изоляции прописан в коде, поэтому таблица просто должна быть на диске lib в соответствующей папке, удалять или перемещать ее нельзя.

Запуск плагина

• Запуск плагина осуществляется с любого 2D/3D вида или спецификации;
• Плагин располагается на вкладке PIKTools: Общее

Описание

JSON

Склейка после определения таблицы для работы обращается к файлу конфигу, в котором прописаны категории, с которыми в принципе будет работать инструмент. Конфиг один, общая для всех дисциплин/требований/стадий. Путь к нему прописан в коде плагина, поэтому перемещать или переименовывать файл нельзя.

Конфиг имеет определенное название и хранится только в соответствующей папке на диске: L:\02_Revit\70_PIKTools\ИОС-ОВ-ВК-ЭОМ-СС\Вспомогательные материалы\Склеить параметры\GlueParametersExternalSettings

Этот файл сделан для того, что бы разу же отсечь часть категорий, которые точно не должна отрабатывать склейка для всех дисциплин, и их не нужно прописывать в рабочих таблицах на листе Пропустить.

В конфиге прописывается категория из свойства BuiltInCategory, в кавычках, далее двойной слеш и название категории из свойства Name.\

Таблицы

Определение таблицы для работы

Таблицы создаются для каждой дисциплины и для каждого стандарта отдельно. Создают и контролируют таблицы bim-координаторы отдела внедрения по дисциплинам.
Таблицы хранятся только в соответствующей папке на диске: L:\02_Revit\70_PIKTools\ИОС-ОВ-ВК-ЭОМ-СС\Вспомогательные материалы\Склеить параметры

Вес таблицы excel не должен превышать 1000 КБ. Так как вес таблицы влияет на скорость отработки склейки, необходимо максимально оптимизировать таблицы и сокращать их вес (Почему excel файл много весит).

Если параметр Путь к таблице заполнен, то таблица определяется по указанному пути. В параметр Путь к таблице заполнять название таблицы без формата документа, без лишних символов, например: ЭОМ_1.0Рен_Спец

Если параметр Путь к таблице не заполнен, то плагин сам определяет таблицу для работы на основании наименования файла, требований BIM и стадии (при наличии). Сравнивается имя таблицы, состоящее из  3х полей, с данными модели следующим образом:

• 1 поле - дисциплина, указанная в 5 поле наименования файла;
• 2 поле - требования BIM, указанные в проекте у категории Сведения о проекте в параметре BI_Требования BIM. Если по точному совпадению значений не удается определить таблицу, то поиск происходит по части значения (“содержит”);
• 3 поле *при наличии (необязательное) - стадия, указанная во 2 поле наименования файла;

Пример:

• BI_Требования BIM = BIM 21.1Р, название таблицы = ОВ_21.1.
  Дисциплина “ОВ” получена из названия файла. По значению требований совпадает часть “21.1”, если других подходящих таблиц нет, то выбирается эта. Если есть два варианта: название таблицы = ОВ_21.1 и = ОВ_BIM 21.1Р, то выбирается таблица ОВ_BIM 21.1Р, т.к. значение 2 поля полностью совпадает с требованиями.
• BI_Требования BIM = BIM 18.1, название таблицы = ОВ_18.1_П.
  Дисциплина “ОВ” получена из названия файла. По значению требований совпадает часть “18.1”. Стадия “П” получена из названия файла. Если есть два варианта: название таблицы = ОВ_18.1 и = ОВ_18.1_П, то выбирается таблица ОВ_18.1_П, т.к. совпадение найдено по 3м полям.

Таблица правил

Таблица с правилами одна, общая для всех дисциплин/требований/стадий. Путь к этой таблице прописан в коде плагина, поэтому перемещать или переименовывать ее нельзя. Таблица имеет определенное название и хранится только в соответствующей папке на диске:
L:\02_Revit\70_PIKTools\ИОС-ОВ-ВК-ЭОМ-СС\Вспомогательные материалы\Склеить параметры\Правила_новые.xslx

Состоит она из двух обязательных листов: Настройки и Размерности. Удалять или переименовывать листы нельзя. Остальные листы игнорируются в работе плагина.

На листе Настройки перечислены функции, выполняемые при наличии символа в формулах рабочих таблиц:

• 1 столбец - название функции, на основании которой происходит сопоставление символа из следующего столбца; корректировать/удалять значения нельзя.
• 2 столбец - символы/буквы/цифры, которые необходимо указывать в формулах рабочих таблиц для вызова функции;
• 3 столбец - описание где и как устанавливать данный символ при формировании правил;
• в следующих - описание, особенности и примеры.

На листе Размерности перечислены различные единицы измерения, которые можно использовать в формулах рабочих таблиц. На данном листе происходит сопоставление: общепринятого обозначения единиц измерения, которые можно указывать в формулах рабочих таблиц - в первом столбике, программным единицам измерения (используемых в revit/api) - второй столбик.

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

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

Посмотреть используемые единицы измерения у элемента можно через Revit Lookup.

Таблица изоляции

Таблица с изоляцией одна, общая для всех дисциплин/требований/стадий. Путь к этой таблице прописан в коде плагина, поэтому перемещать или переименовывать ее нельзя.
Таблица имеет определенное название и хранится только в соответствующей папке на диске:
L:\02_Revit\70_PIKTools\ИОС-ОВ-ВК-ЭОМ-СС\Вспомогательные материалы\Склеить параметры\Изоляция_новая
Состоит она из нескольких листов: в названии листа прописывается конкретная revit категория изоляции, для которой будут применяться правила с этого листа.

Например: Материал изоляция труб

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

Пример:

Правила заполнения листов одинаковые:

• 1 столбец - Версия требований (полностью)

Если значений версии больше одного, то при перечислении значений необходимо устанавливать разделитель | (вертикальный слеш). Значение версии требования должно совпадать с значением в параметре BI_Требования BIM у категории Сведения о проекте. Если в строках данного столбца не содержится значения, которое прописано в параметре BI_Требования BIM, то запись значений толщины изоляции не будут записаны элементам.

• 2 столбец - Тип

По значениям в данном столбце происходит выборка элементов, которым будет записываться значение диаметра из таблицы. Значение имени типа для стандартов выше 18.1 записываются с помощью символа *, т.е. сначала основная часть имени типа до перечисления толщин, а вместо толщин пишется *. Это означает, что в работу будут идти элементы с именем типа начинающимися на то, что указано до *. Например: Цилиндры навивные из каменной ваты с группой горючести - НГ*

Если в модели не будут найдены элементы с типами, указанными в таблице - записи значений не произойдет.

• 3 столбец - Диаметр изоляции

Запись значений диаметра изоляции в параметры элементов происходит на основании полученных совпадений в 1, 2, 4 столбцах и после определения значения диаметра в 3 столбце. Определяется диаметр изоляции с помощью алгоритма PipeInsulation.

Алгоритм PipeInsulation сравнивает значение в столбце со значением параметра Внешний диаметр у соответствующей категории, т.е. для Материала изоляции труб плагин будет смотреть значения наружного диаметра у труб, соответственно для Материала изоляции воздуховодов у воздуховодов. На основании данного сравнения параметров, будет происходить определение значения для записи в параметр, вызывающий алгоритм. Плагин находит в столбце либо такое же значение, либо большее, но максимально близкое и полученное из столбца значение записывается в параметр, вызывающий алгоритм.

Пример:     

в проекте с требованиями BIM 20.1Р, элементам изоляции с именем типа начинающимся на Цилиндры навивные из каменной ваты с группой горючести - НГ*, при толщине изоляции = 50 мм, наружный диаметр трубы = 100 мм, в таком случае для изоляции запишется значение диаметра 108 мм.

• 4 столбец - Толщина изоляции

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

Если в модели не будут найдены элементы с толщинами, указанными в таблице - записи значений не произойдет.

Заполнение рабочих таблиц

Плагин ориентируется на название листов и обрабатывает элементы исходя из логики плагина.

Лист Пропустить

На листе Пропустить указываются свойства элементов, на основании которых, указанные элементы будут игнорироваться, т.е. плагин не будет их обрабатывать. В названии столбцов указывается необходимый параметр, по которому будет проходить фильтрация, в строках столбца указываются значения параметра.

Пример:     

плагин не будет обрабатываться элементы категории Типовые аннотации и Элементы узлов.

Если в рамках определенной таблицы нужно отрабатывать всё, без исключений, то на листе Пропустить ничего не нужно заполнять и оставить его пустым, но не удалять, не переименовывать сам лист.

Листы Параметры (обязательный)

Листов с названием начинающимся на “Параметры” может быть несколько. В имени листа после слова “Параметры” может идти любое другое слово или словосочетание без пробелов и других символов.

Пример: ПараметрыИмя

На таких листах правила заполнения одинаковые и соответствуют логике работы.

Другие листы

Листы с другими названием несут вспомогательный характер и не обрабатываются плагином.

Логика работы

Логика работы плагина заключается в том, что плагин заполняет значения параметрам по правилам, описанным в рабочей таблице.

В рабочей таблице заполняется:

• Целевой параметр - в какой параметр будет происходить запись значения. Параметры заполняемые плагином должны быть по экземпляру;
• Формула - значение, которое заполнится в параметр;
• Критерий или фильтр, по которому плагин определяет, какому элементу в параметр запишется значение. Фильтр - это любой параметр или несколько параметров, по значению которых происходит выборка (фильтрация) элементов для заполнения параметров.

Пример:     

Подробнее в блок-схеме.

При записи формул можно использовать символы, описанные на листе Настройки, и алгоритмы, прописанные в коде.

Пример:     

Функционал

Запись формул

1.  Конкретное значение - текстовое или числовое значение записывает в формулу без каких-либо дополнительных символов.
   Пример:       
   
   
2. Алгоритмы - это последовательность действий для получения определенных результатов, прописанные в коде, и выполняемые при наличии вызова алгоритма в формуле в соответствии с описанными символами на листе Настройки. 
   • алгоритм ВСЕГДА вызывается символами <# #>

   Перечень алгоритмов:

   • ParentToChildParameter - это алгоритм перезаписи значения параметра из родительского семейства в аналогичный параметр вложенного семейства, т.е. правило записывается для родительского семейства, у которого склейка получит вложенные и им перезапишет значение параметра;
     
     
   • PipeInsulation - это алгоритм подбора диаметра изоляции;
   • SpaceName - этот алгоритм определяет в каком пространстве располагается элемент и записывает Имя этого пространства;
   • SpaceNumber - этот алгоритм определяет в каком пространстве располагается элемент и записывает Номер этого пространства;
   • GroupName - этот алгоритм определяет в какую группу входит элемент и записывает Имя этой группы;
     Пример:     
     
3. Функции - это действие выполняемые при наличии символа в формулах. Символы, которые вызывают функцию, описаны на листе Настройки.
   
   

   Описание функций и правила записи смотрите в таблице. перечислю некоторые функции, являющиеся основополагающими:

   • функция записи значения из другого параметра ВСЕГДА вызывается символами < >

   Пример:   
   

   • функция записи расчетного значения вызывается символами <Fn( )>
   • функция перевода единиц измерения вызывается символами { }

   
   
   

   Всем элементам категорий перечисленных в 3 столбце в параметр MEP_Количество_Расчетное запишется расчетное числовое значение из системного параметра Длина с конвертацией в метры умноженное на числовой коэффициент 1.1. Если Длина = 5 метров, то в параметр MEP_Количество_Расчетное запишется значение 5,5. Для категории Материалы изоляции воздуховодов запишется расчетное числовое значение из системного параметра Площадь с конвертацией в кв. метры умноженное на числовой коэффициент 1.3.

   при сложной многоуровневой записи расчетного значения, каждый новый расчет вызывается внутри уже открытой функции с помощью тех же символов <Fn( )> (принцип матрешки)

   
   

   • функция склеивания нескольких отдельных значений и записи их в один параметр выполняется последовательным перечислением необходимых значений/функций/алгоритмов в соответствии с синтаксисом

   
   

   Всем элементам категории Оборудование в параметр MEP_Размер сводный запишутся значения параметров MEP_Ширина 1 и MEP_Высота 1 через знак “х”. Параметры записываются с использованием вспомогательных символов, описанных на листе Настройки. Значение, которое запишется: 700х500

   
   
   

   В зависимости от типа данных параметра, в формулу можно указывать различные символы/функции/алгоритмы

   Если же значение параметра, участвующего в формуле, равно 0 или “нет”, то запись будет произведена на пустоту или 0:

   • для параметров с текстовым типом данных:
     • если значение 0, то перезапишется на пустоту
     • если значение “нет”, то перезапишется на пустоту
     • если значение параметра отсутствует, т.е. пустота, то перезапись произойдет на пустоту;
   • для параметров с числовым типом данных:
     • если значение 0, то перезапишется на 0
     • если значение параметра отсутствует, т.е. пустота, то, в случае отсутствия значения в целевом параметре перезапись произойдет на пустоту, в случае наличия какого-либо значения, перезапись произойдет на 0

   
   

   Если же значение параметра, участвующего в формуле, имеет тип данных Да/Нет, то запись в целевой текстовый параметр будет произведена на текстовое значение Да/Нет

   
   
   результат:
   
   

   • функция принудительной записи пустого значения (затирании ранее заполненных данных) вызывается символами empty, без каких-либо дополнительных символов

   
   
   

   • функции округления числового значения вызываются символами round/roundup/rounddown, заключенные в символы < >, а значение для округления в символы ( ). Если функция округления вкладывается в другую, например, в расчетную функцию <Fn( )>, то функция округления также заключаются в символы < >

   
   
   
   
   

4. Запись в параметр с типом данных Да/Нет - функция записывает значение в зависимости от вызываемого символа, это текст с большой буквы или Да, или Нет соответственно, без каких-либо дополнительных символов.
   Пример:   
   

   Всем элементам, у которых в параметре MEP_Подключение ЭОМ значение Да, запишется в параметр MEP_Учитывать в спецификации запишется значение Да, всем элементам, у которых в параметре MEP_Подключение ЭОМ значение Нет, запишется в параметр MEP_Учитывать в спецификации запишется значение Нет.

   Фильтрация

   Каждое правило описанное в сроке будет записываться тем элементам, которые соответствуют фильтрации, заданной в 3 и последующих столбцах. Если фильтрация не задана для строки, т.е. в 3 и последующих столбцах пусто, то правило будет записываться всем обрабатываемым элементам модели.

   В шапке для 3 и последующих столбцов указывать имя параметра, на основании которого будет производиться выборка элементов.

   Фильтрация может производиться по конкретному значению, по части значения, по параметрам с типом данных Да/Нет.

1. Конкретное значение
   В 3 и последующих столбцах строки указывается конкретное значение.
   Пример:     
2. Часть значения
   Для фильтрации по части значения используется функция вызываемая символом *, описано на листе Настройки.
   

   *

   в колонку с именем параметра

   если параметр у элемента присутствует (и содержит любое значение), то элемент пройдёт через фильтр и правило к нему применится

   
   

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

   • только символ *

   это будет означать, что в выборку по данной строке попадут элементы с любым значением параметра, но не пустым
   Пример:
   
   

   • символ * после текста (в конце):
     указывается интересующее начало значения, далее символ *
     это будет означать, что в выборку по данной строке попадут элементы с значением параметра начинающимся на то, что указано до символа *
     Пример:  
   • символ * до текста (в начале):
     указывается символ * далее интересующие значения
     это будет означать, что в выборку по данной строке попадут элементы с значением параметра заканчивающимся на то, что указано после символа *
     Пример:
     
     
     
   • одновременно до и после текста (и в начале и в конце):
     указывается символ * далее интересующие значение, далее символ *
     это будет означать, что в выборку по данной строке попадут элементы с значением параметра содержащим, указанное между символами * значение
     Пример:
     
     
   • в середине текста:
     для этого необходимо сделать два столбца с одним и тем же названием параметра, в одном указывается интересующее начало значения, далее символ *, во втором указывается символ * далее интересующие значения
     это будет означать, что в выборку по данной строке попадут элементы с значением параметра начинающимся на то, что указано до символа * в одном столбце и заканчивающимся на то, что указано после символа * во втором столбце
     Пример:
     
     
3.  Параметры с типом данных да/нет.
   Если необходимо записывать правила в зависимости от параметров с типом данных да/нет, то запись значения необходимо производить в виде функции вызываемой символами Да и Нет, с большой буквы.
   Пример:  
4. Параметры с отсутствием значения

   Если необходимо записывать правила в зависимости от параметров, у которых отсутствует значение, т.е. равно “пустоте”, используется функция вызываемая символами empty,  описано на листе Настройки.

   Пример:    
5. И/Или/Не
   • Если необходимо записывать правила всем элементам, кроме каких-то определенных, то запись значения необходимо производить в виде функции вызываемой символами not(), в скобках указывать значение, по которому элементы будут исключаться из выборки для заполнения правила, описано на листе Настройки.

   Пример:  
   

   Таким образом не нужно дублировать строки с один и тем же правилом, перечисляя в каждой строке характеристики для заполнения.

   • Если необходимо записывать правила элементам с несколькими вариантами значения параметра фильтрации, которые должны одновременно соблюдаться, то запись значения необходимо производить в виде функции вызываемой символами () and (), в скобках указывать разные варианты значения параметра, описано на листе Настройки.
     Пример:
     
     
     

   Таким образом не нужно дублировать строки с один и тем же правилом, перечисляя в каждой строке характеристики для заполнения.

   • Если необходимо записывать правила элементам со значением параметра равному любому из перечисленных значений, то запись значения необходимо производить в виде функции вызываемой символами () or (), в скобках указывать разные варианты значения параметра, описано на листе Настройки.
     Пример:
     
     

     Таким образом не нужно дублировать строки с один и тем же правилом, перечисляя в каждой строке характеристики для заполнения.

     Данные функции можно объединять в ячейке, соблюдая синтаксис,  описано на листе Настройки.

     Пример:
     
     
     

Приоритет

Первоначально порядок отработки формул делится на группы:

1. Первыми отрабатываются формулы с текстом или числом, т.е. значения не зависящие от других параметров (без использования < >, расчетных функций, алгоритмов типа Fn);
2. Вторыми отрабатываются формулы содержащие обращение к другим параметрам (заключенные в < >), но без обращения к расчетным функциям (алгоритмам типа Fn);
3. Предпоследними отрабатываются формулы содержащие обращение к другим параметрам и вызывающие расчетные функции (алгоритмы типа Fn);

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

Пример:

на одном из листов заполняется параметр для элементов MEP_Размер сводный, а на другом листе для этих же элементов, но с другими критериями выбора, заполняется параметр PIC_Наименование_по_ГОСТ на основе заполненного ранее параметра MEP_Размер сводный.

Соответственно сначала отрабатывается заполнение параметра MEP_Размер сводный, а потом PIC_Наименование_по_ГОСТ.

Далее, в рамках каждой группы порядок отработки происходит по следующему принципу:

• Формулы отрабатываются по принципу “от общего к частному”, в зависимости от критериев определения элементов.

Пример:

для одного и того же параметра задано несколько формул: одна общая на все элементы модели, остальные две для определенной категории. Соответственно сначала плагин отрабатывает общее правило, а далее частные на указанные категории (т.е. перезаписывает значение).

Таким образом, если критериев по определению элементов несколько, то элемент с наибольшим количеством критериев обработается в последнюю очередь.

• При наличии нескольких формул с одинаковыми критериями выбора, они отрабатываются по последней строке с формулой в зависимости от расположения строки в таблице.

  Если выборка элементов по критериям равнозначна по количеству правил, а также одинакова по содержанию и формулы применены на один и тот же параметр, то приоритет распределяется построчно, чем ниже строчка - тем выше у нее приоритет.

  Пример:
  
  

  для одного и того же параметра, назначены разные формулы, но критерии выбора элементов одинаковые: Категория - Оборудование, BDS_Class - Стояки, Классификация систем есть *Приточная* и *Обратная*, таким образом на выбранные элементы приходится по 3 правила.
  Соответственно элементам запишется формула указанная в последних строках с подобными критериями.

  Самыми последними отрабатываются формулы содержащие символ “@”. После отработки всех строк в рамках общего распределения приоритета, обрабатываются строки с функцией ExpressionRepeatRowToken вызываемая символом “@” (описано на листе Настройки), которая определяет повторно обрабатываемые строки. В рамках этой функции приоритет распределяется согласно общим правилам, описанным выше.

  P.S. Если в Таблице с правилами и в данной инструкции есть несостыковки - обратитесь к ответственному за плагин для корректировки информации. Приоритетным источником по правилам записи формул является Таблице с правилами.

Возможные ошибки