FOLDIFF — АНАЛИЗАТОР ЭНЕРГЕТИЧЕСКИХ ЛАНДШАФТОВ / STAGE 1 Версия 0.1.0 · 14 октября 2026 · только локально Назначение Анализ уже полученной обычной молекулярной динамики через одну пару торсионных углов phi/psi. Это не симулятор MD, не полный многомерный ландшафт белка и не расчёт абсолютного изменения стабильности мутанта. Численный тест на аланиновом дипептиде не валидирует произвольный белок. Вход CSV/TSV, ровно четыре столбца: trajectory,time_ps,phi_deg,psi_deg Время в пикосекундах, углы в градусах [-180,180]. Строки каждой серии строго упорядочены. Постоянный шаг, одинаковый для всех серий; допуск max(1e-6 ps, dt*1e-5). От 40 кадров в серии, до 12 серий, до 250000 кадров суммарно, до 32 MiB файла. Идентификаторы не могут содержать разделитель или кавычки. Запятые — разделители, десятичная точка. Название, температура в K, источник/условия вводятся явно. CSV не несёт 3D-координаты. PDB без временной выборки не позволяет оценить вероятность. JSON: schema='foldiff-landscape-1'; sampling='unbiased-md'; temperature_K; title; provenance; trajectories=[{id,samples:[[time_ps,phi_deg,psi_deg],...]}]. Дополнительно: torsion_atom_serials={phi:[s1,s2,s3,s4],psi:[s1,s2,s3,s4]}, где s — серийные номера ATOM/HETATM в PDB (не индексы массива). representatives=[{trajectory,sample_index,pdb}]. sample_index — индекс строки samples, начиная с нуля. Для каждого кадра проверяются координаты, наличие четырёх атомов каждого угла и периодическое отличие от таблицы не больше 1 градуса. Это допуск импорта, не погрешность физической модели. Без координат доступны карта, диагностика и экспорт, но не 3D. JSON экспорта содержит project + result + параметры + SHA-256 проекта; при импорте расчёт выполняется заново, сохранённые result не считаются доверенными. SHA-256 относится к сериализации JSON проекта в браузере, а не к исходному файлу CSV или порядку ключей чужого JSON. Перед импортом нужно подтвердить отсутствие bias-потенциала. Метадинамика, umbrella sampling, неравномерно выбранные кадры и неизвестные веса не поддержаны. По координатам нельзя самостоятельно доказать отсутствие смещения: это ответственность паспорта данных. Не объединять разные температуры, силовые поля, конструкты или условия как одну выборку. Расчёт 1. Удалить явно выбранный начальный интервал каждой серии; по умолчанию 0. Никакая эквилибрация автоматически не считается проведённой. 2. Wrap углов в [-180,180), 180 эквивалентно -180. Сетка 18/36/72 на ось; равные по площади ячейки, строка массива соответствует psi, столбец phi. 3. Число кадров n_i, без сглаживания и псевдонаблюдений. 4. F_i=R*T*ln(n_max/n_i), R=0.00831446261815324 kJ/(mol K). Значение отсутствует при n_i0.1 — только инженерная отметка для просмотра. Ни низкая JSD, ни малый разброс не доказывают обход всех метастабильных состояний. Значение зависит от числа кадров и выбранной сетки. Четыре последовательных блока на каждую траекторию. Для каждой ячейки считается F блока относительно одной фиксированной опорной ячейки общего распределения. SD между блоками (ddof=1), только если обе ячейки наблюдались во всех блоках. Это описательный разброс, не SE и не CI. Для опорной ячейки F=0 и SD=0 по определению. Длины блоков видны в JSON. Блоки одной траектории не объявляются независимыми повторными опытами. Ориентировочная ESS: для sin/cos каждого угла считаются автокорреляции, положительная последовательность пар rho(1)+rho(2), rho(3)+rho(4), ..., монотонное усечение сумм пар; g=max(1,1+2*sum(rho)). Берём максимальное g из четырёх каналов, ESS=N/g. Окно min(256,floor(N/10)) лагов. Если положительная последовательность не оборвалась до границы окна, показываем предупреждение: ESS может быть завышена. Это короткая диагностика углов, не доказательство независимости или сходимости. Постоянные координаты отмечаются отдельно; их ESS неинформативна. Сумма ESS нескольких серий также является лишь ориентиром. 3D Сохранённый реальный кадр в выбранной ячейке, ближайший к её центру среди приложенных представителей, с учётом фильтра времени/серии. Усреднения атомных координат, морфинга и генерирования структуры нет. При отсутствии подходящего кадра 3D очищается. В демонстрации банк охватывает все посещённые ячейки сетки 72x72 до фильтрации по времени; после отбрасывания начала некоторые ячейки могут лишиться 3D-кадра. Это не отсутствие данных для самой карты. Пример и реальная проверка Источник: https://markovmodel.github.io/mdshare/ALA2/ MDShare, Freie Universität Berlin; данные CC BY 4.0, атрибуция сохранена. ACEMD; AMBER ff-99SB-ILDN; Langevin; 300 K; исходный шаг интеграции 2 fs; TIP3P вода; опубликованы три независимые траектории по 250 ns, 1 ps/кадр. В координатах вода удалена, выполнено наложение. Не запускаем новую MD. Сохраняем оригиналы XTC/PDB/NPZ и SHA-256 в research/raw/download.json. Файлы XTC содержат 249 сбросов времени на каждую серию. Проверяется точный шаблон frame_index % 1000; время восстановления = frame_index × опубликованный 1 ps. Если шаблон изменится, подготовка останавливается. В интерфейсе каждый 10-й кадр: 75000 из 750000, шаг 10 ps, 0..249990 ps в каждой серии. Сокращение объёма не делает кадры независимыми. Углы считаются заново из XTC, а не копируются из отдельно выложенного NPZ. Номера атомов (0-based в XTC): phi=[4,6,8,14], psi=[6,8,14,16]. В опубликованном NPZ и XTC есть расхождения: медиана около 0.21–0.24°, максимум до 1.63°. Они не скрыты и не объявлены нулевой ошибкой. Сжатие координат может влиять на углы; происхождение всех расхождений не установлено. Для связки карта/3D используется только одна версия XTC. Независимая векторная формула угла даёт отличие от MDTraj <0.00003°. PDB-экспорт представителей: отличие углов от таблицы <0.00018°. 4380 представителей, с исходным номером кадра. Численные результаты: samples/validation-summary.json, samples/numerical-validation.json. Независимая NumPy histogram2d, логарифм и SD сверены с JavaScript: 12 комбинаций сетки, серии и удаления начала; числа кадров совпадают точно; энергии и SD с ошибкой <1e-10 kJ/mol (фактически <2e-15). Это проверка реализации, не точность физики. Автоматические тесты дополнительно проверяют периодичность, масштаб температуры, неполные данные, запрет biased sampling и связь кадра/углов. Права и ссылки Данные: MDShare / markovmodel, CC BY 4.0: https://markovmodel.github.io/mdshare/ https://creativecommons.org/licenses/by/4.0/ Авторы источника просят ссылаться также на: F. Nüske et al., J. Chem. Phys. 146 (2017), 094104. C. Wehmeyer, F. Noé, J. Chem. Phys. 148 (2018), 241703. MDTraj (инструмент подготовки): https://www.mdtraj.org/ 3Dmol.js (существующий в Foldiff просмотрщик, BSD-3-Clause): https://3dmol.org/ и https://github.com/3dmol/3Dmol.js Лицензии библиотек подготовки остаются в их установках; их код не копируется в проект. Код mdshare-downloader не используется. Статистика коррелированных выборок / block averaging: https://www.plumed.org/doc-v2.9/user-doc/html/masterclass-21-2.html Что пока нельзя заключать Нет абсолютного сравнения свободных энергий двух отдельно обнулённых мутантных карт. Нет скоростей переходов, высот кинетических барьеров, прогноза сворачивания из последовательности, рекомендованного лечения или автоматической постановки MD. Не оцениваем силовое поле, условия тропонинового комплекса, Ca2+ и фосфорилирование этим маленьким примером. Расширение до тропонина/домена требует отдельной постановки и проверки.