Инструкция для пользователя плагина по кнопке «Проверка параметров» на ленте Revit
Обязательное условие для запуска
Перед открытием окна плагин проверяет, подключен ли к проекту ФОП (файл общих
параметров — тот, что указан в Revit в разделе «Управление → Общие параметры»). Если
ФОП не подключен, появится сообщение «ФОП не подключен», и окно не откроется вообще.
Многие проверки и кнопки исправления читают определения параметров именно из ФОП по
GUID — поэтому файл должен быть тем же (или содержать те же параметры), что
использовался при настройке проекта.
кладка «Параметры проекта»
Здесь проверяется, добавлены ли к проекту (и правильно ли забиндены — по нужным категориям, экземпляр/тип) параметры, которыми пользуется плагин.
Важно: сначала нужно нажать кнопку «Проверить параметры» внизу вкладки — она запускает саму проверку и заполняет обе колонки. Если сразу нажать «Вывести ошибки» или «Добавить параметры» без этого — плагин попросит сначала нажать «Проверить параметры».
Как проверяется в обоих случаях: для каждого параметра плагин смотрит, существует ли в текущем проекте привязка параметра с таким именем (или GUID — для нескольких служебных параметров без «дружественного» имени в настройках плагина) к нужным категориям, в нужном виде (тип/экземпляр), с нужной настройкой «может изменяться по группе». Все параметры этого набора биндятся в группу Revit «Текст» (поле «Группировка параметров под:» в свойствах параметра проекта).
- Кнопка «Вывести ошибки» — показывает список параметров, которые отсутствуют или привязаны неправильно.
- Кнопка «Добавить параметры» — пытается автоматически добавить и правильно привязать недостающие параметры, взяв их определение из подключенного ФОП (по GUID). Если какой-то параметр не найден в самом ФОП — он попадёт в список ошибок («Параметр с GUID … не найден в ФОП»); такой параметр нужно либо добавить в ФОП вручную, либо подключить правильный ФОП.
Ниже — две таблицы: обязательные параметры (проверяются кнопкой «1») и дополнительные рекомендованные (проверяются кнопкой «1.1» — при этом «1.1» на самом деле повторно проверяет и весь набор из первой таблицы тоже, плюс пять дополнительных). Столбец «Имя параметра» — это реальное значение из настроек плагина на этой машине (settingsHVACVK.json); если у вас настройки не менялись, оно совпадает со значением по умолчанию.
«Базовый набор категорий» (используется у большинства параметров) — это 22 категории: Антураж, Арматура воздуховодов, Арматура трубопроводов, Воздуховоды, Воздуховоды по осевой, Воздухораспределители, Гибкие воздуховоды, Гибкие трубы, Изоляция воздуховодов, Изоляция воздуховодов (обкладка), Изоляция трубопровода, Обобщённые модели, Оборудование, Паркинг (условные материалы), Санитарные приборы, Соединительные детали воздуховодов, Соединительные детали трубопроводов, Специальное оборудование, Спринклеры, Трубы, Трубы по осевой, УГО изоляции.
1. Наличие необходимых параметров проекта
| Имя в настройках | Имя параметра | Тип/экземпляр | Категории | Может изменяться по группе | Группировка параметров | Описание |
|---|---|---|---|---|---|---|
GroupParam | …Марка спецификации | Тип | Базовый набор | — | Текст | Значение для группировки/сортировки строк в спецификации (марка спецификации) |
UnityParam | …Единицы измерения | Тип | Базовый набор | — | Текст | Единица измерения количества элемента (шт/м/м²/м³) — используется при расчёте «…Количество» |
ExpectParam | …Исключить из спецификации | Тип | Базовый набор | — | Текст | Отметка, что типоразмер нужно исключить из подсчёта в спецификации |
Formula | …Формула | Тип | Базовый набор | — | Текст | Формула расчёта «…Наименование» |
Complect | …Позиция в комплекте | Тип | Базовый набор | — | Текст | Для сортировки вложенных семейств |
PrefixParam | …Префикс имени | Тип | Базовый набор | — | Текст | Текстовый префикс, подставляемый формулами наименования |
ClassInsulation | …Огнезащита | Тип | Изоляция воздуховодов, Изоляция воздуховодов (обкладка), Изоляция трубопровода | — | Текст | Признак, что изоляция огнезащитная — влияет на определение класса герметичности воздуховода (А/В) |
ValveSetting | …Тип открывания | Тип | Арматура воздуховодов, Оборудование | — | Текст | Состояние арматуры (открыт/закрыт), используется при нумерации позиций на схеме |
Density | …Плотность | Тип | Изоляция воздуховодов/обкладка/трубопровода, Трубы и воздуховоды по осевой, Гибкие трубы/воздуховоды, Трубы, Воздуховоды | — | Текст | Плотность материала (кг/м³) для расчёта массы |
QuantityParam | …Количество | Экземпляр | Базовый набор | Нет | Текст | Расчётное количество элемента (длина/площадь/объём/штуки) для спецификации |
NameParam | …Наименование | Экземпляр | Базовый набор | Да | Текст | Итоговое наименование элемента для спецификации, считается по формуле |
NameSystemParam | …Имя системы | Экземпляр | Базовый набор | Да | Текст | Имя инженерной системы, к которой относится элемент |
TypeSystemParam | …Тип системы | Экземпляр | Базовый набор | Да | Текст | Обобщённый тип системы (объединяет подачу/обратку) для группировки в спецификации |
по GUID 3e840bad-… | Класс систем | Экземпляр | Базовый набор | Да | Текст | Класс инженерной сети — для сортировки (например, чтобы весь приток шёл раньше вытяжки) |
по GUID 99138b62-… | Объединённый параметр для сортировки | Экземпляр | Базовый набор | Да | Текст | Служебное поле для собственного порядка сортировки строк спецификации по формуле пользователя |
AbsoluteCenter | …Отметка расположения (текст) | Экземпляр | Базовый набор | Да | Текст | Текстовое значение отметки (высоты) расположения элемента относительно уровня |
IdSpace | …Id пространства | Экземпляр | Базовый набор | Нет | Текст | Id пространства/помещения, в котором находится элемент |
по GUID afdbac04-… | Номер пространства | Экземпляр | Базовый набор | Нет | Текст | Номер помещения, в котором расположен элемент |
по GUID 6a5b80cd-… | Имя пространства | Экземпляр | Базовый набор | Нет | Текст | Имя помещения, в котором расположен элемент |
по GUID 47b46b53-… | Скорость воздуха | Экземпляр | Воздуховоды, Фитинги воздуховодов, Воздухораспределители, Оборудование, Гибкие воздуховоды, Арматура воздуховодов | Да | Текст | Расчётная скорость воздуха в элементе |
по GUID e6505622-… | Потеря давления | Экземпляр | Воздуховоды, Фитинги воздуховодов, Воздухораспределители, Оборудование, Гибкие воздуховоды, Арматура воздуховодов | Да | Текст | Потери давления на элементе (для аэродинамического расчёта) |
по GUID fc815640-… | КМС | Экземпляр | Фитинги воздуховодов | Нет | Текст | Коэффициент местного сопротивления фитинга |
по GUID fb9e0870-… | КМС2 | Экземпляр | Фитинги воздуховодов | Нет | Текст | Второй (альтернативный) коэффициент местного сопротивления |
по GUID ff2ee03e-… | Класс воздуховода А или В | Экземпляр | Воздуховоды, Фитинги воздуховодов, Арматура воздуховодов | Да | Текст | Буквенный класс герметичности, проставляется автоматически при заполнении наименования |
FloorParam | …Этаж | Экземпляр | Базовый набор + Уровни | Да | Текст | Этаж (текстом), на котором расположен элемент |
NumberLvl | …Номер этажа | Экземпляр | Базовый набор + Уровни | Да | Текст | Номер этажа |
SlopeParam | …Уклон | Экземпляр | Арматура труб/воздуховодов, Трубы/воздуховоды по осевой, Воздуховоды, Воздухораспределители, Гибкие трубы/воздуховоды, Изоляция воздуховодов/обкладка/трубопровода, Фитинги труб/воздуховодов, Трубы | Да | Текст | Угол наклона элемента |
ClassDust | …Класс В без изоляции | Экземпляр | Воздуховоды, Воздуховоды по осевой, Фитинги воздуховодов | Нет | Текст | Флаг «класс герметичности В без изоляции» — влияет на автоматическое определение класса герметичности |
ValveFirePos | …Позиция на схеме | Экземпляр | Воздуховоды, Воздуховоды по осевой, Фитинги воздуховодов | Да | Текст | Позиционный номер клапана/арматуры на расчётной схеме (нумеруется автоматически) |
ThicknessParam | …Толщина стенки | Экземпляр | Воздуховоды, Воздуховоды по осевой, Фитинги воздуховодов, Арматура воздуховодов | Нет | Текст | Толщина металла стенки воздуховода, мм |
«Может изменяться по группе» указана «—» для параметров типа — у них в Revit этой настройки не существует, она относится только к параметрам экземпляра.
1.1 Дополнительные (рекомендованные) параметры проекта
Необязательный, но желательный набор — плагин не считает их отсутствие критичной ошибкой, но некоторые функции («Заполнение параметров», спецификации) без них будут работать не полностью.
| Имя в настройках | Имя параметра | Тип/экземпляр | Категории | Может изменяться по группе | Группировка параметров | Описание |
|---|---|---|---|---|---|---|
CodeParam | …Код изделия | Экземпляр | Базовый набор | Да | Текст | Код/артикул изделия по каталогу производителя |
MassParam | …Масса (число) | Экземпляр | Базовый набор | Нет | Текст | Масса элемента, числовое значение (кг) |
MasstextParam | …Масса (текст) | Экземпляр | Базовый набор | Нет | Текст | Масса элемента в текстовом виде (для вывода в спецификацию вместе с единицей измерения) |
PositionParam | …Позиция | Экземпляр | Базовый набор | Да | Текст | Позиция элемента по спецификации/чертежу |
CommentParam | …Примечание | Экземпляр | Базовый набор | Да | Текст | Свободное примечание к элементу (в частности, сюда пишется площадь воздуховодов при включённой одноимённой опции в «Заполнении параметров») |
Работает так же: «Вывести ошибки» — детальный список, «Добавить параметры» — попытка автодобавления из ФОП.
Вкладка «Семейства»
Проверяются семейства категорий, с которыми работает плагин (воздуховоды, трубы, арматура, оборудование, воздухораспределители, изоляция, фитинги и т.п.).
1. ADSK_Группирование (параметр экземпляра)
Как проверяется: у типоразмера семейства нет параметра «…Марка спецификации» (имя задано в настройках плагина), при этом в проекте этот параметр уже привязан именно как параметр типа к категории данного семейства — то есть настройка семейства конфликтует с параметром проекта.
Как исправить: кнопка «Удалить группирование» — плагин открывает семейство на редактирование, переименовывает встроенный в семейство параметр (в «Группирование по экземляру», чтобы он не совпадал по имени с параметром проекта) и загружает семейство обратно в проект. После этого значение будет браться из общего параметра проекта.
2. ADSK_Единицы измерения (параметр экземпляра)
Проверяется и исправляется полностью аналогично пункту 1, только для параметра «…Единицы измерения». Кнопка «Удалить единицы изм.» переименовывает встроенный параметр семейства в «Единица измерения по экземляру» и перезагружает семейство.
3. ADSK_Этаж (параметр типа)
Как проверяется: у типоразмера семейства есть свой параметр «…Этаж», но в проекте параметр «…Этаж» не привязан как параметр типа к категории этого семейства — то есть семейство хранит значение локально вместо общего параметра проекта.
Как исправить: кнопка «Удалить этаж» — переименовывает параметр внутри семейства в «Этаж по типу» и перезагружает семейство.
4. Имя и тип системы (параметр типа)
Проверяются сразу два параметра типа — «…Имя системы» и «…Тип системы» — по той же логике, что и «Этаж» (пункт 3): семейство считается ошибочным, если у типоразмера есть свой параметр с таким же именем, а в проекте он не привязан к категории этого семейства как параметр типа.
Как исправить: кнопка «Удалить имя и тип системы» — переименовывает оба параметра внутри семейства (в «Имя системы по типу» и «Тип системы по типу») и перезагружает семейство.
5. Настройка коннекторов
Кнопка «Проанализировать семейства» запускает детальную проверку HVAC-коннекторов у семейств четырёх категорий. Автоматического исправления здесь нет — ошибки нужно поправить вручную в редакторе семейства (изменить классификацию системы у коннектора, привязать параметр семейства к нужному значению коннектора и т.п.).
Дополнительно (независимо от категории) для любого семейства проверяется: если параметр «…Марка спецификации» или «…Единицы измерения» существует внутри семейства как параметр экземпляра — это тоже считается ошибкой (эти параметры должны идти только из общего параметра проекта, о котором пункты 1–2 выше).
| Категория | Что проверяется |
|---|---|
Воздухораспределители (OST_DuctTerminal) | Должен быть ровно 1 коннектор. Классификация системы коннектора — «Приточный воздух» или «Вытяжной воздух». Комбинация направления потока и конфигурации потока должна быть одной из 4 допустимых: приточный+«Заданный»+внутрь, вытяжной+«Заданный»+наружу, приточный+«Системный»+наружу, вытяжной+«Системный»+внутрь (конфигурация «Расчётный» у диффузоров недопустима вообще). Если конфигурация «Заданный» — расход коннектора должен быть приравнен к параметру семейства с именем из настройки «Расход воздуха» (по умолчанию «…Расход воздуха»). Потери давления коннектора должны быть приравнены к параметру с именем из настройки «Потеря давления» (по умолчанию «…Потеря давления воздуха») |
Арматура воздуховодов (OST_DuctAccessory) | Должно быть минимум 2 коннектора (ошибка, если 0; предупреждение, если только 1). Классификация системы всех коннекторов — «Global» (обычная арматура, не привязанная к конкретному виду воздуха). Конфигурация потока — «Расчётный» у всех коннекторов. Расход коннектора должен быть 0 (не задан вручную). Направление потока — «не задано». Потери давления должны быть приравнены к параметру «Потеря давления» ровно у одного коннектора (не у 0 и не у нескольких) |
Фитинги воздуховодов (OST_DuctFitting) | Должен быть хотя бы 1 коннектор. Классификация системы всех коннекторов — «Fitting» |
Оборудование (OST_MechanicalEquipment) | Если есть HVAC-коннекторы: классификация — «Global». Конфигурация потока не должна быть «Заданный» (у оборудования расход не может быть жёстко задан на коннекторе). Расход коннектора должен быть 0 |
Вкладка «Типоразмеры»
Все 4 пункта этой вкладки — это только отчёт (список типоразмеров с ошибкой); кнопок автоисправления здесь нет. Исправлять нужно вручную — открыть тип в Revit («Свойства типа») и заполнить нужный параметр
1. Префикс наименования
Проверяются типоразмеры воздуховодов, гибких воздуховодов, изоляции воздуховодов, фитингов воздуховодов, труб, гибких труб и изоляции труб: если у типа есть параметр «…Префикс имени», но он пустой — тип попадает в список ошибок.
2. Проверка имён систем
Проверяются все системные элементы модели (вентиляционные и трубопроводные системы, а не типоразмеры оборудования) — по разным правилам для вентиляции и для труб:
| Тип системы | Когда считается ошибкой |
|---|---|
| Вентиляционная система (приточная/вытяжная сеть) | Имя системы содержит пробел — это признак того, что система осталась с именем «по умолчанию» от Revit (стандартные автоимена вентсистем всегда содержат пробел) и не была переименована по правилам проекта |
| Трубопроводная система | Флагуется, если верно любое из двух: 1) имя содержит пробел; 2) имя содержит букву «Х» и при этом не содержит дефис «-» |
Правильные имена систем должны быть без пробелов; для трубопроводных систем с буквой «Х» в имени — обязательно с дефисом (для систем кондиционирования). Подробнее о правилах заполнения имен систем можно посмотреть в отдельной статье.
3. Проверка единиц измерения изоляции
Проверяются типоразмеры изоляции воздуховодов и труб, у которых уже есть параметр «…Префикс имени» (то есть это «наши» типы, оформленные по стандарту плагина): если у такого типа параметр «…Единицы измерения» пустой — он попадает в список ошибок.
4. Формула не заполнена у параметров
Проверяются типоразмеры воздуховодов, гибких воздуховодов, изоляции воздуховодов, фитингов воздуховодов, труб, гибких труб и изоляции труб: если параметр «…Формула» у типа пустой — тип попадает в список ошибок.
Вкладка «Экземпляры»
Пункты 1–5 — это только отчёт (список Id элементов с ошибкой), без кнопок исправления; пункты 6–7 запускают отдельные операции.
1. Наименование
Проверяются экземпляры всех категорий, с которыми работает плагин: если параметр «…Наименование» пустой и на экземпляре, и на его типе (или отсутствует вовсе) — элемент попадает в список ошибок.
2. Тип системы
Аналогично пункту 1, но для параметра «…Тип системы».
3. Количество
Аналогично пункту 1, но для параметра «…Количество».
4. Элементы в наборах связей
Проверяется рабочий набор (workset) каждого элемента: если его название содержит слово «link» — элемент, скорее всего, случайно оказался в наборе, предназначенном для связанных файлов, а не для модели. Исправление — вручную переместить элемент в правильный рабочий набор.
5. Отзеркаленные элементы
Список всех экземпляров семейств, у которых включён флаг «Отражённый» (Mirrored) в Revit. Проверка носит информационный характер — плагин не переворачивает элементы автоматически, это нужно сделать вручную (например, пересоздать элемент в правильной ориентации).
6. Проверка привязок
Кнопка «Выделите элементы для проверки кратности привязок к осям»:
- После нажатия нужно выделить в модели элементы с линейной геометрией (трубы, воздуховоды и т.п.).
- Для каждого элемента плагин находит ближайшую параллельную ему координационную ось (Grid) и считает расстояние от середины элемента до этой оси.
- Если это расстояние не кратно 5 мм (с допуском около 1 мм) — элемент попадает в список с ошибкой.
Результат — список Id элементов, у которых привязка к осям «некратная». Исправление — вручную сдвинуть элемент так, чтобы расстояние от оси стало кратно 5 мм.
7. Объединённые системы
Две связанные операции для случая, когда один и тот же участок сети нужно учитывать в двух разных системах одновременно (например, Противодымная система + отдельная «общеобменная» копия для расчётов):
- «Создать общеобменную копию» — вы выделяете элементы-«доноры», плагин создаёт их копии на том же месте, назначает копиям специальный типоразмер с припиской «- Не учитывать» (чтобы они не задваивались в спецификациях/расчётах), связывает каждую пару донор↔копия через служебный параметр (хранит Id друг друга) и пытается автоматически соединить копии между собой так же, как были соединены исходники. Требует подключенного ФОП (нужен служебный параметр по GUID) — при его отсутствии выдаст «ФОП не подключен».
- «Проверить положение общеобменных копий» — для всех уже связанных пар донор/копия сравнивает их геометрические границы (bounding box); если оригинал сдвинули, а копию забыли передвинуть вслед за ним — пара попадает в список несовпадений. Исправление — вручную подвинуть (или пересоздать) отставшую копию.