Инструкция для пользователя плагина по кнопке «Разместить радиаторы» на ленте Revit
Что делает кнопка
Кнопка ищет окна (и витражи навесных стен) в границах выбранных пространств (в связанных файлах-архитектуре), под каждым найденным окном/витражом автоматически расставляет радиатор нужной длины из типового семейства «…Радиатор универсальный» с заданными отступами от пола и от стены. Опционально делит расчетную тепловую нагрузку помещения поровну между размещенными в нем радиаторами.
Это избавляет от ручной расстановки радиаторов под окнами и подбора их длины.
Окно: что в нем настраивается
«Выбор пространств»
Один из трех вариантов:
- Весь проект — все пространства модели.
- Активный вид — только пространства, видимые на текущем виде.
- Выделенные пространства — только те, что вы предварительно выделили в модели перед нажатием кнопки.
«Параметры радиатора»
- Смещение от пола (мм) — на какой высоте от уровня пола ставить радиатор. По умолчанию 150 мм.
- Отступ от стены (мм) — зазор между радиатором и стеной. По умолчанию 50 мм.
- % заполнения проема — какую долю ширины окна/витража должен занимать радиатор (используется, чтобы не растягивать радиатор на всю ширину проема). По умолчанию 80%.
- Заполнить параметры мощности приборов (флажок) — если включен, тепловая нагрузка помещения делится поровну между всеми размещенными в нем радиаторами и записывается в параметр мощности каждого. Если выключен — в параметр мощности записывается 0 у всех вновь поставленных радиаторов (см. раздел «Важный нюанс» ниже).
Все три числовых значения запоминаются в настройках плагина и подставляются автоматически при следующем открытии окна.
Ниже — сводка по выбранным пространствам: «Всего пространств» и «Пространства с заполненными потерями» (тепловая нагрузка > 0 — только они обрабатываются).
Кнопка «Выполнить»
Запускает расстановку радиаторов. Окно закрывается, и появляется отчет с результатом («Размещено радиаторов: N в M пространствах»).
Если не выбран ни один из трех вариантов пространств, появится сообщение «Выберите какие пространства обрабатываются», и расстановка не выполняется.
Используемые параметры Revit
| Где | Параметр в коде | Как получается | Что это / значение |
|---|---|---|---|
| Пространство — расчетная тепловая нагрузка | BuiltInParameter.ROOM_DESIGN_HEATING_LOAD_PARAM | встроенный параметр Revit (get_Parameter по BuiltInParameter) | «Расчетная тепловая нагрузка»¹. Пространства с нулевой нагрузкой пропускаются; при включенном флажке нагрузка делится между радиаторами этого пространства |
| Пространство — площадь | свойство Space.Area | стандартное свойство API (соответствует параметру «Площадь») | пространства с площадью 0 пропускаются |
| Окно / витраж в связанном файле — категория | сравнение Category.Id.IntegerValue == -2000014 | сравнение id категории элемента в связанной модели | категория «Окна» (OST_Windows). Витражные стены (Wall.CurtainGrid != null) обрабатываются отдельно — радиатор ставится по всему граничному сегменту витража |
| Типоразмер радиатора — длина | GUID 748a2515-4cc9-4b74-9a69-339a8d65a212 | get_Parameter(Guid) — общий параметр типа, ищется по GUID, не по имени | хранит длину радиатора (в футах). По нему подбирается уже существующий типоразмер под нужную длину проема; если такого нет — создается новый типоразмер-дубликат с этим значением |
| Экземпляр радиатора — отступ от стены | LookupParameter("Расстояние от стены") | не GUID и не BuiltInParameter — ищется по точному имени параметра экземпляра | записывается введенное значение «Отступ от стены» (мм → футы) |
| Экземпляр радиатора — смещение от пола | LookupParameter("Расстояние от уровня") | по точному имени параметра экземпляра | записывается введенное значение «Смещение от пола» (мм → футы) |
| Экземпляр радиатора — мощность | GUID be7d2b1b-1916-428f-87f0-d9ee8d4f1efe | get_Parameter(Guid) — параметр экземпляра, ищется по GUID | записывается доля тепловой нагрузки помещения на этот радиатор (или 0, если флажок «Заполнить параметры мощности приборов» выключен) |
¹ Официальное отображаемое название встроенного параметра может отличаться в зависимости от версии/локализации Revit — при сомнении сверьтесь в свойствах пространства (раздел «Механика»).
Все параметры радиатора (по GUID и по имени) должны присутствовать в семействе «…Радиатор универсальный» — типовом семействе, которое плагин использует для расстановки.
Как именно происходит размещение
- Берутся пространства с заполненной тепловой нагрузкой и ненулевой площадью из выбранной области.
- Для каждого пространства по его границам ищутся окна (и витражи) в связанных архитектурных моделях, которые действительно относятся к этому пространству.
- Для каждого найденного проема вычисляется длина участка под радиатор (с учетом «% заполнения проема»).
- Под эту длину подбирается (или создается) типоразмер радиатора семейства «…Радиатор универсальный».
- Радиатор ставится по центру проема на уровне пространства, с заданными отступами от пола и стены, и разворачивается вдоль стены.
- Если включен флажок «Заполнить параметры мощности приборов» — тепловая нагрузка помещения делится поровну между всеми радиаторами, поставленными в этом помещении на этом запуске.
Что не учитывается / пропускается
- Пространства с нулевой тепловой нагрузкой или нулевой площадью.
- Проемы, которые не удалось однозначно сопоставить с границей пространства (например, если пересечение с окном не находит ровно две точки).
- Отсутствующее семейство радиатора плагин попробует загрузить автоматически из папки
Familyрядом со сборкой плагина — вручную грузить его не нужно.
Что нужно подготовить заранее
- В пространствах должна быть заполнена расчетная тепловая нагрузка (например, после теплового расчета).
- Окна должны быть смоделированы как элементы категории «Окна» в связанном архитектурном файле (или как витражная стена), и должны попадать в границы пространства.
- В семействе «…Радиатор универсальный» должны быть все параметры из таблицы выше (длина типа, мощность, расстояние от стены, расстояние от уровня) — иначе размещение конкретного радиатора завершится ошибкой.
Важный нюанс
Параметр мощности радиатора перезаписывается при каждом запуске для всех вновь поставленных радиаторов: если флажок «Заполнить параметры мощности приборов» выключен, туда будет записан 0, даже если вы рассчитываете заполнить мощность отдельно вручную позже. Держите это в уме — включайте флажок, если мощность нужна сразу.
Итог операции
После завершения открывается окно с результатом вида «Размещено радиаторов: N в M пространствах» и списком размещенных элементов.