Ladybug Tools

Ladybug Tools — набор взаимосвязанных инструментов для экологического анализа архитектурных и градостроительных проектов. Основная рабочая среда комплекса — Rhino и визуальный редактор Grasshopper. Внутри одного параметрического определения можно загрузить погодные данные, построить солнечный путь и ветровую розу, оценить радиацию на фасадах, подготовить энергетическую модель, выполнить расчёт дневного освещения и сравнить несколько проектных вариантов.

Название Ladybug Tools относится ко всей экосистеме, а Ladybug — только к одному из её модулей. В состав комплекса входят Ladybug, Honeybee, Dragonfly, Butterfly и дополнительные библиотеки. В выпуске 1.10 также появился Fairyfly для двумерного расчёта теплопередачи через THERM 8. Отдельные модули используют EnergyPlus, OpenStudio, Radiance, OpenFOAM и другие расчётные движки, но пользователь управляет моделями и просматривает результаты через компоненты Grasshopper. Ladybug Tools+1

На 14 июля 2026 года последним выпуском общей сборки LBT Grasshopper является версия 1.10.45 от 13 июля 2026 года. Это исправляющий выпуск ветки 1.10, обновивший зависимость Honeybee Grasshopper Radiance. Стабильная версия 1.10.0 вышла 25 февраля 2026 года и поддерживает Rhino 6, Rhino 7 и Rhino 8 в Windows и macOS. GitHub+1

Что представляет собой Ladybug Tools

Ladybug Tools нельзя рассматривать как обычную программу с главным окном, меню Файл и последовательным мастером настройки. Пользователь собирает рабочую схему из компонентов Grasshopper. Каждый компонент выполняет ограниченную операцию: импортирует EPW, создаёт период анализа, строит солнечные векторы, преобразует геометрию в Honeybee Room, запускает EnergyPlus или считывает результат расчёта.

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

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

Ladybug Tools остаётся интерфейсом к расчётным движкам, а не заменяет их математические модели. Ladybug выполняет часть геометрических операций средствами Rhino, Honeybee передаёт энергетические модели в OpenStudio и EnergyPlus, светотехнические задачи — в Radiance, Butterfly создаёт расчётные случаи OpenFOAM. Корректность результата зависит от геометрии, погодного файла, материалов, расписаний, граничных условий и выбранных параметров расчёта. Ladybug Tools+2Ladybug Tools+2

Состав комплекса

Ladybug

Ladybug отвечает за погодные данные, климатические диаграммы и сравнительно быстрые геометрические исследования. Модуль импортирует стандартные файлы EnergyPlus Weather с расширением .epw и преобразует их почасовые значения в объекты Data Collection, пригодные для дальнейшей обработки в Grasshopper.

Основные задачи Ladybug:

• построение Sun Path;

• создание Wind Rose и Wind Profile;

• визуализация температуры, влажности, радиации и других величин;

• Psychrometric Chart;

• Monthly Chart и Hourly Plot;

• Cumulative Sky Matrix;

• расчёт Direct Sun Hours;

• Incident Radiation;

• View Rose и View Percent;

• Solar Envelope;

• анализ эффективности затенения;

• настройка легенд, цветовых диапазонов и подписей.

Базовые операции Ladybug не требуют создания полноценной энергетической модели здания. Для солнечного пути достаточно местоположения, для ветровой розы — скорости и направления ветра, а для расчёта прямого солнца — солнечных векторов, анализируемой геометрии и окружающих препятствий. Это делает модуль подходящим для ранней стадии, когда помещения, конструкции и инженерные системы ещё не определены. Ladybug Tools+2Ladybug Tools+2

Honeybee

Honeybee переводит геометрию в объектную модель здания и соединяет Grasshopper с EnergyPlus, OpenStudio и Radiance. Основной объект модуля — Honeybee Model. Он объединяет помещения, поверхности, проёмы, двери, затеняющие элементы, энергетические свойства и светотехнические параметры.

Для энергетического расчёта используются Honeybee Room. Каждое помещение содержит Faces, которые классифицируются как Wall, RoofCeiling, Floor или AirBoundary. В стенах и кровлях могут находиться Apertures, а отдельные непрозрачные проёмы представляются Doors. Внешнее затенение задаётся объектами Shade.

Honeybee позволяет назначать:

• ConstructionSet;

• отдельные конструкции стен, кровель, полов и окон;

• ProgramType;

• расписания присутствия, освещения и оборудования;

• внутренние тепловыделения;

• уставки отопления и охлаждения;

• инфильтрацию;

• естественную вентиляцию;

• шаблонные и подробные системы HVAC;

• свойства материалов Radiance;

• Sensor Grid;

• параметры расчётных рецептов.

После подготовки модели пользователь может получить годовые нагрузки, пиковые нагрузки, потребление энергии, температурные ряды, показатели комфорта, освещённость, daylight autonomy, annual sunlight exposure и другие результаты. Honeybee не выполняет все вычисления внутри компонента: он создаёт входные файлы, запускает движок и считывает выходные данные. Ladybug Tools+3Ladybug Tools+3Ladybug Tools+3

Dragonfly

Dragonfly предназначен для моделей квартального и городского масштаба. Вместо подробного описания каждой поверхности используется упрощённая схема с объектами Room2D, Story, Building и Model. Помещения создаются из планов этажей и затем могут преобразовываться в трёхмерные Honeybee Rooms.

Модуль поддерживает несколько направлений:

• энергетическое моделирование районов через URBANopt;

• расчёт зданий с OpenStudio и EnergyPlus;

• моделирование нагрузки на электрические сети через OpenDSS;

• оптимизацию возобновляемых источников через REopt;

• подготовку данных для районных тепловых систем;

• изменение погодного файла с учётом городского острова тепла через Urban Weather Generator;

• перевод модели в совместимый с URBANopt GeoJSON.

Dragonfly полезен, когда требуется сопоставить десятки зданий, оценить суммарные нагрузки квартала или проверить влияние городской формы на климат. Подробная Honeybee Model остаётся предпочтительнее для отдельного здания, где важны точные проёмы, сложные объёмы, помещения и детальные инженерные системы. Ladybug Tools+1

Butterfly

Butterfly создаёт и запускает CFD-расчёты в OpenFOAM. Модуль применяется для наружного обтекания застройки, движения воздуха в помещениях, естественной вентиляции, плавучести и оценки локальных скоростей воздуха.

Рабочий процесс включает подготовку расчётной области, геометрии препятствий, входных и выходных границ, параметров сетки, модели турбулентности и настроек решателя. Результат CFD нельзя получить только подключением погодного файла к одному компоненту: пользователь обязан определить физическую постановку задачи.

Butterfly поддерживает ламинарные, RAS- и LES-модели турбулентности, но выбор схемы должен соответствовать масштабу, доступным вычислительным ресурсам и требуемой детализации. Документация прямо предупреждает, что модуль не проверяет физическую корректность всех введённых параметров. Завершившийся расчёт не подтверждает правильность граничных условий или сеточной независимости. Ladybug Tools+2Ladybug Tools+2

Fairyfly

Fairyfly появился в стабильной ветке 1.10 как связь Grasshopper с THERM 8. Он предназначен для двумерного анализа теплопередачи через узлы ограждающих конструкций: оконные примыкания, стыки стен и перекрытий, теплопроводные включения, каркасные элементы и другие мостики холода.

Пользователь создаёт двумерные полигоны материалов, назначает граничные условия, экспортирует модель в THERM и импортирует результаты. На выходе можно получить температурное поле, тепловой поток и расчётные U-values. Fairyfly не заменяет трёхмерный теплотехнический расчёт, но закрывает задачи, для которых обычная одномерная конструкция Honeybee недостаточна. Ladybug Tools | Forum

Интерфейс Ladybug Tools

После установки в Grasshopper появляются вкладки Ladybug, Honeybee, HB-Energy, HB-Radiance, Dragonfly и другие разделы, входящие в сборку. Компоненты распределены по тематическим группам. У Ladybug это импорт, анализ данных, визуализация, анализ геометрии, дополнительные операции и управление версиями.

Компонент выглядит как прямоугольный блок с входами слева и выходами справа. Обязательные входы обычно имеют подчёркивание в начале имени, необязательные — подчёркивание в конце. У некоторых узлов для запуска предусмотрен вход _run, _write, _translate или _capture. К нему подключают Boolean Toggle и переключают значение с False на True только после подготовки остальных данных.

Основные элементы Grasshopper, которые регулярно используются вместе с Ladybug Tools:

• Panel — показывает текст, списки значений, пути и сообщения;

• Number Slider — задаёт числовой параметр;

• Boolean Toggle — запускает или останавливает операцию;

• Value List — выбирает один вариант из перечня;

• Geometry, Brep и Mesh — принимают объекты Rhino;

• Data Dam — задерживает пересчёт длинной цепочки;

• Data Recorder — сохраняет последовательность значений;

• Gene Pool — управляет набором параметров;

• Graph Mapper — формирует нелинейное распределение;

• Stream Filter — переключает несколько ветвей расчёта.

Подробное описание компонента открывается через справку Grasshopper. В документации Ladybug Tools для каждого узла перечислены входы, значения по умолчанию, типы данных и выходы. Ошибки выводятся в report или в всплывающем сообщении самого компонента. Оранжевый цвет обычно указывает на предупреждение, красный — на невозможность выполнить операцию.

Геометрические и графические результаты отображаются в окне Rhino. Предпросмотр отдельных компонентов можно отключить командой Preview в контекстном меню, чтобы одинаковые сетки и подписи не накладывались друг на друга. Для переноса обычной геометрии из Grasshopper в документ Rhino используется Bake, но часть объектов визуализации удобнее сохранять через специализированные компоненты, включая LB Capture View. GitHub+1

Установка Ladybug Tools

Установка в Windows

Для ветки 1.10 основной способ установки в Windows — бесплатный Pollination Grasshopper installer. Он загружает совместимую сборку Ladybug Tools и необходимые расчётные движки. Для получения установщика требуется учётная запись Pollination.

Порядок действий:

1. Установите поддерживаемую версию Rhino.

2. Запустите Rhino хотя бы один раз, чтобы были созданы пользовательские каталоги.

3. Закройте Rhino.

4. Загрузите Pollination Grasshopper installer.

5. Запустите установщик с правами обычного пользователя.

6. Дождитесь установки компонентов Ladybug Tools, Radiance и OpenStudio.

7. Откройте Rhino.

8. Введите команду Grasshopper.

9. Проверьте наличие вкладок Ladybug, Honeybee, HB-Energy и HB-Radiance.

10. Откройте новый файл Grasshopper и добавьте компонент LB Versioner или LB Import EPW.

Единый установщик ставит совместимые копии Radiance и OpenStudio так, чтобы они не конфликтовали с другими версиями этих движков. При последующем запуске новой версии установщика старые связанные компоненты и движки обновляются. Ladybug Tools | Forum+2GitHub+2

Ручная установка

Ручной способ основан на файле installer.gh, доступном в архиве с Food4Rhino. В определении находятся два компонента с переключателями. Первый загружает подготовленную среду Python, второй устанавливает библиотеки, компоненты Grasshopper и стандартные ресурсы.

После выполнения второго компонента библиотека конструкций, расписаний и модификаторов размещается в пользовательском каталоге ladybug_tools/resources/standards. Для Rhino 6 в Windows документация предусматривает дополнительный запуск set_python_path.bat при закрытом Rhino. Radiance, OpenStudio и URBANopt при ручном варианте устанавливаются отдельно в версиях, указанных в матрице совместимости. GitHub

Установка в macOS

В macOS для LBT 1.10 используется installer.gh с Food4Rhino. Первый компонент загружает архив Python в пользовательскую папку ladybug_tools, после чего архив необходимо распаковать в том же каталоге. Второй компонент устанавливает библиотеки и компоненты. Затем Rhino перезапускается.

Radiance и OpenStudio в macOS устанавливаются отдельно, когда они требуются для светотехнических или энергетических расчётов. Для климатических графиков Ladybug и простых геометрических операций эти движки не обязательны. Ladybug Tools | Forum+1

Проверка установки

После установки не следует начинать проверку со сложной энергетической модели. Надёжнее последовательно протестировать отдельные уровни:

1. Добавить LB Import EPW.

2. Подключить путь к корректному .epw.

3. Вывести location и dry_bulb_temperature в Panel.

4. Подключить location к LB SunPath.

5. Убедиться, что солнечный путь отображается в Rhino.

6. Создать простую замкнутую Brep.

7. Передать её в HB Room from Solid.

8. Собрать HB Model.

9. Выполнить проверку модели.

10. Только после этого тестировать Radiance или EnergyPlus.

Если климатические компоненты работают, а Honeybee не запускает расчёт, причина обычно связана с отсутствующим движком, несовместимой версией, путём к файлу или ошибкой модели. Сообщение report и файлы ошибок расчётного движка содержат более полезную информацию, чем красный цвет конечного компонента.

Обновление и перенос старых файлов

Компонент LB Versioner обновляет компоненты и библиотеки Ladybug Tools до выбранного выпуска. Перед обновлением рабочего проекта следует сохранить копию .gh, поскольку новые версии могут изменить входы, выходы или внутреннее представление объектов.

LB Sync Grasshopper File синхронизирует компоненты существующего определения с установленной версией. Он полезен, когда файл создан в другом выпуске LBT и Grasshopper показывает устаревшие узлы. Синхронизацию нужно выполнять на копии проекта: автоматическая замена не гарантирует, что пользовательская логика вокруг изменившегося компонента останется корректной.

Для старых определений Ladybug Legacy и Honeybee Legacy в выпуске 1.8 появился LB Legacy Updater. Он переносит поддерживаемые узлы на новую архитектуру, но не превращает сложный Legacy-файл в полностью проверенную модель одним действием. После обновления требуется проверить соединения, типы данных, результаты и компоненты, у которых нет прямого соответствия. Ladybug Tools | Forum+1

Системные требования

Ladybug Tools не является автономным приложением, поэтому базовые требования определяются Rhino, Grasshopper и подключаемыми движками. Стабильная ветка 1.10 работает в Rhino 6–8 под Windows и macOS. Grasshopper входит в современные выпуски Rhino и запускается командой Grasshopper. Ladybug Tools | Forum

Фиксированного универсального требования к оперативной памяти или количеству ядер для всех задач нет. Sun Path для одного периода и годовой Radiance-расчёт здания предъявляют несопоставимую нагрузку. Объём ресурсов определяется количеством помещений, поверхностей, датчиков, временных шагов, вариантов и сложностью геометрии.

Для климатических диаграмм достаточно компьютера, на котором нормально работает Rhino. При крупных Honeybee Model важнее производительность процессора и объём памяти. Годовые светотехнические матрицы создают значительные временные файлы, поэтому требуется свободное место на SSD. В ветке 1.10 постобработка некоторых Radiance-матриц использует CuPy при наличии совместимого графического процессора, но GPU не заменяет процессор во всех стадиях расчёта. Ladybug Tools | Forum

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

Работа с погодными файлами EPW

Файл EPW содержит почасовые погодные данные типового или фактического года. Ladybug считывает из него местоположение и набор временных рядов: сухую температуру, температуру точки росы, относительную влажность, прямую нормальную и рассеянную горизонтальную радиацию, скорость и направление ветра, давление, облачность и другие показатели.

Основной компонент — LB Import EPW. На его вход передаётся путь к файлу, а выходы подключаются к графикам и расчётам. location используется в Sun Path и матрицах неба, dry_bulb_temperature — в температурных графиках и моделях комфорта, wind_speed и wind_direction — в Wind Rose, а direct_normal_radiation и diffuse_horizontal_radiation — в LB Cumulative Sky Matrix. Ladybug Tools+1

EPW не является прогнозом погоды на конкретный будущий год. Типичный метеорологический год составляется из характерных периодов наблюдений и предназначен для сравнительного моделирования. Для проекта необходимо выбирать станцию, соответствующую местоположению и климату участка. Ближайшая по расстоянию станция не всегда является наиболее репрезентативной, если она расположена на другой высоте, у моря, в аэропорту или за горным барьером.

Analysis Period

LB Analysis Period формирует диапазон месяцев, дней и часов. Он выдаёт список hours of year, который можно подключить к LB SunPath, графикам, Sky Matrix и другим компонентам.

Период позволяет выделить:

• отопительный сезон;

• летние месяцы;

• рабочие часы;

• определённый день;

• интервал до и после полудня;

• часы присутствия людей;

• несколько характерных недель.

Пользователь должен отличать календарный период от расписания присутствия. Analysis Period выбирает временные шаги, а расписание Honeybee определяет занятость, работу оборудования или уставки в энергетической модели. Это разные сущности.

Климатические диаграммы

Sun Path

LB SunPath создаёт солнечный путь в сцене Rhino. Обязательный вход location принимает местоположение из LB Import EPW или LB Construct Location. Вход north задаёт направление севера относительно положительной оси Y. Значение 0 означает совпадение с Y, 90 указывает запад, 270 — восток.

Вход hoys принимает часы года. Без него компонент строит полный годовой солнечный путь. При подключении Analysis Period отображается выбранный диапазон. Выход vectors содержит направленные вниз солнечные векторы, используемые в LB Direct Sun Hours и задачах проектирования затенения.

Дополнительные выходы включают высоты и азимуты солнца, точки положения солнца, аналеммы, дневные дуги, компас, легенду и VisualizationSet. Параметр projection позволяет выбрать Orthographic или Stereographic для двумерного представления вместо трёхмерного купола. Ladybug Tools

Wind Rose

LB Wind Rose группирует погодные значения по направлениям ветра. Обычно к нему подключают направление ветра, скорость и Analysis Period. Диаграмма показывает частоту направлений, а при соответствующей настройке — среднее значение исследуемой величины в каждом секторе.

Параметр show_calm отображает долю часов с нулевой скоростью ветра окружностью в центре. show_avg переключает диаграмму с частотного распределения на средние значения. freq_dist управляет расстоянием между частотными интервалами, а freq_hours — количеством часов в интервале. Ladybug Tools

Ветровая роза не заменяет CFD. Она описывает метеорологические данные станции и помогает выбрать характерные направления. Реальная скорость между зданиями зависит от формы застройки, шероховатости местности, высоты и локальных препятствий.

Wind Profile

LB Wind Profile показывает изменение скорости по высоте. В расчёте учитываются метеорологическая высота, тип местности у станции и тип местности на проектной площадке. Доступны классы city, suburban, country и water.

Компонент полезен перед CFD и при оценке наружного комфорта, поскольку скорость в EPW обычно относится к метеорологической точке измерения, а не к уровню пешехода. Можно использовать степенной закон, применяемый EnergyPlus, или переключиться на логарифмический профиль. Ladybug Tools+1

Psychrometric Chart

LB Psychrometric Chart строит психрометрическую диаграмму по температуре и влажности. На неё можно наносить наружные значения EPW или результаты внутреннего микроклимата из энергетической симуляции.

Диаграмма помогает увидеть распределение часов по температурно-влажностному полю. Компоненты LB PMV Polygon и LB UTCI Polygon добавляют области комфорта и позволяют подсчитать часы, попавшие в выбранные зоны. PMV Polygon ориентирован на модель теплового комфорта в помещении, UTCI Polygon — на наружный тепловой стресс. Ladybug Tools+2Ladybug Tools+2

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

Hourly Plot и Monthly Chart

LB Hourly Plot создаёт цветную карту почасовой величины. По одной оси располагаются дни или месяцы, по другой — часы. Такой формат показывает сезонность и суточный профиль, которые трудно увидеть по среднему годовому значению.

LB Monthly Chart группирует данные по месяцам. Месячные и дневные данные отображаются столбцами, а почасовые — линиями и диапазонами между выбранными процентилями. На одном графике можно сопоставить несколько потоков, если у них совместимы единицы и смысл. Ladybug Tools+1

В выпуске 1.10 компонент LB Contour Mesh получил возможность строить подписанные контуры не только по плоским, но и по пространственным сеткам и климатическим графикам.

Анализ солнечной радиации

Cumulative Sky Matrix

LB Cumulative Sky Matrix преобразует прямую нормальную и рассеянную горизонтальную радиацию в матрицу небосвода. Каждый участок неба содержит накопленное значение для выбранного периода.

По умолчанию используется небо Tregenza с 145 участками. При включении high_density создаётся матрица Reinhart с 577 участками. Повышенная плотность улучшает угловое разрешение, но увеличивает продолжительность последующих расчётов.

Матрицу можно просмотреть компонентом LB Sky Dome, использовать в LB Radiation Rose или подключить к LB Incident Radiation. Ladybug Tools+1

Incident Radiation

LB Incident Radiation рассчитывает падающую радиацию на Brep или Mesh. Обязательные входы:

• _sky_mtx — матрица неба;

• _geometry — анализируемая геометрия;

• _grid_size — размер ячейки;

• _run — переключатель запуска.

Вход context_ принимает окружающие объекты, перекрывающие небосвод. offset_dist_ отодвигает точки от поверхности, чтобы избежать самозатенения из-за численной погрешности. legend_par_ управляет диапазоном и оформлением, cpu_count_ — количеством процессоров для пересечений лучей.

При irradiance_ = False результат выражается накопленной радиацией в кВт·ч/м². При True выводится средняя облучённость в Вт/м². Выход total показывает суммарную энергию на всей геометрии в кВт·ч и зависит от корректного масштаба Rhino.

Компонент не учитывает отражения солнечной энергии от окружающей геометрии. Для сложных сцен и задач, где отражения существенны, используется Honeybee Radiance. Пересечения лучей выполняются средствами CAD, поэтому чрезмерно сложный контекст и очень мелкая сетка резко увеличивают продолжительность. Ladybug Tools

Direct Sun Hours

LB Direct Sun Hours подсчитывает продолжительность прямого солнечного воздействия. Солнечные векторы поступают из LB SunPath. Анализируемая геометрия разбивается по grid_size, а препятствия подключаются к context_.

Выход results содержит количество часов для каждой точки, mesh — цветную сетку, legend — шкалу. int_mtx позволяет получить матрицу видимости: 1 означает видимое солнце для конкретного вектора, 0 — перекрытое.

Параметр geo_block_ определяет, считается ли сама анализируемая геометрия непрозрачным препятствием. При True она участвует в затенении, при False учитывается только внешний контекст. Ladybug Tools

Разница между радиацией и солнечными часами

Direct Sun Hours отвечает на вопрос, сколько времени поверхность видит прямое солнце. Incident Radiation оценивает количество падающей солнечной энергии с учётом прямой и рассеянной составляющих матрицы.

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

Инструкция: построение Sun Path и Wind Rose

Подготовка файла

1. Откройте Rhino.

2. Установите единицы модели.

3. Введите Grasshopper.

4. Создайте новый файл.

5. Дважды щёлкните по canvas и найдите LB Import EPW.

6. Добавьте Panel с полным путём к .epw.

7. Подключите Panel к входу _epw_file.

8. Подключите выход location к отдельному Panel и проверьте город, широту, долготу и часовой пояс.

Построение солнечного пути

1. Добавьте LB Analysis Period.

2. Задайте начальный и конечный месяц.

3. Укажите часы внутри суток.

4. Добавьте LB SunPath.

5. Подключите location.

6. Подключите часы года из Analysis Period к hoys_.

7. Задайте направление севера через Number Slider.

8. При необходимости подключите Point к center_pt_.

9. Измените scale_, если график слишком велик или мал.

10. Отключите Preview у промежуточных компонентов.

Проверьте положение компаса. Ошибочный север переносится во все последующие солнечные расчёты. Поворот геометрии и изменение входа north не должны случайно дублировать друг друга.

Построение ветровой розы

1. Добавьте LB Wind Rose.

2. Подключите wind_direction из LB Import EPW.

3. Подключите wind_speed как анализируемые данные.

4. Передайте выбранные часы.

5. Добавьте LB Legend Parameters.

6. При необходимости задайте минимальное и максимальное значения.

7. Включите show_calm_, если требуется показать штиль.

8. Используйте show_avg_, когда нужны средние скорости по секторам, а не только частота направлений.

9. Сравните летний и зимний периоды отдельными расчётами.

Ветровая роза должна сопровождаться указанием периода. Годовая диаграмма и диаграмма рабочих часов летнего сезона отвечают на разные вопросы.

Инструкция: расчёт солнечных часов

Подготовка геометрии

Анализируемая поверхность должна иметь правильный масштаб и направление нормали. Для пола, кровли или участка можно передать Brep. При использовании Mesh расчёт выполняется по её граням без дополнительного разбиения Brep.

Контекст должен включать только объекты, реально перекрывающие солнце: соседние здания, козырьки, выступы, рельеф. Мелкие детали, не влияющие на затенение, замедляют пересечения.

Сборка определения

1. Импортируйте EPW.

2. Создайте Analysis Period.

3. Подключите местоположение и часы к LB SunPath.

4. Добавьте LB Direct Sun Hours.

5. Соедините выход vectors с входом _vectors.

6. Подключите поверхность к _geometry.

7. Подключите соседнюю застройку к context_.

8. Задайте _grid_size.

9. Подключите Boolean Toggle к _run.

10. Переключите Toggle на True.

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

Проверка

Цветная сетка должна покрывать всю исследуемую поверхность. Пустые зоны могут указывать на неправильную геометрию, слишком большой grid size или ошибку пересечения. Значения нельзя интерпретировать без знания периода: пять часов за один день и пять часов за месяц визуально могут выглядеть одинаково, но имеют разный смысл.

Инструкция: расчёт падающей радиации

1. Подключите direct_normal_radiation и diffuse_horizontal_radiation к LB Cumulative Sky Matrix.

2. Передайте location.

3. Подключите часы из Analysis Period.

4. Оставьте high_density_ = False для первого запуска.

5. Добавьте LB Incident Radiation.

6. Подключите выход sky_mtx.

7. Назначьте _geometry, context_ и _grid_size.

8. Установите небольшой положительный offset_dist_.

9. Подключите LB Legend Parameters.

10. Запустите расчёт.

Для сравнения двух вариантов используйте одинаковый EPW, Analysis Period, север, сетку, контекст и параметры легенды. Автоматическая шкала может назначить каждому варианту собственный минимум и максимум, из-за чего одинаковые цвета будут соответствовать разным значениям.

Настройка легенд и цветовых шкал

LB Legend Parameters управляет минимумом, максимумом, количеством сегментов, цветами, числом десятичных знаков, размером текста, положением и ориентацией легенды.

LB Color Range содержит набор предустановленных шкал. Среди них Original Ladybug, Ecotect, View Study, Shadow Study, Glare Study, Annual Comfort, Thermal Comfort, Benefit/Harm, Energy Balance, THERM, Cividis, Viridis и Parula. Последние три относятся к монотонным шкалам, рассчитанным на более предсказуемое восприятие, включая распространённые варианты нарушения цветового зрения. Ladybug Tools+1

При сравнении вариантов фиксируйте пределы легенды вручную. Автоматические шкалы полезны для изучения одной модели, но искажают визуальное сравнение нескольких результатов.

Энергетическое моделирование с Honeybee

Создание помещений

Для замкнутой Rhino Brep используется HB Room from Solid. Он создаёт Honeybee Room и классифицирует грани по ориентации и положению. Более сложный способ — собрать Room из отдельных Honeybee Faces.

Перед преобразованием необходимо проверить:

• замкнутость объёма;

• отсутствие самопересечений;

• планарность граней;

• совпадение единиц;

• отсутствие чрезмерно коротких рёбер;

• правильное разделение помещений.

Для многозонной модели соседние помещения должны иметь совпадающие внутренние поверхности. HB Intersect Solids разбивает соприкасающиеся Brep так, чтобы их грани совпали, а HB Solve Adjacency назначает межзонные граничные условия. Если площади внутренних граней различаются, теплопередача между зонами моделируется неправильно. Ladybug Tools+1

Окна и двери

HB Apertures by Ratio добавляет проёмы в наружные стены по отношению площади остекления к площади стены. Компонент работает только с Faces типа Wall и граничным условием Outdoors.

Для проектной модели полезнее задавать реальные проёмы или использовать компоненты, контролирующие ширину, высоту и шаг. Одинаковый коэффициент остекления может давать разные результаты при другом расположении окон, высоте подоконника и распределении по фасаду. Ladybug Tools

Конструкции

HB ConstructionSet объединяет стандартные конструкции для наружных стен, кровли, пола, внутренних перегородок, окон и дверей. HB Apply ConstructionSet назначает набор помещениям или всей модели.

Отдельные элементы можно переопределить через HB Apply Opaque Construction и HB Apply Window Construction. Такой подход позволяет назначить основной набор всему зданию, а затем заменить конкретные фасады, кровлю или остекление.

ConstructionSet определяет физические свойства ограждений для EnergyPlus, но не внешний вид в Rhino. Материал Radiance и энергетическая конструкция относятся к разным расчётам и требуют отдельных свойств. Ladybug Tools+3Ladybug Tools+3Ladybug Tools+3

ProgramType и расписания

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

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

HVAC

Honeybee поддерживает IdealAir и шаблонные системы HVAC, а также подробные схемы через OpenStudio и дополнительные компоненты. IdealAir удобен для сравнительного анализа оболочки и пассивных мер, поскольку обеспечивает требуемое отопление и охлаждение без подробного моделирования оборудования.

Для оценки реального энергопотребления инженерной системы требуется выбрать корректную конфигурацию, эффективность, режимы, вентиляцию, рекуперацию и уставки. Нагрузка помещения и энергия оборудования — разные показатели.

Запуск расчёта

Типовой процесс:

1. Создать Rooms.

2. Решить adjacency.

3. Добавить Apertures.

4. Назначить ConstructionSet.

5. Назначить ProgramType.

6. Добавить HVAC.

7. Собрать HB Model.

8. Создать HB Simulation Parameter.

9. Передать Model в HB Model to OSM.

10. Запустить HB Run OSM или HB Run OSW.

11. Прочитать SQL и другие выходные файлы компонентами результатов.

HB Model to OSM записывает Honeybee Model в OpenStudio Model, который переводится в IDF и выполняется EnergyPlus. HB Run OSW может только перевести модель или одновременно запустить симуляцию. Ladybug Tools+2Ladybug Tools+2

Быстрые расчёты

HB Annual Loads выполняет оптимизированный расчёт годовых нагрузок на отопление, охлаждение, освещение, оборудование и горячую воду. HB Peak Loads оценивает пиковые нагрузки помещений по летним и зимним расчётным дням.

Эти компоненты удобны для раннего сравнения, но не заменяют подробную модель, когда необходимо исследовать конкретную систему HVAC, автоматику и взаимодействие оборудования. Ladybug Tools+1

Светотехнический анализ с Honeybee Radiance

Sensor Grid

Большинство расчётов освещённости выполняется по Sensor Grid. Сетка содержит точки и направления датчиков. Для рабочей плоскости датчики обычно направлены вверх, а высота определяется назначением помещения и методикой расчёта.

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

Мгновенный расчёт

Point-In-Time Grid-Based вычисляет освещённость для определённого состояния неба. Результат выражается в люксах и отображается цветной сеткой. Point-In-Time View-Based формирует изображение из выбранной точки наблюдения.

В LBT 1.10 появились HB Luminaire и HB LuminaireZone для описания светильников на основе IES-файлов. HB Assign Luminaires добавляет экземпляры светильников в Honeybee Model. Электрическое освещение учитывается в точечных Radiance-рецептах вместе с дневным светом или отдельно. Ladybug Tools | Forum

Annual Daylight

HB Annual Daylight рассчитывает освещённость на датчиках для годовых солнечных часов. Результаты используются для daylight autonomy, continuous daylight autonomy, useful daylight illuminance и других метрик.

HB Annual Daylight Metrics принимает папку результатов и расписание. HB Spatial Daylight Autonomy агрегирует значения по площади. HB Annual Sunlight Exposure определяет долю площади, где прямая освещённость превышает установленный порог заданное количество часов.

Annual Sunlight Exposure по умолчанию использует порог 1000 люкс, но методика итоговой оценки зависит от выбранного стандарта, расписания и корректной подготовки прямого расчёта. Ladybug Tools+2Ladybug Tools+2

Daylight Factor

HB Daylight Factor использует стандартное пасмурное небо. Показатель не зависит от ориентации здания по сторонам света, поэтому подходит для ограниченных сценариев и не отражает климатическую изменчивость конкретного города.

Годовой Annual Daylight учитывает EPW и движение солнца, даёт более содержательную картину, но требует значительно больше времени. Ladybug Tools

Постобработка

В LBT 1.10 компонент HB Annual Statistics ускоряет получение средних, медианных, минимальных, максимальных и накопленных значений из годовых матриц. При наличии совместимого GPU часть операций может выполняться через CuPy. Это особенно полезно, когда не требуется выгружать полный ряд каждого датчика на каждом временном шаге. Ladybug Tools | Forum

Тепловой комфорт

Ladybug содержит модели PMV, Adaptive Comfort, UTCI и связанные инструменты обработки данных. Выбор модели зависит от среды и условий.

PMV применяется для механически кондиционируемых помещений с заданными температурой воздуха, средней радиационной температурой, скоростью воздуха, влажностью, одеждой и метаболизмом. Adaptive Comfort предназначен для помещений, где пользователи адаптируются к наружному климату и могут влиять на условия. UTCI используется для наружной среды.

Средняя радиационная температура может заметно отличаться от температуры воздуха рядом с холодным окном, нагретым фасадом или под прямым солнцем. Компоненты LB Indoor Solar MRT и LB Outdoor Solar MRT учитывают солнечное воздействие на человека. Результат можно передать в модели комфорта или использовать в LB Thermal Shade Benefit. Ladybug Tools+2Ladybug Tools+2

Карты комфорта должны сопровождаться описанием одежды, активности, скорости воздуха, периода и модели. Цветная поверхность без этих параметров не позволяет воспроизвести расчёт.

Городской анализ с Dragonfly

Dragonfly сокращает объём геометрии за счёт Room2D. Пользователь задаёт контуры помещений или этажей, высоту, количество повторяющихся этажей, окна и энергетические свойства. Затем Dragonfly Model переводится в Honeybee Models или формат URBANopt.

Типовой порядок:

1. Подготовить замкнутые плоские контуры.

2. Создать Room2D.

3. Объединить их в Story.

4. Создать Building.

5. Собрать Dragonfly Model.

6. Назначить ProgramType и ConstructionSet.

7. Настроить окна и HVAC.

8. Экспортировать GeoJSON и HBJSON.

9. Запустить URBANopt.

10. Сопоставить результаты с геометрией.

Опция use_multiplier в DF Model To geoJSON позволяет рассчитывать повторяющиеся этажи один раз и умножать результат. Отключение создаёт полную геометрию каждого этажа и увеличивает объём модели. shade_dist ограничивает расстояние включения соседних зданий как затеняющего контекста. Ladybug Tools

Dragonfly также поддерживает районные энергетические системы, грунтовые теплообменники, электрические сети и преобразование погодного файла с учётом острова тепла. Эти сценарии требуют дополнительных движков и существенно сложнее обычного климатического анализа.

CFD с Butterfly

CFD-расчёт начинается с постановки задачи, а не с выбора красивой цветовой шкалы. Для наружного ветра необходимо определить расчётный домен, входной профиль, выход, верхнюю и боковые границы, поверхность земли и здания.

Основные этапы:

1. Очистить геометрию.

2. Создать Butterfly Geometry.

3. Задать Wind Tunnel Parameters.

4. Настроить Meshing Parameters.

5. Добавить Refinement Region.

6. Выбрать модель турбулентности.

7. Создать Case.

8. Назначить Recipe.

9. Сформировать Solution.

10. Контролировать residuals.

11. Импортировать поля скорости и давления.

12. Проверить независимость от сетки.

Увеличение числа ячеек не всегда повышает достоверность. Некорректная геометрия, недостаточный домен или неверный профиль входа могут давать ошибочный результат на очень плотной сетке. Для инженерного вывода требуется проверка сходимости, качества сетки и чувствительности к граничным условиям. Ladybug Tools+2Ladybug Tools+2

Визуализация и экспорт

Ladybug Tools выводит цветные Mesh, линии, точки, текст и объекты VisualizationSet. Для обычного просмотра достаточно Preview компонентов, но для отчёта требуется контролировать положение камеры, масштаб, единицы и диапазон легенды.

LB Preview Visualization Set отображает расширенные VisualizationSet и поддерживает двумерные легенды, закреплённые в плоскости экрана. LB Capture View сохраняет выбранный Rhino viewport в PNG. Можно указать имя вида, ширину, высоту, режим отображения и прозрачный фон. Ladybug Tools+1

Числовые результаты передаются в Panel, записываются в CSV или сохраняются в форматах расчётного движка. Honeybee Model сериализуется в HBJSON, Dragonfly — в JSON и GeoJSON, OpenStudio создаёт OSM, EnergyPlus — IDF, SQL и другие файлы, Radiance — матрицы, изображения и результаты по датчикам.

Bake применим к части геометрии, но запечённая цветная сетка уже не связана с исходными параметрами. Для воспроизводимости нужно хранить .3dm, .gh, EPW и папку результатов вместе.

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

Главные причины медленной работы:

• слишком мелкий grid size;

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

• подробная геометрия мебели и фасадных профилей;

• дублированные поверхности;

• полный городской контекст без ограничения расстояния;

• частый автоматический пересчёт;

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

• вывод полного годового ряда в Grasshopper;

• Preview множества одинаковых сеток;

• хранение больших Data Tree внутри одного файла.

Перед подробным расчётом создайте упрощённую модель. Сначала проверьте один Room, один Sensor Grid и небольшой период. После получения осмысленного результата увеличивайте масштаб.

Для предотвращения случайного перезапуска держите _run в False, используйте Data Dam и отключайте автоматическое обновление параметрической цепочки. Результаты длинных расчётов сохраняйте на диск, а не пересчитывайте при каждом открытии файла.

Incident Radiation и Direct Sun Hours могут использовать несколько процессоров для пересечений. По умолчанию выбирается на одно ядро меньше доступного количества, если процессор не одноядерный. Однако ускорение ограничивается геометрией, памятью и накладными расходами. Ladybug Tools+1

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

Погодные данные

Проверьте местоположение, высоту, часовой пояс и источник EPW. Для проекта в сложном рельефе или удалённой местности одна станция может не отражать локальный микроклимат.

Геометрия

Помещения должны быть замкнутыми и не пересекаться. Внутренние грани обязаны совпадать. Окна должны находиться внутри родительских Faces. Удалите поверхности нулевой площади и чрезмерно короткие рёбра.

Север и координаты

Зафиксируйте, где находится проектный север. Не поворачивайте одновременно и геометрию, и вход north, если это не предусмотрено методикой.

Сетка

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

Энергетические свойства

Проверьте U-value конструкций, коэффициенты остекления, инфильтрацию, вентиляцию, внутренние нагрузки, расписания и уставки. Ошибка в одном расписании может влиять на годовой результат сильнее, чем изменение формы фасада.

Сообщения движка

EnergyPlus создаёт файл ошибок с предупреждениями и критическими сообщениями. Отсутствие Fatal Error означает, что расчёт завершился, но предупреждения всё равно могут указывать на некорректную модель. Radiance и OpenFOAM также требуют контроля логов.

Сравнение вариантов

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

Стоимость и лицензия

Основные компоненты Ladybug Tools распространяются бесплатно с открытым исходным кодом. Страница пакета указывает лицензию AGPL-3.0-or-later. Программа допускает изучение и изменение исходного кода с соблюдением условий лицензии. Food4Rhino

Бесплатность Ladybug Tools не означает бесплатность всего рабочего места. Rhino приобретается отдельно. Некоторые инструменты Pollination, облачные расчёты, обучение и коммерческие услуги имеют собственные условия.

Для локального климатического анализа, Honeybee и большинства открытых компонентов подписка Ladybug Tools не требуется. Учётная запись Pollination нужна для загрузки единого Windows-установщика, но сам LBT Grasshopper Plugin остаётся бесплатным.

При разработке закрытых производных решений на основе исходного кода необходимо отдельно проверить требования AGPL. Использование готового плагина в коммерческом архитектурном проекте и распространение модифицированной программы — разные правовые сценарии.

Преимущества и недостатки

Плюсы:

• климатические, энергетические и светотехнические задачи связаны с геометрией Rhino;

• параметрическая схема позволяет системно сравнивать варианты;

• компоненты имеют открытый исходный код;

• Ladybug работает с общепринятым форматом EPW;

• Honeybee использует EnergyPlus, OpenStudio и Radiance;

• Dragonfly расширяет рабочий процесс до квартала;

• Butterfly обеспечивает связь с OpenFOAM;

• результаты остаются доступными в Grasshopper для дальнейшей обработки;

• пользователь контролирует значительную часть исходных параметров;

• можно создавать собственные компоненты и автоматизацию;

• развитая документация описывает входы и выходы отдельных узлов;

• активный форум содержит разборы ошибок и методик;

• бесплатная основная сборка не ограничивает число локальных проектов;

• ветка 1.10 работает в Rhino 6–8 под Windows и macOS;

• доступны инструменты переноса старых определений;

• в одном проекте можно объединить климат, геометрию, энергию и освещение.

Минусы:

• без понимания Rhino и Grasshopper начать работу трудно;

• визуальное программирование не заменяет знания строительной физики;

• сложные определения содержат множество проводов и Data Tree;

• обновление может потребовать синхронизации компонентов;

• старые Legacy-файлы нельзя считать проверенными сразу после автоматического переноса;

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

• macOS требует больше ручных действий;

• крупные Radiance, EnergyPlus и CFD-модели создают значительную вычислительную нагрузку;

• не все результаты автоматически соответствуют конкретному нормативу;

• некорректные входные данные часто приводят к правдоподобно выглядящей визуализации;

• документация Butterfly относится к более старой архитектуре и требует дополнительной проверки;

• командная работа со сложными .gh требует внутренних стандартов;

• отсутствует единый последовательный мастер моделирования здания;

• типовые отчёты приходится собирать самостоятельно;

• Rhino приобретается отдельно.

Сравнение с аналогами

Ladybug Tools пересекается по функциям с несколькими программами, но не является полным эквивалентом каждой из них. ClimateStudio ближе всего по среде Rhino и Grasshopper, IES VE и DesignBuilder предлагают самостоятельные оболочки для моделирования зданий, а Autodesk Forma ориентирована на быстрые исследования ранней стадии.

Сравнение функций основано на текущих описаниях продуктов: ClimateStudio выполняет параметрические расчёты дневного света и энергии непосредственно в Rhino и Grasshopper; IES VE объединяет инструменты моделирования характеристик здания; DesignBuilder использует EnergyPlus, Radiance и собственный CFD-интерфейс; Forma предлагает солнечный, ветровой, шумовой и другие виды анализа ранней стадии. Autodesk+4Solemma+4iesve.com+4

Ladybug Tools и ClimateStudio

ClimateStudio ближе остальных к Ladybug Tools по рабочей среде. Оба решения работают в Rhino и поддерживают Grasshopper. ClimateStudio предоставляет более цельный коммерческий интерфейс для дневного освещения и энергетики, а Ladybug Tools даёт открытые компоненты и больше свободы в построении нестандартных цепочек.

Для специалиста, которому нужны стандартизированные светотехнические исследования и быстрый запуск без сборки длинного определения, ClimateStudio проще. Для исследований, автоматизации, модификации алгоритмов и объединения нескольких движков Ladybug Tools предоставляет больше контроля.

Ladybug Tools и IES VE

IES VE — комплекс с собственными модулями и последовательным процессом построения модели. Он удобнее для организаций, которым требуются установленные процедуры, отчёты и единая среда инженерных расчётов.

Ladybug Tools выигрывает в параметрическом управлении геометрией. Форма, ориентация, фасад и другие параметры могут быть частью одного алгоритма. Недостаток — необходимость самостоятельно выстроить и проверить весь workflow.

Ladybug Tools и DesignBuilder

DesignBuilder предоставляет графическую оболочку для EnergyPlus, дневного освещения, CFD и оптимизации. Пользователь работает с древовидной структурой проекта и свойствами объектов, а не собирает компоненты Grasshopper.

DesignBuilder быстрее осваивается специалистом, которому требуется моделировать типовые здания. Ladybug Tools лучше подходит для сложной параметрической геометрии и автоматизированных серий вариантов, но требует навыков Grasshopper.

Ladybug Tools и Autodesk Forma

Forma ориентирована на раннюю стадию и облачную работу с массингом. Анализ солнца, солнечной энергии, дневного потенциала и ветра запускается непосредственно в проектной модели.

Ladybug Tools требует больше подготовки, но позволяет глубже контролировать входные данные и продолжить исследование от климата до EnergyPlus, Radiance и OpenFOAM. Forma практичнее для быстрого сравнения генплана, Ladybug Tools — для воспроизводимой параметрической методики.

Отзывы пользователей и профильных изданий

Первичная публикация Ladybug в материалах IBPSA выделяла интерактивную визуализацию EPW и возможность получать обратную связь непосредственно в Rhino/Grasshopper. Эта особенность остаётся главным достоинством комплекса: экологический анализ не отделён от геометрической модели. IBPSA Publications

Школа дизайна Пенсильванского университета характеризует Ladybug Tools как одну из наиболее полных открытых экосистем экологического проектирования, связывающую CAD с проверенными расчётными движками. Профессиональные и образовательные материалы используют Ladybug как инструмент параметрического анализа среды, а не как простой генератор диаграмм. Дизайн Университета Пенсильвании

ArchDaily упоминает Ladybug в материалах о вычислительном проектировании и в описаниях реализованных объектов. В проекте Shade School Playground Pavilion инструмент применялся для расчёта доли прямого светового воздействия и проектирования затеняющей конструкции. Это показательный сценарий: результат расчёта напрямую влияет на форму, а не добавляется после завершения архитектурного решения. ArchDaily+1

Food4Rhino фиксирует более 940 тысяч загрузок страницы пакета. Количество загрузок не равно числу активных пользователей, но показывает значительное распространение инструмента среди аудитории Rhino и Grasshopper. Food4Rhino

В пользовательских обсуждениях регулярно повторяются несколько положительных оценок:

• свобода параметрического моделирования;

• бесплатный доступ к основной сборке;

• возможность проследить путь данных;

• качественная визуализация в Rhino;

• связь с EnergyPlus и Radiance;

• большое количество примеров;

• активный профильный форум;

• применимость в обучении и исследованиях.

Повторяющиеся затруднения связаны с другим:

• необходимость предварительно освоить Rhino и Grasshopper;

• ошибки установки и путей;

• несовместимость старых определений;

• различия между Legacy и новой веткой;

• сложные Data Tree;

• продолжительные расчёты;

• трудность поиска причины красного компонента;

• необходимость самостоятельно оценивать физическую корректность.

На форуме Ladybug Tools новичкам рекомендуют сначала освоить базовые компоненты Rhino и Grasshopper. Обсуждения выпусков показывают положительную реакцию на новые функции, но одновременно содержат вопросы об обновлении, совместимости и переносе старых файлов. Ladybug Tools | Forum+2Ladybug Tools | Forum+2

Усреднённая оценка выглядит так: Ladybug Tools высоко ценят за гибкость, открытость и глубину, но не считают простой программой для пользователя без опыта визуального программирования и строительной физики.

Для кого предназначена программа

Архитекторы

Ladybug подходит для сравнения ориентаций, форм, коэффициента остекления, затенения, солнечной радиации и дневного света. На раннем этапе можно начать с EPW и геометрии, не создавая полную инженерную модель.

Инженеры по энергоэффективности

Honeybee предоставляет доступ к EnergyPlus и OpenStudio, позволяет назначать конструкции, нагрузки, расписания и HVAC. Для рабочих проектов требуется собственный стандарт моделирования и проверка входных данных.

Светотехники

Honeybee Radiance поддерживает мгновенные и годовые расчёты, Sensor Grid, показатели автономии дневного света, солнечную экспозицию, изображения и электрические светильники на основе IES.

Градостроители

Dragonfly применяется для кварталов, городской энергетики, острова тепла, электрических сетей и районных систем. Его упрощённая геометрия уменьшает объём модели по сравнению с подробным Honeybee.

Исследователи

Открытые библиотеки, JSON-модели и параметрическая среда удобны для воспроизводимых экспериментов, чувствительности, оптимизации и разработки собственных методов.

Студенты

Комплекс помогает понять связь между погодой, формой, оболочкой и потреблением энергии. Однако использование готового файла без понимания компонентов приводит к копированию результатов, которые невозможно объяснить.

Типичные ошибки

Использование Legacy-руководства

Названия компонентов Legacy отличаются от LBT 1.x. Старый видеоурок может показывать отсутствующий узел или другую структуру данных. Проверяйте версию интерфейса и используйте документацию текущей ветки.

Неправильный север

Ошибка в северном направлении влияет на Sun Path, радиацию, солнечные часы, окна по ориентациям и энергетический расчёт.

Слишком подробная геометрия

Дверные ручки, мебель, мелкие фасадные профили и декоративные элементы редко нужны в энергетической модели. Они увеличивают число поверхностей и вызывают ошибки.

Незамкнутые помещения

HB Room требует корректного объёма. Незамкнутая Brep не становится надёжной энергетической зоной только потому, что визуально похожа на комнату.

Несовпадающие внутренние поверхности

Смежные Rooms должны иметь одинаковые грани. Иначе adjacency не решается или теплопередача назначается неверно.

Автоматические свойства без проверки

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

Очень мелкая сетка

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

Неограниченная легенда

Автоматические пределы мешают сравнивать варианты. Для серии моделей используйте одинаковый минимум и максимум.

Игнорирование warnings

Расчёт может завершиться с предупреждениями. Они нередко указывают на вырожденные поверхности, несовместимые свойства и проблемы EnergyPlus.

Смешивание единиц

Радиация в кВт·ч/м², облучённость в Вт/м², освещённость в люксах и нагрузка в ваттах описывают разные величины. Цветные сетки нельзя сравнивать только по оттенку.

Перезапуск тяжёлого расчёта

Оставленный True на входе _run может запустить симуляцию после любого изменения. После завершения переключайте Toggle в False и сохраняйте результаты.

Часто задаваемые вопросы

Ladybug Tools работает без Rhino?

Основная пользовательская сборка LBT Grasshopper работает внутри Rhino и Grasshopper. Отдельные core-библиотеки могут использоваться разработчиками вне Rhino, но обычный архитектурный workflow требует Rhino.

Нужно ли устанавливать Grasshopper отдельно?

В Rhino 6–8 Grasshopper входит в поставку и запускается командой Grasshopper.

Ladybug Tools бесплатна?

Основная сборка бесплатна и распространяется по AGPL-3.0-or-later. Rhino, коммерческие плагины Pollination, обучение и облачные вычисления оплачиваются отдельно.

Есть ли русский интерфейс?

Названия компонентов, входов, выходов и документация представлены на английском. Русифицированного интерфейса основной сборки нет.

Можно ли использовать программу в macOS?

Ветка 1.10 поддерживает Rhino 6–8 в macOS. Установка выполняется через installer.gh, а движки устанавливаются отдельно для соответствующих задач.

Чем Ladybug отличается от Honeybee?

Ladybug работает с погодой, диаграммами и быстрым анализом геометрии. Honeybee создаёт модели зданий для EnergyPlus, OpenStudio и Radiance.

Нужен ли Honeybee для радиации?

Для простого Incident Radiation достаточно Ladybug. Honeybee Radiance требуется для сложных сцен, отражений и подробных светотехнических рецептов.

Можно ли рассчитывать энергопотребление без OpenStudio?

Honeybee использует OpenStudio как часть основного процесса подготовки энергетической модели и EnergyPlus как расчётный движок. Для стандартного Honeybee Energy workflow нужна совместимая установка.

Где брать EPW?

EPW загружается из климатических баз, включая EPWMap и другие каталоги EnergyPlus Weather. Перед использованием проверяются координаты, период и соответствие станции площадке.

Можно ли выполнить нормативный расчёт инсоляции?

Direct Sun Hours предоставляет геометрический расчёт продолжительности прямого солнца. Соответствие конкретному нормативу зависит от требований страны, расчётных дат, точек, интервалов и допустимого программного обеспечения. Готового универсального сертификата компонент не создаёт.

Использует ли Ladybug Tools видеокарту?

Большинство компонентов не зависит от GPU как от основного вычислителя. В LBT 1.10 часть постобработки Radiance поддерживает CuPy на совместимом GPU.

Можно ли работать с Revit?

Открытая сборка ориентирована на Rhino и Grasshopper. Pollination предлагает отдельный Revit plugin для подготовки и передачи Honeybee Models.

Что сохранять вместе с проектом?

Минимальный комплект включает .3dm, .gh, EPW, пользовательские JSON-библиотеки, папку результатов, описание версии LBT и список движков.

Почему файл открылся с устаревшими компонентами?

Он создан в другой версии. Используйте LB Sync Grasshopper File или LB Legacy Updater на копии и затем проверяйте результат.

Итог

Ladybug Tools подходит для проектов, где экологический анализ должен оставаться связанным с параметрической геометрией. Ladybug закрывает климат и быстрые исследования, Honeybee — энергетику и дневное освещение, Dragonfly — районный масштаб, Butterfly — CFD, Fairyfly — двумерные тепловые мосты.

Для первого знакомства достаточно трёх операций: импортировать EPW, построить Sun Path и выполнить Direct Sun Hours на простой поверхности. После освоения Data Collection, Analysis Period, легенд и геометрии можно переходить к Honeybee Room и EnergyPlus.

В производственном проекте главная сложность заключается не в поиске компонента, а в организации проверяемой модели. Необходимо фиксировать версию, север, EPW, единицы, сетку, конструкции, расписания и параметры движка. При таком подходе Ladybug Tools становится не набором цветных диаграмм, а воспроизводимой системой сравнения архитектурных и инженерных решений.