Preview Rays

Инструкция по Preview Rays в BIMO для Revit: визуализация незаблокированных солнечных лучей и проверка настроек Solar Exposure.

Preview Rays создаёт в активном 3D-виде статический предпросмотр прямых солнечных лучей для выбранных экземпляров семейств. Для каждой временной точки команда проверяет виртуальный проём и геометрию модели, а затем рисует только те лучи, которые достигают расчётной точки без препятствий.

Текущая доступность: Preview Rays зарегистрирована в BIMO Library в разделе BIMO > Analyze, скрыта в стандартной схеме Ribbon и доступна только при активной платной лицензии BIMO. После активации ключа перезапустите Revit, чтобы применить конфигурацию Ribbon и branding workspace.

BIMO выпускается для Revit 2021-2027, а в исходниках Preview Rays нет отдельного ограничения по версии Revit.

Когда Использовать

Используйте Preview Rays, когда нужно:

  • увидеть направления прямого солнечного света, доступного выбранному окну, панели или другому экземпляру семейства;

  • понять, какие интервалы дня проходят через виртуальный проём без перекрытия;

  • проверить влияние стен, перекрытий, кровель, потолков, формообразующих элементов и Generic Models на одну расчётную точку;

  • визуально сравнить несколько вариантов ориентации семейства или фасада перед расчётом Solar Exposure.

Preview Rays не является расчётом соответствия нормативам. Это статический снимок упрощённой солнечной модели BIMO, а не живая визуализация Revit Sun Path.

Требования Перед Запуском

  • Откройте проект Revit. Документы семейств не поддерживаются.

  • Активируйте 3D-вид. Команда не запускается на планах, разрезах, фасадах, листах и спецификациях.

  • Настройте видимость, секущий бокс и связанные модели активного 3D-вида так, как они должны участвовать в проверке препятствий.

  • Подготовьте один или несколько экземпляров семейств с поддерживаемой точкой или кривой размещения.

  • Проверьте угол истинного севера активного Project Location.

  • Перед запуском проверьте часы, день, широту, шаг и размеры предпросмотра.

Текущее ограничение формы: Preview Rays использует общие настройки Daylight Measurement. Поэтому валидатор всё ещё требует найти в проекте Curtain Wall Panel и проверить у неё доступный для записи текстовый параметр результата, по умолчанию Comments, хотя Preview Rays этот параметр не записывает. Если форма отклоняет параметр результата, добавьте или укажите подходящий параметр Curtain Wall Panels либо обратитесь в поддержку.

Выбор Экземпляров

Предварительно выберите совместимые Family Instances и запустите Preview Rays. Несовместимые элементы в текущем выборе игнорируются. Если подходящих экземпляров не выбрано, Revit покажет запрос Pick family instances: укажите элементы и завершите выбор кнопкой Finish.

Команда принимает FamilyInstance без дополнительного фильтра по категории. Однако наличие экземпляра семейства само по себе не гарантирует успешный расчёт: команде нужны корректная Facing Orientation и поддерживаемый тип размещения.

Расчётная Точка

Preview Rays проверяет одну точку на каждый выбранный экземпляр.

Тип Экземпляра

Исходная Расчётная Точка

Curtain Wall Panel

Начало координат трансформации панели плюс Смещение по высоте.

Экземпляр с точкой размещения, размещённый в Wall

Точка размещения, смещённая на половину толщины стены по направлению экземпляра и вверх на Смещение по высоте.

Другой экземпляр с точкой размещения

Точка размещения без вертикального смещения.

Экземпляр с кривой размещения

Середина кривой без вертикального смещения.

Другой тип размещения

Не поддерживается; команда завершится ошибкой и откатит результат всего запуска.

После определения точки команда сдвигает её назад относительно Facing Orientation на значение Глубина окна. На панелях криволинейной Curtain System ориентация может быть развёрнута по геометрии Mass с учётом CurveHostDistanceTolerance.

Настройки Команды

Основная команда открывает общие с Solar Exposure настройки Daylight Measurement. Поля объединены в разделы Расчёт инсоляции, Расчётная точка и проём, Результат и Визуализация лучей. Расчётный профиль выбирает проверенные параметры каталога или показывает ручные поля для Custom.

Настройка

По Умолчанию

Допустимый Диапазон

Влияние На Preview Rays

Расчётный профиль

55° N - Moscow

55° N - Moscow или Custom

Использует тот же профиль и effective parameters, что Solar Exposure.

Широта

55

0-90

Отображается только для Custom. Используется для расчёта солнечных векторов BIMO.

Время восхода

6

4-20

Отображается только для Custom. Первый целый час диапазона; включён в расчёт.

Время заката

18

4-20

Отображается только для Custom. Конец диапазона; этот час не включён.

День года

112

1-365

Отображается только для Custom. День 112 примерно соответствует 22 апреля невисокосного года.

Имя параметра результата

Comments

Текстовый параметр с правом записи на Curtain Wall Panels

Не используется для результата Preview Rays, но текущая общая форма всё равно его валидирует.

Шаг в минутах

5

1-15

Отображается только для Custom. Меньший шаг создаёт больше лучей и увеличивает время обработки.

Глубина окна (мм)

0

Явного ограничения нет

Задаёт глубину виртуального проёма и сдвигает расчётную точку.

Ширина окна (мм)

0

Явного ограничения нет

Задаёт ширину виртуального проёма. При неположительном значении внутренняя проверка бокового перекрытия использует 1000 мм, но контур проёма не рисуется.

Смещение по высоте (мм)

500

Явного ограничения нет

Применяется только к Curtain Wall Panels и размещённым в стене экземплярам с точкой размещения.

Минимальный временной диапазон (минуты)

60

1-901

Отображается только для Custom. Пункт 166 СанПиН 1.2.3685-21 задаёт это требование для прерывистой инсоляции в Solar Exposure; Preview Rays его не использует. В проверенном московском профиле зафиксировано значение 60.

Метка прерывистой инсоляции

Intermittent с начальным пробелом

Текст

Не используется Preview Rays.

Метка недостаточного времени

- No continuous hour с начальным пробелом

Текст

Не используется Preview Rays.

Высота визуализации лучей (мм)

100000

Явного ограничения нет

Определяет расчётную длину луча по высоте солнца.

Максимальная длина визуализации лучей (мм)

500000

Явного ограничения нет

Ограничивает длину каждого нарисованного луча.

CurveHostDistanceTolerance

400

Явного ограничения нет

Допуск при определении ориентации панели на криволинейной грани Mass.

Профиль 55° N - Moscow использует широту 55 и расчётный день 112 (22 апреля) по ГОСТ Р 57795-2017; стандарт также допускает 22 августа. BIMO рассчитывает интервал 06:00-18:00 с исключительной конечной границей и шагом дискретизации 5 минут. Минимальный непрерывный период 60 минут, используемый Solar Exposure, соответствует пункту 166 СанПиН 1.2.3685-21. Эти значения каталога не дублируются отдельными полями в форме настроек; скрытые ручные значения сохраняются для возврата к Custom.

В Custom время восхода и заката валидируются отдельно. Форма не проверяет, что закат позже восхода. Если закат равен восходу или раньше него, солнечные направления не создаются и DirectShape может содержать только крест расчётной точки и, при подходящих настройках, контур проёма.

Для равномерной дискретизации используйте шаг, на который 60 делится без остатка: например, 1, 2, 3, 4, 5, 6, 10, 12 или 15. Для глубины, ширины, смещения, высоты, максимальной длины и допуска нет явной проверки диапазона; используйте осмысленные неотрицательные значения и сначала проверяйте результат на одном элементе.

Индивидуальные Часы Для Экземпляра

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

Параметр Экземпляра

Поведение

Use BIMO Settings

Для Custom: параметр отсутствует или больше 0 — использовать настройки команды; значение 0 или отрицательное — прочитать индивидуальные часы ниже.

Sunrise Hour

Индивидуальный первый час, когда Use BIMO Settings не положителен.

Sunset Hour

Индивидуальный конечный час, когда Use BIMO Settings не положителен.

Для индивидуального диапазона Custom закат должен быть позже восхода, а оба значения должны находиться от 1 до 23. Отсутствующие или неверные параметры индивидуальных часов приводят к ошибке и откату всего запуска. Остальные значения берутся из ручных полей выбранного preset BIMO.

Пошаговый Сценарий

  1. Активируйте нужный 3D-вид и проверьте его видимость и секущий бокс.

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

  3. Запустите Preview Rays, если команда доступна в вашем Ribbon.

  4. Проверьте preset и настройки Daylight Measurement, затем нажмите OK.

  5. Если Revit показывает Pick family instances, выберите элементы и нажмите Finish.

  6. При появлении индикатора Create rays preview дождитесь завершения или отмените обработку.

  7. Осмотрите созданные лучи, кресты расчётных точек и контуры виртуальных проёмов в 3D-виде.

  8. После проверки отмените транзакцию через Revit Undo или удалите созданную геометрию вручную, если она больше не нужна.

Что Создаётся

Для каждого выбранного экземпляра команда создаёт один постоянный DirectShape категории Lines. Он может содержать:

  • один отрезок для каждого солнечного направления, которое не перекрыто виртуальным проёмом и геометрией модели;

  • крест размером 1000 × 1000 мм в расчётной точке;

  • трёхсторонний контур виртуального проёма, если Facing Orientation горизонтальна, а ширина и глубина окна положительны.

Сам DirectShape остаётся в категории Lines. Всем создаваемым кривым BIMO назначает подкатегорию Lines > BIMO Insolation Rays. Если такой подкатегории ещё нет в проекте, BIMO создаёт её автоматически. Благодаря этому видимость и графику Preview Rays можно настраивать отдельно от остальных Lines стандартными средствами Revit.

Проверка препятствий включает Generic Models, Masses, Floors, Roofs, Ceilings и Walls, в том числе найденные в видимых загруженных Revit-связях. Curtain Wall Panels не входят в этот фильтр. Перед трассировкой Preview Rays выполняет ту же временную подготовку видимости, что и Solar Exposure: видимые элементы основной модели вне поддерживаемых категорий препятствий временно скрываются, видимые загруженные связи сохраняются, а изменение видимости затем откатывается.

Preview Rays и Solar Exposure после этого используют один и тот же метод расчёта лучей. Для одного и того же целевого элемента и preset нарисованные лучи должны точно соответствовать незаблокированным временным точкам, которые учитывает Solar Exposure. Высота визуализации лучей и Максимальная длина визуализации лучей изменяют только длину отображаемых линий и не влияют на определение незаблокированного луча.

Лучи намеренно не начинаются в самом кресте. Точки целого часа начинаются на расстоянии 2000 мм и заканчиваются на 100% рассчитанного предела; точки :30 начинаются на 2250 мм и заканчиваются на 95% предела; остальные точки начинаются на 2500 мм и заканчиваются на 90% предела. Рассчитанный предел зависит от высоты солнца и ограничивается Максимальной длиной визуализации лучей.

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

Presets, Variants И Горячие Клавиши

Preview Rays поддерживает presets BIMO для общих настроек Daylight Measurement. Для команды генерируются три preset-варианта:

  • основная команда открывает окно настроек;

  • Variant #1, Variant #2 и Variant #3 могут запускать назначенные presets и пропускать окно, если настройки корректны;

  • каждый variant является отдельным элементом Ribbon, которому можно назначить горячую клавишу Revit.

На variants распространяются те же ограничения видимости плана, project document и активного 3D-вида, что и на базовую команду. Подробнее см. Presets и Variants.

Примеры

Панель Навесной Стены

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

Окно В Стене

Для размещённого в Wall экземпляра задайте глубину и ширину виртуального проёма. Команда учтёт половину толщины стены, вертикальное смещение и виртуальные боковые границы проёма.

Только Крест Без Лучей

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

Изменения Модели И Очистка

  • Успешный запуск добавляет по одному DirectShape на экземпляр в одной транзакции Revit Create rays preview.

  • Временные изменения видимости, используемые во время расчёта лучей, откатываются до сохранения геометрии предпросмотра.

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

  • Ранее созданная геометрия предпросмотра не получает новый стиль автоматически. Чтобы старые лучи использовали подкатегорию BIMO Insolation Rays, удалите их и запустите Preview Rays повторно.

  • Preview Rays не записывает Comments или другой параметр результата Solar Exposure.

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

  • Сразу после запуска все созданные элементы можно убрать одной стандартной командой Revit Undo.

  • Позже выберите созданные DirectShape в 3D-виде и удалите их вручную. Отдельная опубликованная команда BIMO для очистки Preview Rays в текущем Ribbon не подтверждена.

Перед ручным удалением внимательно проверьте выбор, чтобы не удалить другие элементы категории Lines.

Ограничения

  • Солнечная модель использует введённые вручную широту, день и целые границы часов. Она не читает Revit Sun Settings, долготу, часовой пояс, переход на летнее время или погодные данные.

  • Поддерживается широта только 0-90; южное полушарие с отрицательной широтой не поддерживается текущей формой.

  • Проверяется одна расчётная точка, а не поверхность или объём экземпляра.

  • Preview Rays показывает только незаблокированные лучи и не отображает причины блокировки.

  • Результат зависит от Facing Orientation, True North, активного 3D-вида, секущего бокса, видимости, выбранных категорий препятствий и геометрии связанных моделей.

  • Видимые загруженные Revit-связи участвуют для поддерживаемых категорий препятствий; скрытые и выгруженные связи исключаются активным 3D-видом.

  • Curtain Wall Panels не считаются препятствиями текущим фильтром пересечений.

  • Смещение по высоте применяется не ко всем типам размещения одинаково.

  • При неположительной ширине окна внутренняя проверка использует 1000 мм, хотя контур проёма не рисуется.

  • Размеры предпросмотра не имеют явной проверки диапазона. Слишком малые, отрицательные или несогласованные значения могут создать вводящую в заблуждение геометрию или ошибку Revit.

  • Созданная геометрия является статической: она не обновляется после изменения модели, вида, истинного севера или настроек. Удалите старый предпросмотр и запустите команду снова.

Ошибки И Решение Проблем

Проблема

Что Проверить

Preview Rays отсутствует на Ribbon

Команда скрыта в стандартной схеме и управляется конфигурацией плана или workspace. Проверьте Ribbon configuration; точный тариф не подтверждён текущей матрицей.

Появляется BIMO license required

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

BIMO просит активировать 3D-вид

Откройте 3D-вид и повторите запуск.

Форма не принимает Comments или другой параметр результата

Текущий общий валидатор требует Curtain Wall Panel с доступным для записи текстовым параметром, хотя Preview Rays его не записывает.

Revit показывает Pick family instances

Текущий выбор не содержит совместимых Family Instances. Выберите их вручную и нажмите Finish.

Создан крест, но лучей нет

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

Связанная модель не влияет на предпросмотр

Убедитесь, что связь загружена и видима в активном 3D-виде, нужные категории связи видимы, а препятствие относится к Generic Models, Masses, Floors, Roofs, Ceilings или Walls.

Ожидаемый заблокированный луч не виден

Это штатно: команда рисует только лучи без препятствий.

Лучи направлены не туда

Проверьте Facing Orientation, переворот семейства, True North и допуск криволинейной Mass-грани.

Ошибка называет Sunrise Hour и Sunset Hour

У экземпляра Use BIMO Settings равен 0 или меньше, но индивидуальные часы отсутствуют, выходят за 1-23 или закат не позже восхода.

Весь запуск откатился на одном элементе

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

Предпросмотры дублируются

Команда не очищает старые DirectShape. Используйте Undo после запуска или удалите старую геометрию вручную.

Лучи не обновились после изменения модели

Предпросмотр статический. Удалите старые DirectShape и запустите команду повторно.

Параметр результата не изменился

Preview Rays не записывает параметры. Для расчёта и записи минут используйте Solar Exposure, учитывая её текущую доступность.

Связанные Страницы

An error has occurred. This app may no longer respond until reloaded. Reload 🗙