Валидационная кампания на 115 прогонов и Docker-образ для сервера

bench/ — список сценариев (порождается gen_scenarios.py, а не правится
руками), драйверы под Linux и Windows, предполётная проверка и описание.
Девять групп: эталоны первоисточников, цилиндр против литературы, модели
стенки и субсеточность, профили крыла, сложная и множественная геометрия,
границы домена, старт и время жизни, внутренние инварианты, сверхмелкие
сетки до 4096×2048. Стоимость планируется в обновлениях узлов —
единственной переносимой между машинами мере; в часы драйвер переводит её
по фактическим MLUPS, которые замеряет на месте (--calibrate). Итого
3.76e14 обновлений, ≈90 часов на 4070 Ti.

Гифки пишутся на всю длительность прогона в реальном времени, 10 кадр/с.
Число кадров этим задано жёстко, поэтому размер регулируется только кадром:
замерено 0.103 байта на пиксель после LZW, отсюда бюджет кадры×пиксели с
нижней границей по ширине. Итог 4.4 ГБ, самый тяжёлый файл 226 МБ.

preflight.py гоняет каждый сценарий на два шага. Окупился сразу: поймал,
что вся группа сверхмелких сеток падала на пределе GPU, а девять прогонов
группы F передавали --body-x дважды. Оба отказа проявились бы только на
сервере, часов через двадцать после старта кампании.

Docker: двухстадийная сборка, в образе libvulkan1 и vulkan-tools.
NVIDIA Container Toolkit подкладывает Vulkan-ICD только при graphics в
NVIDIA_DRIVER_CAPABILITIES — без него wgpu не увидит карту, поэтому
capabilities прописаны в образе, а vulkaninfo лежит внутрь для проверки.
ENTRYPOINT — драйвер кампании, CMD по умолчанию --dry-run, чтобы случайный
docker run не запустил сточасовую задачу. Проверено локально: образ
собирается, смоук проходит с монтированием результатов на хост, физика
совпадает с хостовой до последней цифры, --backend gpu без карты отказывает
явно. GPU-путь в контейнере проверяется только на машине с картой.

В README поправлено разделение вкладов в продольную акустику: измерением
2×2 показано, что 74.9% → 1.1% даёт ОДНОРОДНЫЙ СТАРТ, причём при полностью
выключенной губке, а губка снимает лишь остаток (1.12% → 0.83% при
утроении длины). При старте из покоя губка не помогает совсем — у стоячей
четвертьволновой моды там узел давления, где вязкость её не трогает.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

docs/theory/2d_solver/Dockerfile

@@ -0,0 +1,51 @@
+# Образ для развёртывания решателя и валидационной кампании на сервере с NVIDIA.
+#
+# Сборка и запуск:
+#   docker build -t kbc2d docs/theory/2d_solver
+#   docker run --rm --gpus all kbc2d --calibrate            # проверить, что GPU виден
+#   docker run -d  --gpus all -v "$PWD/out:/work/bench/out" --name kbc2d kbc2d --resume
+#
+# ГЛАВНАЯ ТОНКОСТЬ — Vulkan в контейнере. NVIDIA Container Toolkit подкладывает внутрь
+# Vulkan-ICD (nvidia_icd.json) только если в NVIDIA_DRIVER_CAPABILITIES есть `graphics`.
+# С одним `compute` wgpu не увидит НИ ОДНОГО адаптера и решатель откажется стартовать с
+# --backend gpu. Поэтому capabilities прописаны в образе, а vulkan-tools положен внутрь,
+# чтобы первым делом можно было выполнить `vulkaninfo` и убедиться, что карта видна.
+
+# ── сборка ───────────────────────────────────────────────────────────────────
+# Версия тулчейна закреплена: та же, на которой решатель собирался и проверялся.
+FROM rust:1.97-bookworm AS build
+WORKDIR /src
+
+# Сначала только манифесты — тогда слой с зависимостями переиспользуется, пока они не менялись.
+COPY Cargo.toml Cargo.lock ./
+RUN mkdir src && echo 'fn main() {}' > src/main.rs \
+ && cargo build --release --locked 2>/dev/null || true \
+ && rm -rf src
+
+COPY src ./src
+# touch нужен, чтобы cargo не спутал новые исходники с заглушкой из слоя выше
+RUN touch src/main.rs && cargo build --release --locked
+
+# ── исполнение ───────────────────────────────────────────────────────────────
+FROM debian:bookworm-slim
+LABEL org.opencontainers.image.title="kbc2d"
+LABEL org.opencontainers.image.description="Двумерный решатель LBM D2Q9 с энтропийным столкновением KBC"
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        libvulkan1 vulkan-tools python3 ca-certificates \
+ && rm -rf /var/lib/apt/lists/*
+
+# Без graphics в списке возможностей Vulkan-ICD внутрь не попадёт — см. шапку.
+ENV NVIDIA_VISIBLE_DEVICES=all
+ENV NVIDIA_DRIVER_CAPABILITIES=compute,utility,graphics
+
+WORKDIR /work
+COPY --from=build /src/target/release/kbc2d /work/target/release/kbc2d
+COPY bench /work/bench
+RUN chmod +x /work/bench/run_campaign.sh
+
+# Кампания идёт десятки часов, поэтому по умолчанию образ НЕ запускает её: случайный
+# `docker run` покажет смету и выйдет.
+WORKDIR /work/bench
+ENTRYPOINT ["./run_campaign.sh"]
+CMD ["--dry-run"]