# Подготовленное исполнение выражений · 0.5.2

Исследование подготовленного исполнения поведенческих источников внутри
ngspice. Все сравниваемые сборки используют одинаковую схему Tennis for Two,
профиль 0.3.1, модели компонентов и численные допуски. Это опыт ядра 0.5.2;
текущий прибор описан в [полном исследовании](research.html).

## Исполнение

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

Порядок вычисления аргументов и арифметических действий сохранён.
Условные выражения представлены переходами: вычисляется выбранная ветвь.
Общие подвыражения переиспользуются только в пределах одного вызова IFeval.
Каждый следующий вызов получает новую метку, включая итерации Ньютона
и следующие временные точки.

Вызовы математических функций, обработка деления и степеней используют
прежние функции ngspice. Сохраняется double. Выражения ddt и неизвестные
операторы с приватными данными используют прежний вычислитель. PWL
поддерживается вместе с производными. Число узлов ограничено 8192,
инструкций — 65536, глубина подготовки — 256; превышение возвращает
выражение к прежнему вычислителю. Программа освобождается при удалении
дерева схемы.

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

## Проверки

Дифференциальный C-тест сравнивает с вычислителем 0.5.1 результаты и
вспомогательные выходы побитово: 100401 вызов, 1000 случайных графов,
условные ветви с ошибкой области определения в невыбранной ветви,
изменение приватных данных PWL между вызовами, stateful fallback,
время, температура, частота и возврат при превышении глубины.

AddressSanitizer и UBSan прошли. В этом изолированном тесте проверен
нулевой баланс выделений после удаления каждого графа. LeakSanitizer
в данной среде завершился ошибкой доступа к /proc; его результат
исключён. Повторный тест использовал ASan с detect_leaks=0 и отдельный
счётчик выделений. Это ограниченная проверка памяти нового вычислителя,
а не всего ngspice.

Девять интеграционных SPICE-сценариев проверяют нелинейные выражения,
условные ветви, ddt, два gmin, AC-якобиан, PWL, время/температуру,
частоту и 20 последовательных reset с пересозданием схемы. Нативная
сборка подтвердила фактическую подготовку 94 выражений общей схемы.

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

## Исходная правка

Кумулятивная правка C: `../vendor/source/ngspice45.2-tft-eval2.patch`.
База сравнения — исходный ngspice 45.2. Варианты отличаются подготовленным
или прежним вычислителем выражений, уровнем оптимизации и применением LTO.

## Измеренный результат

| Вариант | Node/WASM, s | Chrome Worker, s |
|---|---:|---:|
| Игра 0.5.1 · O2 / кэш | 6.607 | 6.528 |
| Кэш · O3 | 6.306 | 6.465 |
| Кэш · O3 / LTO | 6.563 | 6.431 |
| Подготовленные выражения · O3 | 5.319 | 5.499 |
| Подготовленные выражения · O3 / LTO | 5.357 | 5.717 |

По три повтора каждого варианта в каждой среде. Node: 6.607 → 5.319 s,
время уменьшилось на 19.5%. Браузер: 6.528 → 5.499 s,
на 15.8%. Выбран вариант подготовленного вычислителя с O3,
без LTO. Это результат этих двух сред, а не рейтинг для всех устройств.

Одинаковая непрерывная PWL-подача общей экспериментальной схемы: 0,4 s
модели, 69 сигналов, 400 строк на сетке 1 ms, 17 значащих цифр. Во всех
15 Node- и 15 браузерных запусках выгрузки совпали. Загрузка WASM и source
исключены из времени; начальное установление включено. Это вычислительный
опыт, а не кадровая частота интерактивной игры.

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

Все 32 игровые проверки повторно пройдены: 15 вычислителя, 9 экранного
стенда и 8 CPU; пропусков нет, сравнения с нативным ngspice включены.
Данные и области проверки: [prepared-evaluator-validation.json](prepared-evaluator-validation.json).

В этом браузерном опыте ядра 0.5.2 общая экспериментальная схема потребовала
примерно 13,7 секунды часов на секунду модели. Это не замер интерактивного
цикла текущей игры. Mac M1 / Firefox требует отдельной проверки. В текущем
приборе вычислитель и переключатель работают в одном переходном анализе;
пассивное питание переключателя включено в общую схему, остальные макромодели описаны явно.
