[2026-11-20] eagle: family/tech/ventilation-ha-nodered.md personal/projects/personal-os/personal-os-evidence/2026-11-19/follow-up-live-acceptance.md personal/projects/personal-os/personal-os-production-acceptance.md personal/projects/personal-os/personal-os-project-management.md personal/projects/personal-os/personal-os-remediation-plan-2026-11-18.md personal/projects/personal-os/personal-os-tasks.md

This commit is contained in:
Alexey Martemyanov committed 2026-11-20 13:48:58 +06:00
1 parent 9047ac936c
commit cab5602a68
6 files changed
+88 -28

No files matched your search

+72 -23
View File
@@ -16,14 +16,14 @@ tags:
created: '2026-11-20'
updated: '2026-11-20'
status: >-
Скоуп уточнён; платформа не выбрана; исходный flow разобран, измерения и
сквозная приёмка предстоят
Моделирование: OpenModelica + Buildings + Python; синтетический конвейер
проверен; модель дома и натурная приёмка предстоят
---
# Вентиляция — калибровка, сценарии и система автоматики
Рабочий документ проекта законченной системы вентиляции: калибровка датчиков температуры и качества воздуха, измерение потоков, описание и воспроизведение сценариев, настройка реакций и сборка проверяемой конфигурации.
**Для моделирования воздушной сети выбран CONTAM** (решение и ограничения — §0.4.1). **Платформа автоматики пока не выбрана.** Node-RED — существующая реализация для разбора и источник исходного состояния. Конечная система может использовать другую подходящую платформу; дальнейшие требования задаются через поведение и результаты измерений.
**Для моделирования выбран комплект OpenModelica + Buildings + Python** (§0.4.1–0.4.4): проверены пакетные расчёты и автоматическая подгонка на синтетической сети. Прежний выбор CONTAM заменён. **Платформа автоматики пока не выбрана.** Node-RED — существующая реализация для разбора и источник исходного состояния. Конечная система может использовать другую подходящую платформу; дальнейшие требования задаются через поведение и результаты измерений.
Карта оборудования, адреса Modbus, регистры и доступ к хосту остаются в [[family/how-to/home-automation]]. Реализация кухонной вытяжки — [[family/tech/kitchen-hood-fan-template]].
@@ -90,31 +90,80 @@ status: >-
Результат проекта — собранная и проверенная система, поведение которой подтверждено измерениями и прогонами сценариев. Выбор или запуск движка автоматики сам по себе завершением не считается.
### 0.4.1. Выбранная система моделирования — CONTAM
### 0.4.1. Пересмотр выбора: OpenModelica + Buildings + Python
Решение 2026-11-20: для первого этапа моделирования воздушной сети дома выбран **NIST CONTAM**. Это выбор расчётного инструмента; платформа действующей автоматики остаётся открытым решением.
Решение 2026-11-20 после повторного анализа: для моделирования выбран **OpenModelica + Modelica Buildings + Python**. Прежний выбор CONTAM заменён. Платформа исполнения действующей автоматики при этом не выбрана.
Основание выбора: непосредственное соответствие задаче комнат, дверей, приточных/вытяжных путей и вентиляторов, готовый графический редактор и расчёт потоков/давлений/переноса загрязнений. Оценка удобства относительно Modelica/EnergyPlus сделана по документации; практическое время освоения и запуск в текущем окружении ещё не проверены.
**Главный критерий:** минимальное ручное участие владельца. Создание и изменение модели, расчёт конфигураций, обработка измерений и подбор параметров должны выполняться программно. Простота графического редактора сама по себе этому критерию не соответствует.
Рабочий подход:
- Представить помещения зонами, а двери, приток, вытяжку и воздуховоды — путями воздуха.
- Задать характеристики вентиляторов и сопротивления путей/положений заслонок, наружные условия и источники загрязнений.
- Сопоставить расчётные расходы с замерами и уточнить параметры модели.
- Проверять конфигурации дверей, заслонок, скоростей и сценарии занятости/отсутствия по расходам и динамике CO₂.
- Использовать результаты при настройке правил автоматики. Переход от модели к исполнительной системе требует отдельной реализации и сквозной проверки.
Выбранный комплект:
- **OpenModelica** — компиляция и расчёт текстовой модели без GUI; испытан официальный Docker-образ ARM64 на текущем Mac.
- **Modelica Buildings** — открытая библиотека готовых компонентов: помещения, двери, сопротивления, заслонки, вентиляторы, перенос загрязнений и отопление.
- **Python** — подготовка входных данных, формирование модели/параметров, запуск серий, сравнение с измерениями, подгонка и отчёты.
- **Программная 3D-геометрия из тех же данных помещений** — отдельное представление модели для визуальной проверки. В испытании сформированы OBJ и PNG; ручное рисование владельцем в CAD не требуется для такого маршрута.
Ограничения выбора:
- ContamW — графический редактор для Windows. На текущем Mac потребуется доступное Windows-окружение; его наличие и совместимость не проверены. Расчётное ядро ContamX распространяется также для Linux.
- Программа бесплатная, NIST обозначает её как public domain. Публичная доступность полных исходников ядра не подтверждена; не считать этот выбор гарантией полностью открытого исходного кода.
- Для первого этапа используется многозонная модель. Подробное распределение струй и застойных зон внутри помещения требует отдельной детализации/CFD.
- Калибровка физических датчиков и натурные измерения остаются самостоятельными работами. Достоверность прогноза требует проверки параметров дома по измерениям.
- Установка, модель конкретного дома и расчётные прогоны пока не выполнены.
Это комплект разработки модели. Готового универсального мастера «загрузить план и замеры → получить всю настроенную систему» не подтверждено. Труд разработки конвейера ложится на программную реализацию, а не на ручную работу владельца в интерфейсе.
Источники выбора:
- [CONTAM: назначение, платформы и условия распространения — NIST](https://www.nist.gov/services-resources/software/contam).
- [CONTAM: вентиляция, воздушные сети и сценарии — NIST](https://www.nist.gov/el/beed/nist-multizone-modeling/applications/airflow-and-ventilation).
- [Актуальная загрузка CONTAM — NIST](https://www.nist.gov/el/beed/nist-multizone-modeling/software/contam/download-contam).
- [Modelica Buildings: библиотека моделей зданий и управления](https://simulationresearch.lbl.gov/modelica/).
### 0.4.2. Практическая проверка нового маршрута
Выполнен синтетический тест, без участия реального оборудования и без физических измерений дома:
- Среда: текущий Mac ARM64 → Docker/Colima Linux ARM64.
- Компилятор: OpenModelica 1.27.1. Библиотека: Buildings 14.0.0.
- Программно подготовлена модель двух помещений, двух приточных заслонок, открываемой двери и вытяжного вентилятора с характеристикой давления/расхода.
- Пакетный `omc` успешно скомпилировал модель: 386 уравнений и 386 переменных.
- Прогнаны пять конфигураций: дверь закрыта/открыта, низкая скорость fan, ограниченная заслонка A, отдельная контрольная конфигурация.
- Подтверждены баланс расходов и изменения результата при изменении двери, скорости и заслонки.
- Автоматически восстановлен один параметр сопротивления: истинное значение 1.7, начальное приближение 0.8, результат около 1.7. Подгонка по четырём конфигурациям, проверка на пятой; 62 вызова расчётного исполняемого файла.
- Из общего `fixture.json` получены расчётные объёмы и тестовая 3D-геометрия двух помещений; OBJ и изображение созданы программно.
- Воспроизводимый `verify.sh` дополнительно выполнен в новом чистом контейнере: код завершения 0, восемь проверок пройдены. Временные контейнеры после сохранения результатов удалены.
Наблюдения для подгонки сгенерированы тем же симулятором без шума. Такой тест подтверждает техническую работоспособность автоматической подгонки, а не точность модели реального дома и не возможность восстановить произвольное число неизвестных из любых замеров.
Артефакты в проекте `/Users/admin/Automation/HA-ZONT-Modbus/homeassistant/modeling-evaluation/2026-11-20/`:
- `README.md` — полный пересмотр, метод, ограничения и источники.
- `verify.sh` — воспроизводимый прогон в одноразовом контейнере.
- `fixture.json`, `TwoRoomTrial.mo`, `evaluate.py` — исходные данные и расчёт.
- `results.json`, `compile.log` — результаты и диагностический лог.
- `geometry.py`, `rooms.obj`, `preview.png` — проверка программной 3D-геометрии.
### 0.4.3. Сравнение кандидатов по критерию автономной работы
- **OpenModelica + Buildings + Python — выбран.** Текстовые модели, произвольная сеть компонентов, пакетные расчёты, открытый код и перспектива добавления отопления. На текущем окружении фактически проверены компиляция, серии расчётов и автоматическая подгонка. Удобство для владельца достигается автоматизацией подготовки, а не необходимостью изучать Modelica.
- **EnergyPlus + AirflowNetwork — альтернативный кандидат.** Есть нативная macOS ARM64-сборка, CLI/Python API и epJSON для программного создания модели. Хорошо подходит для совместного расчёта здания и энергопотребления. Часть воздушной сети привязана к структуре HVAC/air loops и имеет документированные ограничения. Оценка более сложной адаптации двух общих вытяжных групп — инженерный вывод по документации; практический сравнительный прогон не выполнен.
- **CONTAM — снят статус окончательного выбора.** Расчётные возможности подходят, и работа не обязана сводиться к ручному GUI: NIST описывает API расчёта и создания/изменения проектов. Однако полный программный маршрут на текущем ARM64-окружении не проверен. Windows-редактор и наличие функций воздухообмена не были достаточным основанием назвать систему самой удобной для автономного выполнения работ.
- **OpenFOAM/Carbonfly — возможная последующая детализация.** Предназначены для пространственных потоков внутри помещений. Для первого этапа расходов между комнатами добавляют подготовку сетки и граничных условий. Практически не испытывались.
Вывод о предпочтительности OpenModelica относится к заданному способу работы и проверенному небольшому прототипу. Он не является заявлением о превосходстве во всех задачах и не заменяет проверку полной модели дома.
### 0.4.4. Что может выполняться программно и где остаётся участие владельца
Программная часть проекта:
- Восстановление описания помещений по имеющимся планам и размерам, генерация проверяемого 3D-представления.
- Создание сети путей воздуха и моделей оборудования.
- Подготовка пошаговых заданий для замеров и привязка каждого результата к конфигурации.
- Обработка измерений, подбор определяемых по ним параметров, оценка расхождения на отдельных контрольных замерах.
- Прогон сценариев, подбор режимов, подготовка правил/конфигурации будущей автоматики и документации.
Участие владельца требуется для физических сведений, которых нет в исходниках: подтвердить фактический монтаж/геометрию, выполнить измерения, отметить состояние дверей и механизмов, подтвердить конечную физическую реакцию. При доступном управлении оборудованием переключение испытательных конфигураций можно автоматизировать; такой живой маршрут ещё не проверен.
В проекте уже есть планы этажей, размерные изображения и разрез. `floorplan/PLAN.md` указывает отсутствие схемы вентиляции в исходном проекте. Фактические трассы и размеры каналов нельзя получить из условных иконок HA.
Границы текущей проверки:
- Полученная тестовая 3D-геометрия — два прямоугольных объёма, не модель реального дома.
- В синтетическом прогоне не проверялись CO₂/TVOC/PM, ветер, температурная тяга, отопление и вся сеть дома; это следующие составные части модели.
- `DoorOperable` для промежуточного входа `y` интерполирует между закрытой и открытой дверью. Это не угол открытия; точную зависимость для приоткрытой двери требуется определить измерениями.
- Типовая характеристика заслонки не заменяет измерение расхода при её реальных дискретных положениях.
- Для натурной подгонки нужны достаточные измерения и раздельная контрольная выборка. Одной удачной синтетической подгонки недостаточно для полевой валидации.
- Установка на HA, управление механизмами, окончательная модель дома и сквозная приёмка этим анализом не выполнены.
Источники:
- [OpenModelica: официальный Docker ARM64 и пакетный omc](https://openmodelica.org/download/docker/).
- [Buildings 14.0.0: испытанные версии компиляторов](https://github.com/lbl-srg/modelica-buildings/releases/tag/v14.0.0).
- [Buildings: многозонные модели и ограничения DoorOperable](https://simulationresearch.lbl.gov/modelica/releases/v14.0.0/help/Buildings_Airflow_Multizone.html).
- [SciPy: подбор параметров методом least_squares](https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.least_squares.html).
- [EnergyPlus: воздушная сеть и ограничения](https://energyplus.readthedocs.io/en/stable/guides/input-output-reference/1.27-group-airflow-network.html).
- [EnergyPlus: программный формат epJSON](https://energyplus.readthedocs.io/en/v25.1.0/essentials/essentials.html).
- [NIST: Development and Application of CONTAM APIs](https://www.nist.gov/publications/development-and-application-contam-apis).
### 0.5. Первичный состав системы для уточнения