Кнопка “Заполнение параметров”

Для выпуска спецификаций и аксонометрий необходимо заполнить все параметры у семейств. Окно обрабатывает: трубы, гибкие трубы, воздуховоды, гибкие воздуховоды, фитинги и арматуру труб/воздуховodов, оборудование (включая сантехприборы и спринклеры), изоляцию и «условные материалы» (см. ниже)

Возможности автоматического заполнения

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

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

Для успешной работы плагина необходимо заполнить следующие параметры перед его запуском

1. …Огнезащита. У типоразмеров изоляции воздуховодов, показывает какая изоляция является огнезащитной, на основании этого параметра будет присваиваться толщина воздуховодов и его класс
2. Имя системы: всем элементам с коннекторами должна быть присвоена система. Имя системы должно заполняться согласно статье об именах систем
3. …Префикс имени должен быть указан у всех системных семейств(трубы,воздуховоды,изоляция) и у соединительных деталей воздуховодов
4. …Формула. Для системных семейств должно быть указан тип расчета наименования. Этот параметр показывает плагину формат, в котором  будет заполнена информация о наименовании элемента. В этом параметр необходимо вводить значения только из таблицы 2
5. …Открывание. Для арматуры воздуховодов, которая передается в качестве задания для раздела СС, в типе семейства нужно указать «НО» или «НЗ». Этот параметр задается внутри семейств арматуры воздуховодов
6. …Единица измерения для изоляции труб и воздуховодов, показывает плагину в каких единицах будет измеряться данный вид изоляции. Допустимые значения: м, м2, м3 (без точек и запятых)

Проверку заполнения этих параметров можно ввести кнопкой “Проверка параметров”

Какие параметры обрабатывает плагин

Сводная таблица всех параметров, которые кнопка «СТАРТ» записывает на элементы (подробное описание логики каждого — в соответствующих разделах ниже). Столбец «Имя параметра» — стандартное (заводское) значение из настроек плагина (settingsHVACVK.json); если у вас настройки не менялись, оно совпадает с тем, что видно в самом Revit.

Общие параметры (трубы, воздуховоды, гибкие элементы, изоляция, арматура/фитинги, оборудование)

Только для воздуховодов и их фитингов

Только для арматуры/фитингов

Условные материалы (записывается в семейство‑родитель)

Оборудование кондиционирования (только при включённой опции «Внутренние блоки кондиционирования»)

Все значения копируются с типоразмера «наружного блока» на все «внутренние блоки» той же системы (параметры без отдельного «дружественного» имени в настройках — заданы напрямую по GUID):

Данные параметры необходимы для получения ХОВС систем кондиционирования. Для этого есть отдельная статья в базе знаний

Главный принцип: «Заполнять параметры» и «ПЕРЕЗАПИСАТЬ ПАРАМЕТРЫ»

Почти всё в этой вкладке подчиняется одному правилу , поэтому его стоит понять один раз:

1. Если у элемента вообще нет нужного параметра — элемент попадает в список ошибок, ничего не пишется.
2. Если параметр доступен только для чтения — пропускается.
3. Если чекбокс «Заполнять параметры» (левый блок в шторке) для этого поля выключен — поле не трогается вообще, независимо от второго чекбокса.

4. Если у параметра сейчас нет значения (пусто/0) — он заполняется всегда (как только «Заполнять» включено), независимо от чекбокса перезаписи.

5. Если значение уже есть — оно перезаписывается только если включен соответствующий чекбокс в блоке «ПЕРЕЗАПИСАТЬ ПАРАМЕТРЫ»

То есть «Заполнять параметры» — общий выключатель по полю («трогать ли его вообще»), а «ПЕРЕЗАПИСАТЬ ПАРАМЕТРЫ» — разрешение перебивать уже введённые вручную значения. Так работают: Наименование, Группирование, Уклон, Количество, Имя/Тип системы, Отметка, Этаж, Масса, Позиция на схеме, Id пространства.

Из этого правила выпадают (обрабатываются по своей отдельной логике, описанной в соответствующих разделах ниже): двойная изоляция (пишется всегда), условные материалы (учитывают только чекбокс «Количество», без «Заполнять»)

Формулы наименования

Формула хранится в параметре типа «…Формула» и определяет, что плагин запишет в параметр «…Наименование». Есть два режима: простые «номерные» шаблоны (зашиты в коде под конкретную категорию) и полный формульный движок (если текст содержит $).

Простые номерные шаблоны (без $)

Если номер не распознан или формула пуста — в «Наименование» попадает подсказка‑заглушка («Введите номер формулы» / «Введите формулу» / «Введите префикс»), чтобы сразу было видно, что тип не настроен.

Полный формульный движок (формула содержит $)

Если в «…Формула» есть символ $, весь текст разбирается движком FormulaParameterHelper.GetValueByFormula. Формула — это список кусков через +. Каждый кусок — либо обычный текст (вставляется как есть), либо один из токенов ниже.

Ссылка на параметр:

• $ИмяПараметра — берёт значение параметра с этим именем у самого элемента (экземпляр или тип).
• @ИмяПараметра — для элементов изоляции: берёт значение у хоста (трубы/воздуховода, на который надета изоляция), а не у самой изоляции. Если у элемента‑владельца (арматуры/фитинга) такого параметра нет — плагин попробует найти его у соседней трубы/воздуховода, подключённой через коннектор.

Форматирование чисел — суффикс сразу после имени параметра:

• $Длина$$2 — округлить до 2 знаков, с сохранением конечных нулей (50.00).
• $Длина$$$2 — округлить до 2 знаков и обрезать лишние нули (50 вместо 50.00).
• Без суффикса — округление до 2 знаков по умолчанию.

Типы значений при подстановке параметра: текстовые — как есть; длины/диаметры (Length, PipeSize) — переводятся из футов в мм; числовые (Number) — как есть; углы (Angle) — переводятся из радиан в градусы; всё остальное — через AsValueString().

Специальные макросы (используются как отдельный кусок формулы, пишутся ровно так, включая квадратные скобки):

Примеры формул наименования элементов

Изоляция

Обычная (одиночная) изоляция

Для каждого элемента изоляции (труба/воздуховод/обкладка/изоляция на арматуре или фитинге), если он не входит в Revit‑группу, шаг заполнения считает:

• Наименование — по формуле типа (см. раздел выше). Для изоляции на арматуре есть особый случай: если включён чекбокс «Специальная изоляция на арматуру» (раздел «ПРОЧЕЕ»), имя всегда будет «Изоляция на арматуру <имя арматуры>», формула типа при этом игнорируется. Если чекбокс выключен — для арматуры/фитингов сначала плагин пытается скопировать имя с изоляции соседней трубы/воздуховода (если у всех подключённых соседей имя совпадает), и только если соседей нет или они дают разные имена — считает по формуле.
• Количество — единица измерения берётся из параметра типа «…Единицы измерения» (м, м²/м2, м³/м3):
  • на трубе/воздуховоде: длина — CURVE_ELEM_LENGTH; площадь — RBS_CURVE_SURFACE_AREA; объём — RBS_INSULATION_LINING_VOLUME; итог умножается на коэффициент запаса изоляции (поле «Коэффициенты запаса → Изоляция»).
  • на арматуре/фитинге: длина берётся из параметра «…Длина» на самой арматуре, если его нет — как половина диагонали её bounding box; площадь — из параметра «…Площадь», если его нет — из геометрии (SurfaceArea × 0.6, поправочный коэффициент); объём — прямо из геометрии (Solid.Volume).
• Масса — сначала пробует взять объём из RBS_INSULATION_LINING_VOLUME; если там 0 — считает объём по фактической геометрии (Solid.Volume); умножает на «…Плотность» типа.

Двойная изоляция

Нужна, когда на трубу/воздуховод ставится два слоя изоляции разных типов (например, основной теплоизоляционный слой + тонкий защитный/противопожарный слой сверху) — как два отдельных элемента изоляции Revit на одном хосте, и при этом их количество нельзя просто сложить, не корректируя объём/площадь на то, что один слой лежит поверх другого.

Требуется настроить у ТИПА второго (или обоих) слоя изоляции 3 скрытых параметра, которые не входят в обычный список настроек плагина и добавляются только по GUID:

Если у типа изоляции не заполнены первые два параметра (толщина и формула) — этот элемент двойной изоляцией не считается и обрабатывается только обычным шагом выше.

Как ищется пара: плагин группирует ВСЕ изоляции, у которых заполнены оба скрытых параметра, по ключу «Тип системы» + вычисленное по формуле имя. Внутри одной группы должно быть минимум 2 изоляции, надетые именно на трубу или воздуховод (не на арматуру/фитинг) — иначе элемент помечается предупреждением и пропускается.

Что происходит с найденной парой:

1. Из пары выбирается элемент, чей типоразмер уже называется с окончанием «второй слой» (если такого нет — берётся просто первый по Id); второй элемент пары — оставшийся.
2. Если задана единица измерения второго слоя — для выбранного элемента создаётся (или используется уже существующий) дублированный типоразмер с припиской «второй слой» и этой единицей измерения, элемент переключается на этот типоразмер.
3. Ему присваивается «Наименование» по формуле (см. «Формула второго слоя»).
4. Ему же присваивается суммарное количество всех изоляций всей группы (не только пары) — это количество считается заново под единицу измерения второго слоя, с поправкой на геометрию (для м²/м³ — площадь/объём слоя с учётом реального радиуса трубы или ширины/высоты воздуховода, а не просто сложение исходных чисел).
5. Второму элементу пары присваивается скорректированное количество — из его собственного значения вычитается доля, приходящаяся на слой такой-то толщины (по формулам сечения трубы/прямоугольного воздуховода), чтобы не задваивать материал в спецификации.
6. Остальные изоляции той же группы (если их больше двух) получают такую же индивидуальную корректировку количества.

Важно: и «Наименование», и «Количество» для двойной изоляции записываются всегда, независимо от чекбоксов «Заполнять»/«Перезаписать».

Условные (вспомогательные) материалы

Чтобы расчитать условные материалы нужно разместить семейство арматуры на нужные системы. И в каждом выбрать в прочее нужный материал.

«Материалы» — это вложенные (nested) семейства‑заглушки категории «Парковка» (OST_Parking), размещённые внутри семейства‑родителя (арматуры, фитинга, оборудования и т.п.) как вложенный компонент. Категория «Парковка» используется здесь чисто технически — как категория, которую реально не используют в инженерных моделях, чтобы не пересекаться с обычными элементами. Каждый такой вложенный «материал» описывает один вид сопутствующего материала (крепёж, прокладки, грунтовка и т.п.), количество которого зависит от типа системы и формулы, заданной на его типоразмере.

Как считается количество:

1. Материал пропускается, если: занят другим пользователем (рабочие наборы), находится в Revit‑группе, или у него нет родителя.
2. Определяется «…Тип системы»: сначала смотрят на сам материал, если пусто — пробуют взять с родителя (и синхронизировать материал), если и там пусто — ищут подключённый к родителю через коннектор элемент с заполненным «…Тип системы» и синхронизируют обоих. Если тип системы определить не удалось — материал пропускается с ошибкой.
3. Берётся текст «…Формула» у типоразмера материала — он определяет метод расчёта количества (см. таблицу ниже). Если формула пустая — количество не пересчитывается, остаётся как было.
4. Полученное количество умножается на общий коэффициент запаса «Трубы и воздуховоды» (там, где это уместно по методу).
5. Результат пишется не в сам материал, а в один из параметров родительского семейства — «1 Материал количество» … «5 Материал количество». Какой именно слот — определяет параметр «…Позиция в комплекте» (число 1–5) на материале (либо, если такого параметра нет, резервный параметр семейства «Порядок в родительском семействе»).
6. Запись происходит, если у материала «…Количество» ещё не заполнено (0) ИЛИ включён чекбокс «Перезаписать → Количество» — чекбокс «Заполнять → Количество» здесь не участвует.

Распознаваемые методы расчёта («…Формула» на типоразмере материала):

Элементы внутри Revit‑групп (модельные группы)

Если элемент физически находится в Revit‑группе (то есть был
объединён командой Revit «Создать группу»), обычные шаги заполнения
(по трубам, воздуховодам, фитингам, изоляции и т.п.) пропускают такой
элемент — иначе Revit заставлял бы редактировать группу по одному элементу за
раз, что медленно и может рассинхронизировать одинаковые копии группы.

Вместо этого перед всеми остальными шагами выполняется отдельный проход:
для каждого уникального типа групп в модели плагин открывает группу на
редактирование, находит внутри неё трубы, гибкие трубы,
воздуховоды, гибкие воздуховоды, изоляцию, фитинги/арматуру/воздухораспределители,
оборудование и вложенные семейства — и применяет к ним те же самые функции
заполнения параметров (наименование, количество, масса и т.д.), что и для
обычных элементов, но один раз на уникальный тип группы, после чего изменения
закрываются и распространяются на все экземпляры этой группы
в проекте.

Условные материалы (категория «Парковка») и округление количества до целого (см. ниже) с элементами внутри Revit‑групп не работают — такие
материалы/элементы просто пропускаются этими шагами (отсюда и подпись у
чекбокса «Округлить до целого» — «не работает с группами»).

Имена систем

Важно не путать 4 разных поля — «сырое» имя системы Revit и три параметра плагина, которые из него получаются. Разберём на примере: к блоку кондиционирования подключено сразу 3 системы Revit — «К0.1.С1‑Х3» (подача фреона), «К0.1.С1‑Х4» (обратка фреона) и «Д3‑Т8» (дренаж/конденсатоотвод).

Итого: проще всего задать «…Имя системы» / «…Тип системы» / «Класс систем» один раз вручную на самой системе (ПКМ по системе → Свойства) — и дальше кнопка будет просто копировать эти значения на все трубы/воздуховоды/арматуру и вложенные семейства этой системы, не пересчитывая их заново. Если же вы полагаетесь на автовычисление первых двух — раздел ниже и приложение в конце этой инструкции объясняют, как должно быть названо само «сырое» имя системы в Revit, чтобы автоматический разбор сработал правильно.

Блок «ФОРМИРОВАНИЕ ИМЕНИ СИСТЕМЫ» определяет, из какого «сырого» поля Revit берётся основа для имени системы — выпадающий список «Исходное имя системы»:

• Имя системы (штатное имя MEP‑системы в Revit);
• Сокращение типа системы;
• Комментарий к экземпляру системы;
• Имя типоразмера системы;
• Комментарий к типоразмеру типа системы;
• Описание типа системы.

Ниже — таблица live‑предпросмотра на первой найденной в проекте системе: исходное значение, что получится в «…Имя системы», что получится в «…Тип системы» (объединяет подачу и обратку одной системы, нужен для спецификаций) и что получится в «Класс сети» (нужен, чтобы весь приток шёл раньше вытяжки в спецификациях). Таблица пересчитывается сразу при смене пункта в выпадающем списке — можно подобрать нужный источник до запуска обработки.

Итоговые «Имя системы»/«Тип системы» вычисляются автоматически по внутренним правилам плагина на основе выбранного источника (например, приводят имена теплосетей вида «Т1 1» к базовому коду «Т1», объединяют парные системы и т.п.) — в спорных случаях удобнее свериться с предпросмотром, чем угадывать заранее

Это конвенция именования MEP‑систем в Revit от которой напрямую зависит, что автоматически получится в «…Имя системы» и «…Тип системы», когда эти поля не заполнены на самой системе вручную. Речь именно про то, как называется сама система (ПКМ по системе → Свойства → Имя системы), а не про параметры отдельных труб/воздуховодов. Ниже будет блок о том как мы должны называть ситсемы. Их можно смотреть как в параметре системе, так и в дистпечере инжерных систем

ОВ1 — тепловые сети (отопление / теплоснабжение)

Разбор примера имени «Т12‑МОП2»:

• Т/T — буква «Т»: русская — для отопления, английская (T) — для теплоснабжения;
• первая цифра после буквы (1) — подача (1) или обратка (2);
• вторая цифра (2) — порядковый номер системы;
• всё после дефиса (МОП2) — произвольный комментарий к системе.

Если систему по каким‑то причинам не удаётся смоделировать одной цельной Revit‑системой — можно после пробела дописать что угодно, например «Т12‑МОП2 23»; этот «хвост» после последнего пробела будет отброшен при вычислении «…Имя системы».

Запрещено использовать пробел внутри самого комментария системы — систему нельзя называть «Т12 МОП2» (два слова через пробел вместо дефиса), иначе разбор имени сломается.

• Формула «…Имя системы»: убрать всё, что идёт после последнего пробела → «Т12‑МОП2» (даже если исходно было «Т12‑МОП2 23»).
• Формула «…Тип системы»: оставить порядковый номер системы, а вместо буквы и индикатора подача/обратка поставить «СО» (отопление) или «СТ» (теплоснабжение) → «Т12‑МОП2» становится «СО2‑МОП2» (объединяет подачу и обратку одной системы в одну строку для спецификации).

ОВ2 — вентиляция (приток / вытяжка / дымоудаление / подпор)

Для вентиляции подача/обратка не различаются, поэтому:

• Формула «…Имя системы»: полный перенос имени системы без изменений («П1» → «П1», «ПД13» → «ПД13»).
• Формула «…Тип системы»: тоже полный перенос, совпадает с «…Имя системы».

ОВ3 — холод, фреон, рециркуляция, дренаж

• Формула «…Имя системы»: полный перенос из системного параметра имени системы, без изменений.
• Формула «…Тип системы»: после дефиса убираются все символы, включая сам дефис → «К23‑Х3» становится «К23» (объединяет ветки Х1/Х2/Х3/Х4 одного контура в одну строку для спецификации).

Системы кондиционирования — назначение по типу помещений

Отдельная конвенция для контуров кондиционирования (К0…К10 — код закреплён за назначением помещений, где стоят внутренние блоки), пример полного разбора:

«…Тип системы» здесь получается тем же правилом ОВ3 (обрезка после дефиса, включая дефис): «К0.1.С1‑Х3» → «К0.1.С1». «НБ» в «…Позиция на схеме» — наружный блок кондиционера; «ВБ» — внутренний блок.

Прочие настройки окна

• Коэффициенты запаса — «Изоляция» и «Трубы и воздуховоды»: множители, на которые умножается расчётная длина/площадь/объём при заполнении «…Количество» у труб, воздуховодов, гибких элементов и изоляции.
• Округлить до целого (не работает с группами) — суммирует «…Количество» всех элементов с одинаковым «Тип системы» + «Наименование» и распределяет между ними округлённую вверх сумму пропорционально их доле (нужно, чтобы общая длина по позиции спецификации была целым числом). Не применяется к элементам в Revit‑группах.
• Только элементы на активном виде — ограничивает обработку элементами, видимыми на текущем виде (иначе обрабатывается весь проект).
• Уровни для параметра «Этаж» — дерево уровней слева; снятые галочки исключают уровень из числа кандидатов при определении «Этажа» элемента по геометрии (высоте) — элемент «прилипнет» к ближайшему из оставшихся отмеченных уровней.
• Специальная изоляция на арматуру — см. раздел «Изоляция» выше.
• Площадь воздуховодов в примечании — при включении отдельным шагом суммирует площадь поверхности всех воздуховodов одной системы («…Тип системы») и записывает суммарную площадь (м², округлённо до 2 знаков) в параметр «…Примечание» каждого воздуховода этой системы.
• Внутренние блоки кондиционирования — для систем, чьё «…Тип системы» содержит букву «К» (кондиционирование): среди сгруппированных по системе блоков находится «наружный блок» (по флагу на типоразмере) и его характеристики (марка, мощность, напряжение, холодопроизводительность, масса, габариты, расход воздуха, шум, позиция, комментарий) копируются на все «внутренние блоки» той же системы, плюс проставляется общее число внутренних блоков.
• MagiCad — при включении подтягивает расход воздуха/воды из параметров MagiCad (magi_ducting_qv, magi_piping_qv) в параметры плагина, если у MagiCad значение задано, ненулевое и отличается от текущего, а у нас поле ещё не заполнено; также заполняет «MC System Code» у MEP‑систем именем системы Revit.
• Формула для объединённого параметра + чекбоксы «Сорт. по формуле» / «Объединённый параметр для сортировки» — считает значение по той же формуле, что и «Наименование» (тот же язык $/@/макросы), но по формуле, введённой прямо в это текстовое поле (а не по «…Формула» типа), и записывает результат в скрытый служебный параметр (по GUID) на каждом обработанном элементе — удобно для собственного порядка сортировки в спецификациях, не завязанного на «Наименование».
• Класс сети (CheckSystemClass/CheckSystemClass1) — отдельный скрытый параметр (по GUID), определяющий класс/приоритет системы для сортировки в спецификациях; для MEP‑систем без заполненного класса при первом запуске подставляется из «Комментариев типа» системы.
• Нагрузки из ColdBalance — импортирует значения холодовой нагрузки из Excel‑отчёта ColdBalance (лист «Таблица_теплопоступлений») в параметр «Расчётная нагрузка охлаждения» пространств, сопоставляя строки файла с пространствами по числовому Id, зашитому в тексте ячейки.