Preview Rays

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

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

Текущая доступность: Preview Rays зарегистрирована в BIMO Library и включена в стандартную схему Ribbon в разделе BIMO > Analyze, но скрыта по умолчанию и управляется конфигурацией плана или workspace. В актуальной тарифной матрице команда не привязана к конкретному тарифу, поэтому эта страница не обещает доступ на PRIMO, OPTIMO или ULTIMO. Если команда отсутствует, проверьте конфигурацию Ribbon и доступ workspace или обратитесь на support@bimo.tools.

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.

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

Основная команда открывает настройки Daylight Measurement. В таблице приведены значения по умолчанию и подтверждённая исходниками валидация.

Настройка

По Умолчанию

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

Влияние На Preview Rays

Широта

55

0-90

Используется для расчёта солнечных векторов BIMO. Отрицательная широта не принимается.

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

7

4-20

Первый целый час диапазона; включён в расчёт.

Время заката

17

4-20

Конец диапазона; этот час не включён.

День года

112

1-365

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

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

Comments

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

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

Шаг в минутах

5

1-15

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

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

0

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

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

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

0

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

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

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

500

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

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

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

60

1-901

Не используется Preview Rays; это настройка Solar Exposure.

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

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

Текст

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

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

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

Текст

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

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

100000

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

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

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

500000

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

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

CurveHostDistanceTolerance

400

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

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

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

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

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

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

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

Поведение

Use BIMO Settings

Параметр отсутствует или больше 0: использовать настройки команды. Значение 0 или отрицательное: прочитать индивидуальные часы ниже.

Sunrise Hour

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

Sunset Hour

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

Для индивидуального диапазона закат должен быть позже восхода, а оба значения должны находиться от 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 горизонтальна, а ширина и глубина окна положительны.

Проверка препятствий включает Generic Models, Masses, Floors, Roofs, Ceilings и Walls, в том числе найденные в связанных Revit-моделях. Curtain Wall Panels не входят в этот фильтр. Preview Rays использует геометрию и видимость активного 3D-вида как есть: в отличие от 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.

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

  • 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-вида, секущего бокса, видимости, выбранных категорий препятствий и геометрии связанных моделей.

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

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

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

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

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

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

Проблема

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Проверьте 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 🗙