FAQ_RU.md

# Easy G-Code Plot: часто задаваемые вопросы

Обновлено для **2.9.0**: запуск внешнего CLI из GUI, а также образцы расположения, карманы и резьбофрезерование iTNC, классические фрезерные циклы SINUMERIK, native-ввод поворотных осей/TCP и ограниченная токарка XZ.

Этот документ представляет собой подробное справочное руководство для пользователей и разработчиков Easy G-Code Plot. Он отражает текущую рабочую кодовую базу и описывает графический интерфейс, общее детерминированное ядро ЧПУ, поддерживаемую семантику FANUC, SINUMERIK native/ISO-M для фрезерования, native/ISO-T для токарки и HEIDENHAIN iTNC 530 Klartext, среду Macro B, циклы точения и фрезерования, поворотные оси и TCP, диагностику, CLI, пакетный анализ и экспорт.

Тот же FAQ может быть упакован для автономного использования в **Справка → FAQ**.

<details>
  <summary><h2>Содержание</h2></summary>

- [Easy G-Code Plot: часто задаваемые вопросы](#easy-g-code-plot-часто-задаваемые-вопросы)
  - [Область применения проекта и модель выполнения](#область-применения-проекта-и-модель-выполнения)
    - [Что такое Easy G-Code Plot?](#что-такое-easy-g-code-plot)
    - [Как устроен основной поток обработки данных?](#как-устроен-основной-поток-обработки-данных)
    - [Является ли график OpenGL моделью ЧПУ?](#является-ли-график-opengl-моделью-чпу)
    - [Является ли программа симулятором станка?](#является-ли-программа-симулятором-станка)
    - [Можно ли визуализировать пятиосевые CAM-программы SINUMERIK?](#можно-ли-визуализировать-пятиосевые-cam-программы-sinumerik)
    - [Что означает детерминированность в этом проекте?](#что-означает-детерминированность-в-этом-проекте)
  - [Начало работы](#начало-работы)
    - [Как установить?](#как-установить)
    - [Каков обычный рабочий процесс в GUI?](#каков-обычный-рабочий-процесс-в-gui)
    - [Как работать с несколькими документами?](#как-работать-с-несколькими-документами)
    - [Какие настройки принадлежат документу, а какие общие?](#какие-настройки-принадлежат-документу-а-какие-общие)
    - [Что происходит с диалогами и воспроизведением при переключении?](#что-происходит-с-диалогами-и-воспроизведением-при-переключении)
    - [Как закрывать документы с несохранёнными изменениями?](#как-закрывать-документы-с-несохранёнными-изменениями)
    - [Как сравнить программы?](#как-сравнить-программы)
    - [Что делает тип исходника iTNC-code?](#что-делает-тип-исходника-itnc-code)
    - [Какие кодировки ввода поддерживаются?](#какие-кодировки-ввода-поддерживаются)
    - [Принимаются ли компактные блоки FANUC?](#принимаются-ли-компактные-блоки-fanuc)
    - [Какие формы комментариев понимаются?](#какие-формы-комментариев-понимаются)
    - [Как работают необязательные строки с пропуском блока `/`?](#как-работают-необязательные-строки-с-пропуском-блока-)
  - [Диагностика и поведение при отказе](#диагностика-и-поведение-при-отказе)
    - [Что такое `ok` и `complete`?](#что-такое-ok-и-complete)
    - [Какая диагностическая информация хранится?](#какая-диагностическая-информация-хранится)
    - [Что происходит после неподдерживаемой семантики, изменяющей позицию?](#что-происходит-после-неподдерживаемой-семантики-изменяющей-позицию)
    - [Как классифицируются неподдерживаемые G-коды точения?](#как-классифицируются-неподдерживаемые-g-коды-точения)
    - [А что насчёт неподдерживаемых M-кодов?](#а-что-насчёт-неподдерживаемых-m-кодов)
    - [Обнаруживаются ли конфликтующие модальные коды?](#обнаруживаются-ли-конфликтующие-модальные-коды)
    - [Существуют ли ограничения ресурсов выполнения?](#существуют-ли-ограничения-ресурсов-выполнения)
  - [FANUC Macro B и поток программы](#fanuc-macro-b-и-поток-программы)
    - [Насколько полна поддержка Macro B?](#насколько-полна-поддержка-macro-b)
    - [Какие формы переменных поддерживаются?](#какие-формы-переменных-поддерживаются)
    - [Что особенного в `#0`?](#что-особенного-в-0)
    - [Что происходит, когда неопределённая переменная используется численно?](#что-происходит-когда-неопределённая-переменная-используется-численно)
    - [Какие арифметические и реляционные операторы поддерживаются?](#какие-арифметические-и-реляционные-операторы-поддерживаются)
    - [Какие функции Macro B реализованы?](#какие-функции-macro-b-реализованы)
    - [Поддерживаются ли присваивания в блоках с метками?](#поддерживаются-ли-присваивания-в-блоках-с-метками)
    - [Поддерживается ли безусловный `GOTO`?](#поддерживается-ли-безусловный-goto)
    - [Поддерживается ли `IF [...] GOTO`?](#поддерживается-ли-if--goto)
    - [Поддерживаются ли циклы `WHILE / DO / END`?](#поддерживаются-ли-циклы-while--do--end)
    - [Тестируются ли реальные фрезерные программы Macro B?](#тестируются-ли-реальные-фрезерные-программы-macro-b)
    - [Поддерживается ли `G65`?](#поддерживается-ли-g65)
    - [Как отображаются аргументы G65 Type I?](#как-отображаются-аргументы-g65-type-i)
    - [Как обрабатываются повторяющиеся аргументы I/J/K G65?](#как-обрабатываются-повторяющиеся-аргументы-ijk-g65)
    - [Выполняют ли слова-аргументы G65 также машинные действия?](#выполняют-ли-слова-аргументы-g65-также-машинные-действия)
    - [Что происходит с `#1..#33` при возврате из макроса G65?](#что-происходит-с-133-при-возврате-из-макроса-g65)
    - [Что делает `G65 ... L...`?](#что-делает-g65--l)
    - [Насколько глубоко могут вкладываться макросы G65?](#насколько-глубоко-могут-вкладываться-макросы-g65)
    - [Как ведёт себя M98 внутри макроса G65?](#как-ведёт-себя-m98-внутри-макроса-g65)
    - [Поддерживаются ли подпрограммы M98/M99 вне Macro B?](#поддерживаются-ли-подпрограммы-m98m99-вне-macro-b)
    - [Поддерживается ли `M99 P...`?](#поддерживается-ли-m99-p)
    - [Хранятся ли значения переменных Macro B для каждого шага выполнения?](#хранятся-ли-значения-переменных-macro-b-для-каждого-шага-выполнения)
    - [Сохраняет ли экспорт Expanded Execution операторы Macro B?](#сохраняет-ли-экспорт-expanded-execution-операторы-macro-b)
  - [FANUC точение](#fanuc-точение)
    - [Основные отличия Type A и Type B](#основные-отличия-type-a-и-type-b)
    - [Что представляет собой модель координат точения?](#что-представляет-собой-модель-координат-точения)
    - [Как ведут себя X/U и Z/W?](#как-ведут-себя-xu-и-zw)
    - [Как обрабатываются G20 и G21?](#как-обрабатываются-g20-и-g21)
    - [Какие форматы дуг точения поддерживаются?](#какие-форматы-дуг-точения-поддерживаются)
    - [Почему направление G2/G3 может выглядеть инвертированным на графике XZ?](#почему-направление-g2g3-может-выглядеть-инвертированным-на-графике-xz)
    - [Поддерживается ли прямое программирование угла A при точении?](#поддерживается-ли-прямое-программирование-угла-a-при-точении)
    - [Поддерживаются ли фаски C и скругления углов R?](#поддерживаются-ли-фаски-c-и-скругления-углов-r)
    - [Поддерживаются ли движения резьбы G32 и G33?](#поддерживаются-ли-движения-резьбы-g32-и-g33)
    - [Какие режимы подачи при точении?](#какие-режимы-подачи-при-точении)
    - [Моделируются ли G96 и G97?](#моделируются-ли-g96-и-g97)
    - [Что делает G50 S при точении?](#что-делает-g50-s-при-точении)
    - [Отслеживаются ли сигналы пуска/останова шпинделя?](#отслеживаются-ли-сигналы-пускаостанова-шпинделя)
    - [Какие функции WCS работают при точении?](#какие-функции-wcs-работают-при-точении)
    - [Поддерживается ли G53 при точении?](#поддерживается-ли-g53-при-точении)
    - [Как работает G28?](#как-работает-g28)
    - [G30 — то же самое, что G28?](#g30--то-же-самое-что-g28)
    - [Как работает компенсация радиуса при вершине резца?](#как-работает-компенсация-радиуса-при-вершине-резца)
  - [Циклы точения](#циклы-точения)
    - [Какие циклы точения моделируются?](#какие-циклы-точения-моделируются)
    - [Помнят ли движения цикла, откуда они пришли?](#помнят-ли-движения-цикла-откуда-они-пришли)
    - [Как выбираются профили циклов по P и Q?](#как-выбираются-профили-циклов-по-p-и-q)
    - [Поддерживают ли блоки профиля G71/G72/G73 линии и дуги?](#поддерживают-ли-блоки-профиля-g71g72g73-линии-и-дуги)
    - [Как работает G70?](#как-работает-g70)
    - [Какая форма G71 поддерживается?](#какая-форма-g71-поддерживается)
    - [Как интерпретируется глубина G71?](#как-интерпретируется-глубина-g71)
    - [Как обрабатываются припуски на чистовую обработку G71 U/W?](#как-обрабатываются-припуски-на-чистовую-обработку-g71-uw)
    - [Как G71 различает обдирку по наружному и внутреннему диаметру?](#как-g71-различает-обдирку-по-наружному-и-внутреннему-диаметру)
    - [Что такое поведение G71 Type I?](#что-такое-поведение-g71-type-i)
    - [Поддерживается ли G71 Type II?](#поддерживается-ли-g71-type-ii)
    - [Как работает G72?](#как-работает-g72)
    - [Является ли G72 Type II полностью универсальным?](#является-ли-g72-type-ii-полностью-универсальным)
    - [Как работает G73?](#как-работает-g73)
    - [Как работает G74?](#как-работает-g74)
    - [Как работает G75?](#как-работает-g75)
    - [Как представлено движение сверления с периодическим выводом при точении?](#как-представлено-движение-сверления-с-периодическим-выводом-при-точении)
    - [Как работает двухстрочный G76?](#как-работает-двухстрочный-g76)
    - [Как интерпретируются целочисленные приращения P/Q в G76?](#как-интерпретируются-целочисленные-приращения-pq-в-g76)
    - [Как генерируется глубина проходов G76?](#как-генерируется-глубина-проходов-g76)
    - [Что означают упакованные цифры P в G76?](#что-означают-упакованные-цифры-p-в-g76)
    - [Какие углы инструмента G76 моделируются?](#какие-углы-инструмента-g76-моделируются)
    - [Как моделируется фаска G76?](#как-моделируется-фаска-g76)
    - [Является ли G92 модальным циклом резьбы?](#является-ли-g92-модальным-циклом-резьбы)
    - [Является ли G90 модальным циклом точения?](#является-ли-g90-модальным-циклом-точения)
    - [Является ли G94 модальным циклом торцевой обработки?](#является-ли-g94-модальным-циклом-торцевой-обработки)
    - [Что отменяет G90/G92/G94?](#что-отменяет-g90g92g94)
    - [Являются ли G83 и G84 при точении модальными?](#являются-ли-g83-и-g84-при-точении-модальными)
    - [Как ведёт себя G83 при точении?](#как-ведёт-себя-g83-при-точении)
    - [Как ведёт себя G84 при точении?](#как-ведёт-себя-g84-при-точении)
    - [Создаёт ли выдержка P в G83/G84 при точении геометрию?](#создаёт-ли-выдержка-p-в-g83g84-при-точении-геометрию)
    - [Что произойдёт, если модальный цикл сверления/нарезания резьбы останется в недопустимом состоянии?](#что-произойдёт-если-модальный-цикл-сверлениянарезания-резьбы-останется-в-недопустимом-состоянии)
  - [FANUC фрезерование](#fanuc-фрезерование)
    - [Какие G-функции фрезерования распознаются?](#какие-g-функции-фрезерования-распознаются)
    - [Какие M-функции фрезерования распознаются?](#какие-m-функции-фрезерования-распознаются)
    - [Какое базовое движение фрезерования моделируется?](#какое-базовое-движение-фрезерования-моделируется)
    - [Как обрабатывается индексированное поворотное фрезерование?](#как-обрабатывается-индексированное-поворотное-фрезерование)
    - [Какие поворотные профили были проверены?](#какие-поворотные-профили-были-проверены)
    - [Что происходит, когда индексированная геометрия не может быть разрешена?](#что-происходит-когда-индексированная-геометрия-не-может-быть-разрешена)
    - [Какие циклы фрезерования моделируются?](#какие-циклы-фрезерования-моделируются)
    - [В чём разница между циклами сверления с периодическим выводом G73 и G83 при фрезеровании?](#в-чём-разница-между-циклами-сверления-с-периодическим-выводом-g73-и-g83-при-фрезеровании)
    - [Как представлена выдержка G82?](#как-представлена-выдержка-g82)
    - [Как представлен G84 при фрезеровании?](#как-представлен-g84-при-фрезеровании)
    - [Как представлен G86 при фрезеровании?](#как-представлен-g86-при-фрезеровании)
    - [Что означают G98/G99 при фрезеровании?](#что-означают-g98g99-при-фрезеровании)
    - [Какие режимы подачи при фрезеровании?](#какие-режимы-подачи-при-фрезеровании)
    - [Какие системы рабочих координат поддерживаются?](#какие-системы-рабочих-координат-поддерживаются)
    - [Как ведёт себя G10 при G91 во фрезеровании?](#как-ведёт-себя-g10-при-g91-во-фрезеровании)
    - [Как работает G52?](#как-работает-g52)
    - [Как работают G68 и G69?](#как-работают-g68-и-g69)
    - [Как работает масштабирование G51/G50?](#как-работает-масштабирование-g51g50)
    - [Поддерживается ли G53 во фрезеровании?](#поддерживается-ли-g53-во-фрезеровании)
    - [Поддерживается ли G28 во фрезеровании?](#поддерживается-ли-g28-во-фрезеровании)
    - [Как программируются дуги фрезерования?](#как-программируются-дуги-фрезерования)
    - [Что делает автоопределение типа дуги?](#что-делает-автоопределение-типа-дуги)
    - [Может ли одна программа смешивать дуги R с дугами IJK?](#может-ли-одна-программа-смешивать-дуги-r-с-дугами-ijk)
    - [Поддерживаются ли полные окружности?](#поддерживаются-ли-полные-окружности)
    - [Поддерживается ли винтовая интерполяция?](#поддерживается-ли-винтовая-интерполяция)
    - [Что делает полярное программирование G16/G15?](#что-делает-полярное-программирование-g16g15)
    - [Как работает полярный G90?](#как-работает-полярный-g90)
    - [Как работает полярный G91?](#как-работает-полярный-g91)
    - [Масштабируют ли G20/G21 полярный угол?](#масштабируют-ли-g20g21-полярный-угол)
    - [Поддерживаются ли полярные дуги G2/G3?](#поддерживаются-ли-полярные-дуги-g2g3)
    - [Поддерживается ли полярная интерполяция G12.1/G13.1?](#поддерживается-ли-полярная-интерполяция-g121g131)
    - [Как работает компенсация радиуса фрезы?](#как-работает-компенсация-радиуса-фрезы)
    - [Что означает `UNVERIFIED_CUTTER_COMPENSATION`?](#что-означает-unverified_cutter_compensation)
    - [Применяется ли геометрия длины инструмента G43?](#применяется-ли-геометрия-длины-инструмента-g43)
    - [Поддерживается ли непрерывная пятиосевая TCP-обработка G43.4?](#поддерживается-ли-непрерывная-пятиосевая-tcp-обработка-g434)
  - [Библиотеки инструментов и обнаружение инструментов](#библиотеки-инструментов-и-обнаружение-инструментов)
    - [Где хранятся постоянные инструменты?](#где-хранятся-постоянные-инструменты)
    - [В чём разница между Current Program и Saved Library?](#в-чём-разница-между-current-program-и-saved-library)
    - [Записывает ли открытие программы обнаруженные инструменты в базу данных?](#записывает-ли-открытие-программы-обнаруженные-инструменты-в-базу-данных)
    - [Как представлены номера токарных инструментов?](#как-представлены-номера-токарных-инструментов)
    - [Могут ли комментарии описывать геометрию инструмента?](#могут-ли-комментарии-описывать-геометрию-инструмента)
    - [Что происходит, когда нет явного указания типа?](#что-происходит-когда-нет-явного-указания-типа)
    - [Распознаются ли выражения T с Macro B как явно заданные инструменты?](#распознаются-ли-выражения-t-с-macro-b-как-явно-заданные-инструменты)
    - [Какие геометрии токарных инструментов хранятся?](#какие-геометрии-токарных-инструментов-хранятся)
    - [Какие фрезерные инструменты можно предварительно просмотреть?](#какие-фрезерные-инструменты-можно-предварительно-просмотреть)
    - [Как задаются длины фрезерного инструмента?](#как-задаются-длины-фрезерного-инструмента)
    - [Загружает ли выполнение CLI сохранённую библиотеку GUI?](#загружает-ли-выполнение-cli-сохранённую-библиотеку-gui)
  - [Интерфейс, редактор и воспроизведение](#интерфейс-редактор-и-воспроизведение)
    - [Какие две основные панели GUI?](#какие-две-основные-панели-gui)
    - [Как измерить геометрию в графическом окне?](#как-измерить-геометрию-в-графическом-окне)
    - [Как вставить рассчитанную заготовку в «Объекты STL»?](#как-вставить-рассчитанную-заготовку-в-объекты-stl)
    - [Как импортированный STL влияет на видимость траектории?](#как-импортированный-stl-влияет-на-видимость-траектории)
    - [Как работать с панелью «Объекты STL»?](#как-работать-с-панелью-объекты-stl)
      - [Как импортировать и выбирать модели STL?](#как-импортировать-и-выбирать-модели-stl)
      - [Что делают «Отменить», «Повторить», «Статистика» и «Удалить»?](#что-делают-отменить-повторить-статистика-и-удалить)
      - [Как работают базовая точка STL и выбор углов параллелепипеда?](#как-работают-базовая-точка-stl-и-выбор-углов-параллелепипеда)
      - [Как задавать положение и преобразовывать модель STL?](#как-задавать-положение-и-преобразовывать-модель-stl)
      - [Как работают массивы STL?](#как-работают-массивы-stl)
      - [Как выполнить 3D-сечение модели STL?](#как-выполнить-3d-сечение-модели-stl)
      - [Что показывает статистика STL и как включить дюймы?](#что-показывает-статистика-stl-и-как-включить-дюймы)
    - [Как изменить регистр букв или пометить необязательные блоки?](#как-изменить-регистр-букв-или-пометить-необязательные-блоки)
    - [Как распечатать график?](#как-распечатать-график)
    - [Какие фиксированные виды доступны?](#какие-фиксированные-виды-доступны)
    - [Как воспроизведение связано с ядром?](#как-воспроизведение-связано-с-ядром)
    - [Что делают Step Backward и Step Forward?](#что-делают-step-backward-и-step-forward)
    - [Почему многие движения воспроизведения могут соответствовать одной строке исходного кода?](#почему-многие-движения-воспроизведения-могут-соответствовать-одной-строке-исходного-кода)
    - [Как настроить кнопки панелей инструментов?](#как-настроить-кнопки-панелей-инструментов)
    - [Как найти отображённое движение в редакторе?](#как-найти-отображённое-движение-в-редакторе)
    - [Перемещает ли автоматическое обновление курсор редактора?](#перемещает-ли-автоматическое-обновление-курсор-редактора)
    - [Что происходит, когда Auto Update слишком дорого?](#что-происходит-когда-auto-update-слишком-дорого)
    - [Что останавливает Cancel?](#что-останавливает-cancel)
    - [Какие помощники редактирования ЧПУ включены?](#какие-помощники-редактирования-чпу-включены)
    - [Что генерирует Hole Calculator?](#что-генерирует-hole-calculator)
    - [Что генерирует Pocket Calculator?](#что-генерирует-pocket-calculator)
    - [Где хранятся сниппеты?](#где-хранятся-сниппеты)
  - [Параметры и настройка сцены](#параметры-и-настройка-сцены)
    - [Где прочитать ошибки и предупреждения выполнения?](#где-прочитать-ошибки-и-предупреждения-выполнения)
    - [Как изменить цвет подсветки текущей строки?](#как-изменить-цвет-подсветки-текущей-строки)
    - [Как изменить язык интерфейса?](#как-изменить-язык-интерфейса)
    - [Как изменить тему?](#как-изменить-тему)
    - [Где задать рабочие системы координат и значения возврата домой?](#где-задать-рабочие-системы-координат-и-значения-возврата-домой)
    - [Как задать размеры токарной заготовки?](#как-задать-размеры-токарной-заготовки)
    - [Есть ли снятие материала при фрезеровании?](#есть-ли-снятие-материала-при-фрезеровании)
  - [Снятие материала при фрезеровании](#снятие-материала-при-фрезеровании)
    - [Как запустить фрезерную симуляцию?](#как-запустить-фрезерную-симуляцию)
    - [Как задаются границы и припуск заготовки?](#как-задаются-границы-и-припуск-заготовки)
    - [Какие фрезы и движения поддерживаются?](#какие-фрезы-и-движения-поддерживаются)
    - [Что задаёт Accuracy при фрезеровании?](#что-задаёт-accuracy-при-фрезеровании)
    - [Как воспроизведение и правка инструмента меняют заготовку?](#как-воспроизведение-и-правка-инструмента-меняют-заготовку)
    - [Что показывают цвета и грани заготовки?](#что-показывают-цвета-и-грани-заготовки)
    - [Как сохранить результат фрезерного съёма в STL?](#как-сохранить-результат-фрезерного-съёма-в-stl)
    - [Как устроено GPU-ядро съёма?](#как-устроено-gpu-ядро-съёма)
    - [Каковы требования и ограничения фрезерного съёма?](#каковы-требования-и-ограничения-фрезерного-съёма)
  - [Удаление материала при точении](#удаление-материала-при-точении)
    - [Что такое Turning Stock Removal?](#что-такое-turning-stock-removal)
    - [Как оценивается автоматический припуск?](#как-оценивается-автоматический-припуск)
    - [Можно ли переопределить размеры заготовки вручную?](#можно-ли-переопределить-размеры-заготовки-вручную)
    - [Какие инструменты удаляют материал?](#какие-инструменты-удаляют-материал)
    - [Как резьбы представлены в Stock Removal?](#как-резьбы-представлены-в-stock-removal)
    - [Обнаруживает ли Stock Removal столкновения станка?](#обнаруживает-ли-stock-removal-столкновения-станка)
  - [Статистика и Tokens/Variables](#статистика-и-tokensvariables)
    - [Что содержит Toolpath Statistics?](#что-содержит-toolpath-statistics)
    - [Почему время обработки может быть UNKNOWN?](#почему-время-обработки-может-быть-unknown)
    - [Что такое вкладка Tokens?](#что-такое-вкладка-tokens)
    - [Что такое вкладка Variables?](#что-такое-вкладка-variables)
    - [Почему Variables могут быть недоступны?](#почему-variables-могут-быть-недоступны)
  - [Экспорт](#экспорт)
    - [Какие семейства экспорта GUI существуют?](#какие-семейства-экспорта-gui-существуют)
    - [Повторно ли интерпретируется G-код при экспорте?](#повторно-ли-интерпретируется-g-код-при-экспорте)
    - [Что означает Full Program?](#что-означает-full-program)
    - [Что означает Expanded Execution?](#что-означает-expanded-execution)
    - [Что означает Auto (source controller)?](#что-означает-auto-source-controller)
    - [Как управлять пользовательскими постпроцессорами в GUI?](#как-управлять-пользовательскими-постпроцессорами-в-gui)
    - [Как работает Modal Feed?](#как-работает-modal-feed)
    - [Можно ли выбирать параметры форматирования при конвертации на конкретную стойку?](#можно-ли-выбирать-параметры-форматирования-при-конвертации-на-конкретную-стойку)
    - [Что содержит DXF?](#что-содержит-dxf)
    - [Разбирает ли DXF G-код заново?](#разбирает-ли-dxf-g-код-заново)
    - [Какие параметры форматирования NC существуют?](#какие-параметры-форматирования-nc-существуют)
    - [Как пост-профиль управляет порядком и обязательностью вывода слов?](#как-пост-профиль-управляет-порядком-и-обязательностью-вывода-слов)
    - [Какие режимы вывода дуг Expanded для фрезерования существуют?](#какие-режимы-вывода-дуг-expanded-для-фрезерования-существуют)
    - [Что происходит, когда полная окружность экспортируется в режиме R?](#что-происходит-когда-полная-окружность-экспортируется-в-режиме-r)
    - [Можно ли преобразовать Expanded NC между миллиметрами и дюймами?](#можно-ли-преобразовать-expanded-nc-между-миллиметрами-и-дюймами)
    - [Можно ли принудительно задать Full Program в мм или дюймах?](#можно-ли-принудительно-задать-full-program-в-мм-или-дюймах)
    - [Какие единицы использует DXF?](#какие-единицы-использует-dxf)
    - [Можно ли удалить комментарии из экспорта?](#можно-ли-удалить-комментарии-из-экспорта)
    - [Записываются ли экспорты атомарно службой CLI?](#записываются-ли-экспорты-атомарно-службой-cli)
    - [Может ли экспорт CLI перезаписать исходный файл?](#может-ли-экспорт-cli-перезаписать-исходный-файл)
    - [Можно ли напрямую сравнить экспорт CLI с эталонным NC-файлом?](#можно-ли-напрямую-сравнить-экспорт-cli-с-эталонным-nc-файлом)
  - [SINUMERIK 840D](#sinumerik-840d)
    - [Какая поддержка SINUMERIK включена?](#какая-поддержка-sinumerik-включена)
    - [Как определяется формат MPF и SPF?](#как-определяется-формат-mpf-и-spf)
    - [Можно ли конвертировать фрезерную программу FANUC в SINUMERIK?](#можно-ли-конвертировать-фрезерную-программу-fanuc-в-sinumerik)
    - [Можно ли конвертировать SINUMERIK native в FANUC milling?](#можно-ли-конвертировать-sinumerik-native-в-fanuc-milling)
    - [Чем отличаются Full Program и Expanded Execution?](#чем-отличаются-full-program-и-expanded-execution)
    - [Поддерживается ли токарный SINUMERIK?](#поддерживается-ли-токарный-sinumerik)
  - [Ввод HEIDENHAIN iTNC 530](#ввод-heidenhain-itnc-530)
    - [Что входит в поддержку HEIDENHAIN?](#что-входит-в-поддержку-heidenhain)
    - [Какие циклы карманов и резьбофрезерования поддерживаются?](#какие-циклы-карманов-и-резьбофрезерования-поддерживаются)
    - [Как исполняются циклы расположения 220 и 221?](#как-исполняются-циклы-расположения-220-и-221)
    - [Как сохраняются исходник Klartext, параметры и диагностика?](#как-сохраняются-исходник-klartext-параметры-и-диагностика)
    - [Какие инструменты редактора и варианты экспорта доступны для iTNC?](#какие-инструменты-редактора-и-варианты-экспорта-доступны-для-itnc)
    - [Чем проверена реализация iTNC?](#чем-проверена-реализация-itnc)
  - [CLI](#cli)
    - [Использует ли CLI то же ядро, что и GUI?](#использует-ли-cli-то-же-ядро-что-и-gui)
    - [Какие команды существуют?](#какие-команды-существуют)
    - [Что делает `parse`?](#что-делает-parse)
    - [Что делает `trace`?](#что-делает-trace)
    - [Что делает `analyze`?](#что-делает-analyze)
    - [Что делает `batch`?](#что-делает-batch)
    - [Что делает `export`?](#что-делает-export)
    - [Что делает `batch-export`?](#что-делает-batch-export)
    - [Являются ли одиночный экспорт и пакетный экспорт разными экспортёрами?](#являются-ли-одиночный-экспорт-и-пакетный-экспорт-разными-экспортёрами)
    - [Какие имена диалектов используются?](#какие-имена-диалектов-используются)
    - [Какие коды выхода?](#какие-коды-выхода)
    - [Как увидеть все параметры и значения по умолчанию?](#как-увидеть-все-параметры-и-значения-по-умолчанию)
  - [Пакетный анализ](#пакетный-анализ)
    - [Что проверяет пакетный анализ?](#что-проверяет-пакетный-анализ)
    - [Какие статусы пакета существуют?](#какие-статусы-пакета-существуют)
    - [Какие расширения сканируются по умолчанию?](#какие-расширения-сканируются-по-умолчанию)
    - [Могут ли быть обнаружены файлы без обычного расширения NC?](#могут-ли-быть-обнаружены-файлы-без-обычного-расширения-nc)
    - [Детерминировано ли обнаружение?](#детерминировано-ли-обнаружение)
    - [Можно ли ограничить расширения?](#можно-ли-ограничить-расширения)
    - [Какие данные сводятся в итоговый отчёт?](#какие-данные-сводятся-в-итоговый-отчёт)
    - [Какие файлы записываются?](#какие-файлы-записываются)
    - [Останавливает ли плохой входной файл весь пакет?](#останавливает-ли-плохой-входной-файл-весь-пакет)
    - [Существуют ли предустановленные пакетные скрипты?](#существуют-ли-предустановленные-пакетные-скрипты)
  - [Пакетный экспорт](#пакетный-экспорт)
    - [Какую проблему решает пакетный экспорт?](#какую-проблему-решает-пакетный-экспорт)
    - [Изменяет ли пакетный экспорт входные файлы?](#изменяет-ли-пакетный-экспорт-входные-файлы)
    - [Сохраняется ли иерархия исходных каталогов?](#сохраняется-ли-иерархия-исходных-каталогов)
    - [Что происходит, если два исходных имени отображаются в одно выходное имя?](#что-происходит-если-два-исходных-имени-отображаются-в-одно-выходное-имя)
    - [Останавливает ли одна ошибка экспорта все файлы?](#останавливает-ли-одна-ошибка-экспорта-все-файлы)
    - [Какие файлы описывают пакетный экспорт?](#какие-файлы-описывают-пакетный-экспорт)
    - [Какие статусы batch-export?](#какие-статусы-batch-export)
    - [Какие режимы экспорта доступны из CLI?](#какие-режимы-экспорта-доступны-из-cli)
    - [Какие параметры намеренно отклоняются в режиме Full Program?](#какие-параметры-намеренно-отклоняются-в-режиме-full-program)
    - [Можно ли задать начальный номер последовательности/приращение без номеров последовательности?](#можно-ли-задать-начальный-номер-последовательностиприращение-без-номеров-последовательности)
    - [Существуют ли предустановленные скрипты batch-export?](#существуют-ли-предустановленные-скрипты-batch-export)
  - [Конфигурация](#конфигурация)
    - [Где хранится конфигурация приложения в Windows?](#где-хранится-конфигурация-приложения-в-windows)
    - [Что хранится в `config.ini`?](#что-хранится-в-configini)
    - [Можно ли заменить `tools.db` старыми значениями JSON в config.ini?](#можно-ли-заменить-toolsdb-старыми-значениями-json-в-configini)
    - [Где находится файл журнала?](#где-находится-файл-журнала)
    - [Что добавляет логирование DEBUG?](#что-добавляет-логирование-debug)
  - [Устранение неполадок](#устранение-неполадок)
    - [График пуст](#график-пуст)
    - [Движение Macro B отсутствует](#движение-macro-b-отсутствует)
    - [Мои слова G65 M/S/T не запустили шпиндель/СОЖ/смену инструмента](#мои-слова-g65-mst-не-запустили-шпиндельсожсмену-инструмента)
    - [Компенсация фрезы не видна](#компенсация-фрезы-не-видна)
    - [G43 присутствует в исходном коде, но отображаемый Z не включает длину инструмента](#g43-присутствует-в-исходном-коде-но-отображаемый-z-не-включает-длину-инструмента)
    - [G71 оставляет материал не с той стороны](#g71-оставляет-материал-не-с-той-стороны)
    - [G72 Type II сообщает об ошибке](#g72-type-ii-сообщает-об-ошибке)
    - [G76 сообщает `UNSUPPORTED_G76_TOOL_ANGLE`](#g76-сообщает-unsupported_g76_tool_angle)
    - [Пакет показывает `UNSUPPORTED_M_CODE`, но геометрия выглядит правильно](#пакет-показывает-unsupported_m_code-но-геометрия-выглядит-правильно)
    - [Преобразование единиц экспорта отклонено](#преобразование-единиц-экспорта-отклонено)
    - [Batch-export сообщает, что выходной каталог недействителен](#batch-export-сообщает-что-выходной-каталог-недействителен)
    - [Большая программа не обновляется во время набора](#большая-программа-не-обновляется-во-время-набора)
    - [GUI сообщает, что текущее выполнение устарело](#gui-сообщает-что-текущее-выполнение-устарело)
  - [Разработка и архитектура](#разработка-и-архитектура)
    - [Как организовано ядро ЧПУ?](#как-организовано-ядро-чпу)
    - [Что относится к `frontend/`?](#что-относится-к-frontend)
    - [Что относится к `runtime/`?](#что-относится-к-runtime)
    - [Почему циклы точения — отдельные файлы?](#почему-циклы-точения--отдельные-файлы)
    - [Что относится к `milling/`?](#что-относится-к-milling)
    - [Что относится к `compensation/`?](#что-относится-к-compensation)
    - [Что относится к `app/gcode/export/`?](#что-относится-к-appgcodeexport)
    - [Что делает `execution/program.py`?](#что-делает-executionprogrampy)
    - [Что делает `batch/analysis.py`?](#что-делает-batchanalysispy)
    - [Что делает `batch/export.py`?](#что-делает-batchexportpy)
    - [Какие нативные компоненты существуют?](#какие-нативные-компоненты-существуют)
    - [Как публично представлены результаты выполнения?](#как-публично-представлены-результаты-выполнения)
    - [Что такое `ExecutionStep`?](#что-такое-executionstep)
    - [Что такое `ExecutionEvent`?](#что-такое-executionevent)
    - [Как организованы тесты?](#как-организованы-тесты)
    - [Как запустить основные проверки?](#как-запустить-основные-проверки)
    - [Как запустить ежедневный GUI smoke-тест с видимым окном?](#как-запустить-ежедневный-gui-smoke-тест-с-видимым-окном)
    - [Редактируются ли сгенерированные файлы Qt Python вручную?](#редактируются-ли-сгенерированные-файлы-qt-python-вручную)
  - [Сборка и выпуск](#сборка-и-выпуск)
    - [Как собрать в Windows?](#как-собрать-в-windows)
    - [Как собрать в Linux?](#как-собрать-в-linux)
    - [Использует ли проект отдельную среду сборки?](#использует-ли-проект-отдельную-среду-сборки)
    - [Как проверяются релизы в CI?](#как-проверяются-релизы-в-ci)
    - [Запускается ли исполняемый файл Linux как Windows `.exe`?](#запускается-ли-исполняемый-файл-linux-как-windows-exe)
  - [Лицензия](#лицензия)

</details>

---

## Область применения проекта и модель выполнения

### Что такое Easy G-Code Plot?

Easy G-Code Plot — это редактор ЧПУ, детерминированный исполнитель программ, анализатор, построитель траекторий и экспортёр для токарных и фрезерных программ FANUC, фрезерных и поддержанных токарных XZ-программ SINUMERIK 840D и фрезерных программ HEIDENHAIN iTNC 530 Klartext. Поддержка native SINUMERIK включает ограниченные R-выражения и поток WHILE/GOTO/IF, а также CAM-траектории с индексированием 3+2 и непрерывной пятиосевой обработкой на настроенных поворотных профилях; ISO Dialect M также поддерживается в описанном подмножестве.

Native-ввод HEIDENHAIN охватывает описанное подмножество контуров Klartext, Q-параметров, циклов сверления, образцов расположения 220/221, карманов 251/252 и резьбофрезерования 262; неподдерживаемые команды вызывают явную диагностику.

Проверялись CAM-программы из Autodesk Fusion 360 и Siemens NX 2312, сформированные постпроцессорами для SINUMERIK 840D и FANUC. Проверенное покрытие относится к описанным в FAQ командам и настроенным кинематикам.

Проект имеет две пользовательские точки входа:

- настольный GUI на PyQt6;
- автономный исполняемый файл CLI.

Оба используют одно и то же ядро ЧПУ и один и тот же рассчитанный результат `ExecutionResult`. GUI не является вторым интерпретатором, а CLI не содержит собственного упрощённого парсера.

### Как устроен основной поток обработки данных?

Основной поток данных:

```text
G-code source
    |
    `--> Parser / controller frontend
           |- native Cython parser
           `- per-block Python fallback where required
                |
                v
             Program / AST
                |
                v
          Program tool setup
          (AST operation hints, library lookup, manual overrides)
                |- source comments / dimensions: Cython scanner
                `- Python scanner fallback
                |
                v
          CNC execution kernel
          (flow, cycles, compensation, geometry)
                |
                v
           ExecutionResult
                |
                +--> GUI rendering / playback
                +--> statistics
                +--> batch / CLI trace
                `--> NC / DXF export
```

`ExecutionResult` содержит рассчитанную траекторию, диагностику, шаги выполнения, сигналы, структурные события, состояние WCS и признак полноты выполнения.

### Является ли график OpenGL моделью ЧПУ?

Нет. Отображение использует рассчитанную ядром траекторию. Модуль отображения не интерпретирует G-код самостоятельно.

Это разделение намеренно: одна и та же рассчитанная геометрия используется воспроизведением, статистикой, экспортом и анализом.

### Является ли программа симулятором станка?

Нет. Easy G-Code Plot моделирует поддерживаемую семантику программ FANUC, фрезерных/нативных токарных XZ-программ SINUMERIK 840D и фрезерных программ HEIDENHAIN iTNC 530 Klartext, включая поддерживаемое native-подмножество CAM 3+2/5ax, и геометрию траектории инструмента. Он не моделирует полный физический станок с ЧПУ, динамику сервоприводов, ускорение, инерцию шпинделя, приспособления, рабочие зоны станка или все параметры контроллера.

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

### Можно ли визуализировать пятиосевые CAM-программы SINUMERIK?

Да, в пределах поддерживаемого native-подмножества фрезерования. `CYCLE800` рассчитывает поддерживаемые статические рабочие плоскости и индексирование 3+2, а `TRAORI` / `TRAFOOF` — непрерывное TCP-движение на профилях **5Ax Table AC Angled** и **5Ax Table BC Angled**. Настроенные поворотные оси, XYZ-геометрия и рассчитанные ориентации инструмента поступают в общий результат для GUI, CLI и остальных потребителей траектории.

Выберите режим фрезерования, откройте native-программу как `.mpf` / `.spf` и укажите соответствующий поворотный профиль. Для включённых в репозиторий CAM-примеров `5ax_test.mpf` и `impeller.mpf` есть тесты выполнения до конца программы.

При проверке графика учитывайте диагностику: некоторые native-команды принимаются с предупреждением `UNMODELED_SINUMERIK_NATIVE`, но их эффекты не моделируются. Поэтому достижение `M30` само по себе не подтверждает проверенную геометрию. Точные ограничения циклов, плоскостей и TCP описаны в разделе [SINUMERIK 840D](#sinumerik-840d). У EXPANDED свои ограничения: Поддержанные индексированные фреймы G68.2/G53.1 и CYCLE800 для AC/BC экспериментально конвертируются через встроенные многоосевые посты; остальные сочетания фреймов отклоняются.

### Что означает детерминированность в этом проекте?

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

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

---

## Начало работы

### Как установить?

Релизные сборки предоставляют отдельные исполняемые файлы GUI и CLI для Windows и архив Linux x64, содержащий оба исполняемых файла. Для упакованных сборок установка Python не требуется.

Для исходного репозитория проект требует Python 3.13+, `uv` и компилятор для нативных расширений.

```bash
git clone https://github.com/MaestroFusion360/easy_gcode_plot.git
cd easy_gcode_plot
uv sync --no-dev
uv run --no-dev python main.py
```

### Каков обычный рабочий процесс в GUI?

1. Откройте или перетащите программу ЧПУ в приложение.
2. Выберите **Lathe Mode** для точения или оставьте отключённым для фрезерования.
3. Настройте WCS, домашнюю позицию и инструменты, когда это требуется программе.
4. Обновите результат выполнения.
5. Проверьте траекторию, воспроизведение, диагностику и статистику.
6. При необходимости экспортируйте FULL, EXPANDED или DXF.

Расположение команд в 2.7.0:

| Команда | Путь в меню |
| --- | --- |
| Параметры приложения | Настройки → Параметры |
| Заготовка, WCS и библиотека инструментов | Настройки → Заготовка / WCS / Библиотека инструментов |
| Панель STL-объектов | Вид → Объекты STL |
| Сравнение и отчёты выполнения | Функции ЧПУ → Сравнить / Статистика / Список инструментов / Токены/Макропеременные |
| Закрытие документов | Файл → Закрыть / Закрыть все |
| Выбор кнопок панелей | ПКМ на панели → Настроить панели |

### Как работать с несколькими документами?

При запуске всегда открыт **один пустой документ в режиме milling**, даже если предыдущая сессия была токарной. **+** или **Файл → Новый** создаёт дополнительный документ. Открытие файла, выбор из недавних и перетаскивание программы не заменяют непустой активный документ. Если активен пустой неизменённый документ без имени, обычный файл ЧПУ заполняет его с сохранением выбранного режима обработки. Исключение — файлы HEIDENHAIN `.h`/`.H`: они всегда выбирают native Klartext и фрезерный режим, даже если пустой документ был в Lathe Mode. SINUMERIK `.mpf/.spf` с однозначными нативными токарными командами также автоматически выбирает токарку. Повторное открытие уже открытого файла переключает на существующий документ.

**Стрелка списка документов** справа в строке меню позволяет выбрать документ. Галочка отмечает активный, `*` — несохранённый текст. Сохранение, «Сохранить как», команды редактора, расчёт и экспорт работают с активным документом. «Сохранить как» не позволяет перезаписать файл, открытый в другом документе. Список хранится в памяти текущей сессии; следующий запуск снова начинается с одного пустого документа.

Save As предлагает фильтры NC, SINUMERIK `.mpf/.spf` и HEIDENHAIN `.h/.H`. Для существующего нативного имени выбирается соответствующая маска; имя без расширения получает `.mpf` или `.h` по выбранной группе. Save/Save As записывает исходный текст без конвертации стойки.

### Какие настройки принадлежат документу, а какие общие?

Каждый документ сохраняет текст, undo/redo, курсор, выделение, прокрутку, путь и определённую кодировку. При выборе восстанавливаются его режим обработки, диалект, переопределения комментариев и дуг, инструменты текущей программы, результат расчёта, направление вида и позиция воспроизведения. Размеры и ручной/автоматический режим заготовки, STL-объекты, сечение и история изменений STL также принадлежат документу. Новый документ наследует режим обработки активного документа, с пустой сценой и новым набором инструментов программы. STL-сцена хранится в сессии; сохранение исходного G-кода не записывает её внутрь программы.

**Параметры**, язык и тема, оформление редактора, горячие клавиши, расположение панелей, скорость воспроизведения, параметры экспорта, сохранённые библиотеки инструментов, **смещения WCS/Home** и выбранная кинематика — общие настройки приложения. Если общие параметры расчёта или дискретизации дуг изменились, старый кэш неактивного документа при выборе помечается **STALE**. При включённом Auto Update он пересчитывается; иначе нажми **Обновить**, прежде чем использовать траекторию или экспортировать её. Переключение документов не отменяет изменения общих настроек.

### Что происходит с диалогами и воспроизведением при переключении?

Перед созданием, переключением или закрытием документа заверши или отмени открытый диалог **Экспорт**, **Перенумерация**, **WCS**, **Параметры**, **Заготовка**, **Библиотека инструментов**, **Калькулятор отверстий/карманов** или **Сниппеты**. Это защищает другую программу от применения незавершённых правок. Поиск и замена продолжают работать с активным редактором. Открытые Tokens/Variables обновляются для выбранного документа. Предыдущий отчёт статистики скрывается; статистику можно снова открыть для активной программы.

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

### Как закрывать документы с несохранёнными изменениями?

**×**, **Файл → Закрыть** или стандартное **Ctrl+W** закрывает активный документ. **Закрыть все** и выход из приложения проверяют каждый изменённый документ с выбором сохранения, отказа от сохранения или отмены. Отмена, ошибка или отменённое сохранение останавливают закрытие и оставляют несохранённый документ открытым. Уже закрытые командой «Закрыть все» документы остаются закрытыми. После закрытия последнего остаётся один пустой редактор milling. Создание и открытие другого документа не теряют несохранённый текст. Команды закрытия доступны в настройке горячих клавиш.

### Как сравнить программы?

Откройте **Функции ЧПУ → Сравнить** или нажмите кнопку Compare на панели. Для каждой стороны выберите открытый документ, включая несохранённый буфер, либо отдельный файл с диска. Панели только для чтения выравнивают строки: жёлтый отмечает изменения, зелёный — добавления, красный — удаления. Вертикальная и горизонтальная прокрутка синхронизированы. **Обновить** перечитывает выбранные файлы с диска и буферы MDI, не заменяя документы редактора; при ошибке чтения сохраняется прежнее сравнение. Копирование доступно, редактирование, слияние и сохранение/печать diff-отчётов — нет. Сравнивается текст, а не семантика ЧПУ или траектории.

### Что делает тип исходника iTNC-code?

Выбор типа на панели и **Настройки → Параметры → Общие → Тип файла по умолчанию** предлагают Text, ISO G-code и **iTNC-code**. Значение по умолчанию сохраняется между запусками. iTNC-code включает подсветку перемещений и комментариев Klartext. При открытии `.h`/`.H` автоматически выбираются язык HEIDENHAIN и фрезерный режим; вставленный текст без имени распознаётся по `BEGIN PGM ... MM/INCH`. Собственный AST и фрезерный исполнитель выполняют прямолинейные и круговые перемещения, полярные/винтовые `LP/CP`, `CC/C/CR/CT`, переходы `APPR/DEP`, `TOOL CALL`, подачи, шпиндель, `M91`, Q-параметры, переходы по меткам и циклы сверления/растачивания/резьбы 1/2 и 200–209/240/241, образцы расположения 220/221, карманы 251/252 и резьбофрезерование 262 в описанных ниже пределах. Цикл 32 сохраняется как метаданные без моделирования сглаживания стойки. `RND`/`CHF` строят плоские скругления/фаски до существующей коррекции RL/RR; подача перехода действует только на один кадр. Индексирование, PLANE и TCP столов AC/BC используют настроенную кинематику; корректировки DL/DR, вспомогательные оси и `M120` пока не исполняются. Неподдержанная команда останавливает расчёт с диагностикой исходного кадра. См. раздел [Ввод HEIDENHAIN iTNC 530 и таблицу покрытия](#ввод-heidenhain-itnc-530).

### Какие кодировки ввода поддерживаются?

Обычные кодировки документов — UTF-8 и Windows-1251. GUI показывает файлы `.ptp` в стандартном диалоге открытия и пробует Windows-1251, если чтение как UTF-8 не удалось; при сохранении сохраняется определённая кодировка. CLI предоставляет поддерживаемые кодировки через `--encoding`.

### Принимаются ли компактные блоки FANUC?

Да. Слова не нуждаются в пробелах. Блоки, такие как:

```text
G18G21G40G54G80G99
G0X100Z5
```

разбираются как адресные слова, а не полагаются на разделение по пробелам.

### Какие формы комментариев понимаются?

Распознаются обе распространённые формы:

```text
(КОММЕНТАРИЙ)
; КОММЕНТАРИЙ
```

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

В native iTNC используются комментарии `;`. Для активного iTNC-документа Options закрепляет этот стиль и отключает автоопределение ISO-дуг; настройки ISO сохраняются. Тип файла по умолчанию действует на новые документы, а применение Options сохраняет режим текущего редактора. Во вкладке Colors подписи «Быстрое перемещение», «Линейное перемещение» и «Круговое перемещение» обозначают типы движения для всех стоек.

### Как работают необязательные строки с пропуском блока `/`?

Исходный блок, начинающийся с `/`, помечается как необязательный.

При включённом **Ignore Block Skip** полный блок исключается из выполнения, включая:

- движение;
- присваивания Macro B;
- сигналы;
- вызовы подпрограмм или макросов.

При отключённом параметре он выполняется нормально.

---

## Диагностика и поведение при отказе

### Что такое `ok` и `complete`?

`ExecutionResult.ok` показывает, завершилось ли выполнение без критической ошибки. `ExecutionResult.complete` показывает, считает ли ядро результат выполнения достаточно полным, в том числе для экспорта.

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

### Какая диагностическая информация хранится?

Диагностика может содержать:

- стабильный код, такой как `UNSUPPORTED_G_CODE` или `UNDEFINED_MACRO`;
- читаемое человеком сообщение;
- серьёзность;
- статус, такой как verified, unverified, unsupported, malformed или resource-limited;
- строку исходного кода;
- offending raw block.

### Что происходит после неподдерживаемой семантики, изменяющей позицию?

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

Это предотвращает рисование вводящей в заблуждение соединительной линии через неизвестную область.

### Как классифицируются неподдерживаемые G-коды точения?

Неподдерживаемый G-код, который может влиять на геометрию, рассматривается более серьёзно, чем негеометрический управляющий код. Например, неподдерживаемый код в блоке, содержащем X/Z/U/W, может сделать блок неподдерживаемым, а не просто непроверенным.

Движение по оси Y не моделируется в `fanuc_turn` и выдаёт `UNSUPPORTED_AXIS`.

### А что насчёт неподдерживаемых M-кодов?

Ядро отслеживает смоделированные сигналы управления программой и станком. Немоделируемые вспомогательные M-коды дают неблокирующие предупреждения `UNSUPPORTED_M_CODE` в FANUC milling/turning и SINUMERIK native/ISO milling, включая кадры с движением. Нативная/ISO-T токарка SINUMERIK вместо этого отклоняет немоделируемые M-функции с диагностикой неподдержанной команды. Правило действует в GUI и CLI/batch. M2/M30 завершают программу. FANUC M98/M99 сохраняют моделируемый вызов/возврат; native SINUMERIK milling M17/M96/M97/M99 останавливают исполнение с диагностикой неподдержанного потока. Native milling M66/M98 дают вспомогательные предупреждения; M98 не вызывает подпрограмму FANUC.

### Обнаруживаются ли конфликтующие модальные коды?

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

### Существуют ли ограничения ресурсов выполнения?

Да. Бюджет выполнения по умолчанию защищает от неуправляемых макросов, рекурсивных вызовов и патологических циклов:

| Ресурс | По умолчанию в GUI |
| --- | ---: |
| Выполненные блоки | 500 000 |
| Вызовы подпрограмм/макросов | 10 000 |
| Сгенерированные движения | 2 147 483 647 |
| Максимум сегментов автообновления | 2 147 483 647 |
| Итерации цикла | 100 000 |
| Итерации макро-цикла | 100 000 |
| Общая глубина вызовов | 64 |

Ядро, GUI, CLI и пакетное выполнение используют одинаковые бюджеты выполнения по умолчанию. Лимит сегментов GUI относится к отрисовке; явно заданные лимиты выполнения сохраняют приоритет.

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

---

## FANUC Macro B и поток программы

### Насколько полна поддержка Macro B?

Macro B является частью среды выполнения, а не препроцессором текстовой подстановки. Выражения вычисляются во время выполнения программы, поэтому циклы, ветвления, вызовы подпрограмм и состояние переменных влияют на рассчитанную траекторию.

Одна и та же среда выполнения Macro B используется для точения и фрезерования.

### Какие формы переменных поддерживаются?

Числовые переменные:

```text
#1
#100
#500
#13001
```

Именованные переменные:

```text
#<NAME>
#<TOOL_RADIUS>
```

Косвенные ссылки:

```text
#[#1]
#[100+#2]
#[FUP[#[ROUND[#3]]]]
```

Косвенное присваивание также поддерживается:

```text
#1=100
#[#1]=5
#[#1+1]=#100+2
```

Косвенное назначение должно разрешаться в целочисленный номер переменной.

### Что особенного в `#0`?

`#0` постоянно пуста.

Ей нельзя присвоить значение:

```text
#0=123
```

выдаёт `INVALID_MACRO_ASSIGNMENT`.

Пустые значения отличаются от числового нуля для проверок равенства:

```text
IF[#1 EQ #0] GOTO10
```

— обычный способ обнаружить пропущенный/пустой локальный аргумент.

В арифметике пустое значение ведёт себя как числовой ноль. Присваивание пустого значения очищает целевую переменную:

```text
#100=#0
```

После этого присваивания `#100` является пустой, а не сохранённой как числовой `0`.

### Что происходит, когда неопределённая переменная используется численно?

Обычная числовая ссылка на неопределённую переменную отказывает с `UNDEFINED_MACRO`.

Специальное поведение сравнения с учётом null используется там, где требуется семантика пустых значений FANUC, например, при сравнениях с `#0`.

### Какие арифметические и реляционные операторы поддерживаются?

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

```text
+  -  *  /
MOD
EQ  NE  GT  GE  LT  LE
AND  OR  XOR
```

Скобки могут быть вложенными:

```text
X[#100+5]
#10=[[#1+#2]*#3]
```

Компактные выражения, такие как `#1LT#3`, принимаются. AND/OR/XOR приводят операнды к целым и выполняют побитовые операции; Python truthiness не используется. Сравнения возвращают числовые 0/1.

Вычислитель отклоняет степень (`**`), строки, bytes, контейнеры и boolean constants. Пределы: 4096 символов, 512 узлов AST и глубина 64. Числовые константы вычисляются как конечные float. LN требует положительный аргумент; переполнение EXP выдаёт диагностику. BIN/BCD/ADP остаются явно неподдерживаемыми: их controller-specific семантика не подтверждена локальными материалами.

### Какие функции Macro B реализованы?

Текущий вычислитель включает:

```text
ABS
SQRT
SIN
COS
TAN
ATAN
FIX
FUP
ROUND
MIN
MAX
LN
EXP
```

Тригонометрические аргументы и результаты следуют семантике градусов в стиле FANUC.

Поддерживается синтаксис двухаргументного арктангенса FANUC:

```text
ATAN[y]/[x]
```

Например:

```text
#119=ATAN[0.75]/[1.625]
```

`ROUND` использует округление до ближайшего целого в стиле FANUC с `.5` от нуля.

### Поддерживаются ли присваивания в блоках с метками?

Да. Метка блока `N` может предшествовать оператору потока Macro B или присваиванию:

```text
N900 #151=7
```

Метки индексируются один раз для выполнения потока.

### Поддерживается ли безусловный `GOTO`?

Да:

```text
GOTO100
...
N100 ...
```

Отсутствующая цель выдаёт `FLOW_TARGET_MISSING`.

### Поддерживается ли `IF [...] GOTO`?

Да:

```text
IF[#1 EQ 2] GOTO900
IF[[#2*#11] GT 360] GOTO16
```

Условия вычисляются во время выполнения с использованием текущего состояния переменных.

### Поддерживаются ли циклы `WHILE / DO / END`?

Да:

```text
#1=0
WHILE[#1 LT 3] DO1
#1=#1+1
G1 X#1 F100
END1
```

Идентификаторы вложенных циклов индексируются перед выполнением. Отсутствующий `END`, несогласованный `END`, неуправляемые циклы или исчерпанный бюджет итераций макроса дают диагностику вместо зависания приложения.

### Тестируются ли реальные фрезерные программы Macro B?

Да. Регрессионный корпус включает программы Macro B, которые генерируют:

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

Они выполняются через обычное ядро фрезерования, а не через отдельный тестовый интерпретатор.

### Поддерживается ли `G65`?

Да. `G65 P...` вызывает макропрограмму `O` и создаёт правильную локальную область макроса.

Пример:

```text
G65 P7700 X0 Y0 M48 S5. D1 R50. Z-70. Q4. V8. I860. A7.5 B15. H24. K1. E100. F200.
```

Вызванный макрос затем может использовать отображённые локальные переменные `#1..#33`.

### Как отображаются аргументы G65 Type I?

Текущее отображение Type I:

| Адрес | Локальная переменная |
| --- | ---: |
| A | #1 |
| B | #2 |
| C | #3 |
| I | #4 при первом появлении |
| J | #5 при первом появлении |
| K | #6 при первом появлении |
| D | #7 |
| E | #8 |
| F | #9 |
| H | #11 |
| M | #13 |
| Q | #17 |
| R | #18 |
| S | #19 |
| T | #20 |
| U | #21 |
| V | #22 |
| W | #23 |
| X | #24 |
| Y | #25 |
| Z | #26 |

`G`, `L`, `N`, `O` и `P` являются управляющими словами и не связываются как обычные локальные аргументы.

### Как обрабатываются повторяющиеся аргументы I/J/K G65?

Повторяющиеся слова I/J/K используют последовательные локальные слоты в стиле FANUC Type II. Каждое появление сдвигается на три:

```text
I -> #4,  #7,  #10, ...
J -> #5,  #8,  #11, ...
K -> #6,  #9,  #12, ...
```

Принимается до 10 появлений каждого адреса I/J/K в одном вызове G65.

### Выполняют ли слова-аргументы G65 также машинные действия?

Нет. В вызове G65 слова, такие как `M`, `S`, `T`, `X`, `Y`, `Z` и `F`, являются аргументами макроса, а не одновременными командами шпинделя, инструмента, движения или подачи.

Например, `T7` или `M8` внутри списка аргументов G65 не создают сигнал смены инструмента или СОЖ.

### Что происходит с `#1..#33` при возврате из макроса G65?

Локальные переменные имеют область видимости.

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

Инспектор Variables отражает активную локальную область, пока воспроизведение находится внутри макроса, и показывает восстановленные значения вызывающей стороны после возврата.

### Что делает `G65 ... L...`?

`L` повторяет вызов макроса. Принимаемый диапазон — `1..9999`.

Каждое повторение начинается снова с исходными локальными аргументами G65. Изменения, сделанные предыдущим повторением в `#1..#33`, не просачиваются в следующее повторение.

### Насколько глубоко могут вкладываться макросы G65?

Текущая реализация допускает четыре вложенных уровня локальных переменных G65. Запрос более глубокого вложения макросов выдаёт `CALL_DEPTH_EXCEEDED` вместо молчаливого совместного использования повреждённой локальной области.

Более широкий бюджет стека вызовов M98/G65 отдельно ограничен общей настройкой глубины вызовов.

### Как ведёт себя M98 внутри макроса G65?

Вызов подпрограммы M98 внутри макроса G65 разделяет текущий локальный уровень макроса. Он сам по себе не создаёт ещё одну локальную область G65.

### Поддерживаются ли подпрограммы M98/M99 вне Macro B?

Да.

Типичная форма:

```text
M98 P2000
M98 P2000 L3
...
O2000
...
M99
```

`P` должен идентифицировать существующий положительный целочисленный номер O-программы. `L` должен быть положительным целым числом. Отсутствующие цели и недопустимые значения дают структурированную диагностику подпрограммы.

### Поддерживается ли `M99 P...`?

Нет. `M99 P` зависит от профиля контроллера и в настоящее время выдаёт `UNSUPPORTED_M99_P`, а не угадывает семантику перехода.

### Хранятся ли значения переменных Macro B для каждого шага выполнения?

Да. `ExecutionStep.variables` содержит неизменяемый снимок состояния переменных для этого появления исходного блока. Неизменённые снимки внутренне повторно используются, а не копируются для каждого движения.

Это то, что позволяет инспектору Variables в GUI следовать логическому воспроизведению без повторного запуска программы ЧПУ.

### Сохраняет ли экспорт Expanded Execution операторы Macro B?

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

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

---

## FANUC точение

Интерпретатор поддерживает FANUC Type A (по умолчанию) и Type B. Выберите Type B в **Настройки → Параметры → Общие → Source lathe G-code system** либо передайте `--lathe-gcode-system B` команде CLI. В Type B коды G90/G91 управляют абсолютными и инкрементальными X/Z, G33 задаёт резьбу, G77/G78/G79 — простые циклы, а G94/G95 — подачу в минуту и на оборот. Type C, модальные макровызовы G66/G67 и операции индексной плоскости G68.2/G53.1 не входят в поддерживаемый токарный язык.

### Основные отличия Type A и Type B

| Операция | Type A | Type B |
| --- | --- | --- |
| Быстрый ход | G00 | G00 |
| Линейное движение | G01 | G01 |
| Дуга по часовой | G02 | G02 |
| Дуга против часовой | G03 | G03 |
| Выдержка | G04 | G04 |
| Нарезание резьбы | G32 | G33 |
| Система координат / ограничение шпинделя | G50 | G92 |
| Чистовой цикл | G70 | G70 |
| Черновое точение | G71 | G71 |
| Черновая подрезка торца | G72 | G72 |
| Повторение контура | G73 | G73 |
| Сверление торца | G74 | G74 |
| Канавки OD/ID | G75 | G75 |
| Многопроходная резьба | G76 | G76 |
| Простой цикл точения | G90 | G77 |
| Простой резьбовой цикл | G92 | G78 |
| Простой цикл торцевания | G94 | G79 |
| Подача в минуту | G98 | G94 |
| Подача на оборот | G99 | G95 |

Type A использует абсолютные X/Z и инкрементальные U/W. В Type B G90/G91 переключают X/Z между абсолютным и инкрементальным режимами; U/W остаются инкрементальными.

### Что представляет собой модель координат точения?

Точение использует геометрию X/Z. Внутренне физическая геометрия X является радиальной, в то время как программируемый X может следовать программированию по диаметру или радиусу.

Состояние точения по умолчанию — программирование по диаметру.

### Как ведут себя X/U и Z/W?

- `X` и `Z` — слова абсолютной оси, где активный режим требует абсолютного программирования.
- `U` и `W` — инкрементальные слова оси точения.
- Преобразование X/U учитывает режим диаметра и радиуса.

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

### Как обрабатываются G20 и G21?

Ядро нормализует физическую геометрию до миллиметров внутри.

- `G20` устанавливает масштабирование ввода в дюймах;
- `G21` устанавливает масштабирование ввода в миллиметрах.

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

### Какие форматы дуг точения поддерживаются?

Точение использует круговую интерполяцию G18 XZ с:

- относительным или абсолютным центром I/K согласно Arc Type либо автоматическому определению;
- программированием радиуса R.

Рассчитанные дуги сохраняют точные геометрические данные: центр, радиус, угол и направление.

Дуги R в профиле сохраняют формат R при черновой обработке G71/G72/G73 и чистовом проходе G70 независимо от выбранной трактовки I/K. Если дуга I/K в профиле P/Q некорректна при выбранном вручную режиме, связанный цикл не публикует частичную траекторию и сообщает исходную строку.

### Почему направление G2/G3 может выглядеть инвертированным на графике XZ?

Физическая ориентация G18 и визуальная ориентация графика X/Z — не одно и то же представление координат. Ядро разрешает физическое направление дуги, а слой построения графика использует правильное соглашение XZ, а не рассматривает его как геометрию XY.

### Поддерживается ли прямое программирование угла A при точении?

Да. В обычных токарных блоках G1 программирование угла A может разрешить отсутствующую конечную точку X или Z, используя предыдущее направление контура и запрограммированный угол.

### Поддерживаются ли фаски C и скругления углов R?

Да. Обычные блоки контура G1 могут включать:

- угловые фаски `C`;
- угловые скругления `R`.

Это отличается от `G2/G3 R`, где R — радиус круговой интерполяции.

### Поддерживаются ли движения резьбы G32 и G33?

Да. G32/G33 представлены как синхронизированные резьбовые движения в рассчитанной траектории. Состояние резьбы сохраняется при экспорте и в Stock Removal, где применимо.

### Какие режимы подачи при точении?

Для точения:

```text
G98 -> подача в минуту
G99 -> подача на оборот
```

Режим подачи точения по умолчанию — на оборот.

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

### Моделируются ли G96 и G97?

Да.

```text
G96 -> постоянная скорость резания (CSS)
G97 -> режим прямых оборотов
```

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

### Что делает G50 S при точении?

`G50 S...` отслеживается как ограничение скорости шпинделя, используемое с моделью шпинделя точения. Он не рассматривается как операция отмены масштабирования G50 фрезерования.

### Отслеживаются ли сигналы пуска/останова шпинделя?

Да. M3/M4 отмечают работающий шпиндель, а M5 отмечает его остановку. Машинные сигналы, такие как шпиндель, СОЖ, выдержка и конец программы, также публикуются в `ExecutionResult.signals`.

### Какие функции WCS работают при точении?

Ядро поддерживает:

- `G54-G59`;
- расширенные смещения `G54.1 P1-P99`;
- программирование `G10 L2` для G54-G59;
- программирование `G10 L20` для смещений G54.1.

Изменения G10 во время выполнения возвращаются в результате выполнения и не записывают молча настройки приложения.

### Поддерживается ли G53 при точении?

Да, для немодального движения G0/G1 в машинных координатах.

Токарный `G53 G2/G3` не может быть смоделирован текущим контрактом и выдаёт `UNSUPPORTED_G53_MOTION` вместо выполнения как дуги относительно WCS.

### Как работает G28?

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

### G30 — то же самое, что G28?

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

### Как работает компенсация радиуса при вершине резца?

Состояние G40/G41/G42 отслеживается при точении. Если задан подходящий токарный инструмент с известной геометрией вершины, ядро может рассчитать траекторию с компенсацией.

Геометрия инструмента сама по себе не включает коррекцию. Профили G71/G72/G73 используют коррекцию вершины только при явно активной G41/G42, включая команды внутри контура P-Q. Без G41/G42 изменение настроенного радиуса вершины не меняет программируемую траекторию; припуски U/W цикла продолжают учитываться.

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

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

---

## Циклы точения

### Какие циклы точения моделируются?

Текущий слой циклов точения включает:

| Type A | Type B | Назначение в ядре |
| --- | --- | --- |
| G70 | G70 | Чистовой контур P-Q |
| G71 | G71 | Продольная обдирка |
| G72 | G72 | Торцевая обдирка |
| G73 | G73 | Обдирка повторением шаблона |
| G74 | G74 | Сверление/прорезка торца с периодическим выводом по Z |
| G75 | G75 | Сверление/прорезка по X с периодическим выводом |
| G76 | G76 | Двухстрочная многопроходная резьба |
| G83 | G83 | Осевое сверление с периодическим выводом |
| G84 | G84 | Осевое нарезание резьбы метчиком |
| G90 | G77 | Модальный цикл продольного точения |
| G92 | G78 | Модальный цикл резьбы |
| G94 | G79 | Модальный цикл торцевой обработки |

Геометрия цикла раскрывается в обычные логические движения. Эти движения затем потребляются воспроизведением, статистикой, Stock Removal и экспортом.

### Помнят ли движения цикла, откуда они пришли?

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

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

### Как выбираются профили циклов по P и Q?

Циклы контура P/Q разрешают метки N в разобранной программе. Резолвер обрабатывает повторяющиеся метки относительно места вызова цикла, а не предполагает, что каждая метка N глобально уникальна.

Для чистовой обработки предшествующий профиль P-Q может быть предпочтительнее, где это уместно.

### Поддерживают ли блоки профиля G71/G72/G73 линии и дуги?

Да. Контур P-Q строится как сегменты профиля и может включать поддерживаемую линейную и круговую геометрию. Аналитические данные дуги сохраняются, где возможно, вместо преобразования каждой дуги профиля в ступенчатую форму.

### Как работает G70?

`G70 P... Q...` строит указанный чистовой контур и подходит к нему из фактической позиции вызова G70.

Чистовой путь основан на номинальном профиле P-Q, а не на профиле со смещением обдирки, используемом G71/G72/G73.

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

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

### Какая форма G71 поддерживается?

Моделируется обычная двухстрочная форма FANUC:

```text
G71 U... R...
G71 P... Q... U... W... F...
```

Первая строка фиксирует глубину обдирки и отвод. Вторая строка задаёт профиль P-Q, припуски на чистовую обработку и подачу.

### Как интерпретируется глубина G71?

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

Пустой профиль P-Q или нулевая глубина первой строки выдаёт явную диагностику G71; частичная траектория цикла не публикуется.

### Как обрабатываются припуски на чистовую обработку G71 U/W?

U и W второй строки применяются к профилю обдирки до генерации черновых проходов.

U имеет знак. Это важно для наружной и внутренней обработки:

- положительный U оставляет наружный материал на наружном контуре;
- отрицательный U может оставить материал в сторону внутренней поверхности отверстия на внутреннем контуре.

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

### Как G71 различает обдирку по наружному и внутреннему диаметру?

Цикл сравнивает подход со стороны заготовки и геометрию профиля и выбирает поведение расточки или наружной обработки. Используется тот же движок контура P-Q, но направление прохода и направление отвода следуют выбранной стороне материала.

### Что такое поведение G71 Type I?

Type I рассматривается как монотонная продольная обдирка. Каждый черновой проход параллелен Z и заканчивается на профиле обдирки P-Q.

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

### Поддерживается ли G71 Type II?

Профиль Type II обнаруживается, когда первый блок P содержит как компонент X/U, так и компонент Z/W.

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

### Как работает G72?

G72 использует ту же инфраструктуру профиля P-Q, что и G71, но выполняет торцевую обдирку в плоскостях Z.

Типичная двухстрочная форма:

```text
G72 W... R...
G72 P... Q... U... W... F...
```

Первая строка фиксирует осевую глубину и отвод. Вторая строка ссылается на профиль и припуски на чистовую обработку.

### Является ли G72 Type II полностью универсальным?

Нет. Type II поддерживается там, где плоскость торцевой обработки разрешается в детерминированный диапазон профиля. Если одна плоскость торцевой обработки создаёт несколько несвязных диапазонов материала, требующих зависящей от контроллера интерпретации, выполнение явно отказывает с:

```text
UNSUPPORTED_G72_TYPE_II_SPANS
```

вместо выбора произвольного диапазона.

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

Повторные пересечения в одной и той же конечной точке замкнутого контура считаются одним пересечением. Различные несвязные диапазоны по-прежнему выдают `UNSUPPORTED_G72_TYPE_II_SPANS`.

### Как работает G73?

G73 реализован как повторяющиеся смещённые копии профиля обдирки.

Первая строка фиксирует общее смещение шаблона U/W и количество проходов R. Вторая строка задаёт P/Q, припуски на чистовую обработку и подачу.

Знаки запрограммированных U/W сохраняются. Цикл не выводит направление смещения из того, как инструмент случайно подошёл к контуру.

### Как работает G74?

G74 поддерживает поведение периодического вывода по Z и повторение в стиле прорезки торца.

Первый блок, содержащий только R, может установить расстояние отвода. Исполняющий блок может использовать X/U и Z/W плюс параметры P/Q/R/F.

Если целевое значение X не задано, G74 может работать как сверление по Z в стиле периодического вывода на текущем X.

Когда запрашивается повторение по X, P управляет шагом X, а Q управляет глубиной периодического вывода по Z. Цикл возвращается к сохранённому началу, используя явный порядок возврата сначала по Z.

### Как работает G75?

G75 выполняет периодический вывод/радиальную прорезку по X.

P управляет радиальным шагом периодического вывода. Q может повторять канавки вдоль Z. Если Q опущен, запрограммированный Z/W выбирает одно место канавки, а не рассматривается как недопустимое повторение с нулевым шагом.

Значение R из установочного блока управляет расстоянием отвода, а значение R исполняющего блока обрабатывается как припуск по дну, где применимо.

### Как представлено движение сверления с периодическим выводом при точении?

Ядро выдаёт фактические примитивы подачи и ускоренного хода для каждой последовательности периодического вывода/отвода. Оно не хранит G74/G75 как непрозрачный цикл, который рендерер должен понимать отдельно.

### Как работает двухстрочный G76?

Моделируемая форма — двухстрочный G76 в стиле FANUC:

```text
G76 P...... Q... R...
G76 X... Z... P... Q... R... F...
```

Первый блок хранит:

- упакованные управляющие цифры P;
- минимальное радиальное приращение Q;
- необязательный припуск на чистовую обработку R.

Второй блок задаёт:

- конечный X резьбы;
- конечный Z;
- высоту резьбы P;
- первый рез Q;
- необязательную конусность R;
- шаг F.

### Как интерпретируются целочисленные приращения P/Q в G76?

Q первого блока и P/Q второго блока рассматриваются как целочисленные приращения наименьшего ввода, а не обычные слова с плавающей длиной.

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

### Как генерируется глубина проходов G76?

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

Конечное заданное значение X определяет итоговый диаметр резьбы.

### Что означают упакованные цифры P в G76?

Упакованный P первой строки декодируется как:

```text
P(m)(r)(a)
```

где поля представляют:

- количество финальных/пружинных проходов;
- величину фаски в десятых долях шага;
- угол инструмента/резьбы.

### Какие углы инструмента G76 моделируются?

Поддерживаемый набор:

```text
0, 29, 30, 55, 60, 80 градусов
```

Другие упакованные углы явно отказывают с:

```text
UNSUPPORTED_G76_TOOL_ANGLE
```

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

### Как моделируется фаска G76?

Упакованные цифры фаски отмечают осевой интервал на основе шага резьбы. Текущая модель разбивает конечную часть прохода на коллинеарные сегменты; наклонный радиальный выход и физическая фаска не моделируются. Угол выхода контроллера не настроен, а угол инструмента в P его не заменяет. Универсальный выход под 45° не предполагается.

### Является ли G92 модальным циклом резьбы?

Да.

Пример:

```text
G92 X18 Z-10 F1.5
X17.5
X17.0
```

Начальный G92 устанавливает конец резьбы и шаг. Последующие блоки только с X/U продолжают активный цикл G92 с новыми глубинами до отмены другим явным режимом движения/цикла.

Каждый проход раскрывается в примитивы подхода, синхронизированного продольного резания, отвода и возврата.

### Является ли G90 модальным циклом точения?

Да. G90 устанавливает цикл продольного прямоугольного точения. Последующие блоки только с X/U могут продолжать активный цикл на новых диаметрах до отмены другим явным кодом движения/цикла.

### Является ли G94 модальным циклом торцевой обработки?

Да. G94 устанавливает цикл торцевой прямоугольной обработки. Последующие блоки только с Z/W могут продолжать активный цикл на новых положениях торца до отмены.

### Что отменяет G90/G92/G94?

Немодальный код, такой как G96/G97, не отменяет активный цикл.

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

### Являются ли G83 и G84 при точении модальными?

Да. G83 и G84 остаются активными для последующих подходящих блоков координат до отмены G80, другим состоянием цикла или сменой инструмента.

### Как ведёт себя G83 при точении?

G83 — осевой цикл сверления по Z.

- Если задан Q, генерируются периодические выводы по Z.
- Если Q отсутствует, ядро не выдумывает глубину периодического вывода; оно выдаёт один ход подачи на глубину и ускоренный возврат.
- Необязательное позиционирование по X обрабатывается перед осевым ходом и восстанавливается после.

### Как ведёт себя G84 при точении?

G84 — осевой цикл нарезания резьбы метчиком. Ход вниз и возврат являются синхронизированными движениями подачи; возврат не представлен как ускоренное перемещение.

### Создаёт ли выдержка P в G83/G84 при точении геометрию?

Нет. Выдержка — это событие времени/управления, а не пространственный сегмент. Поэтому геометрия обратного построения не выдумывает движение для самой выдержки.

### Что произойдёт, если модальный цикл сверления/нарезания резьбы останется в недопустимом состоянии?

Среда выполнения может сообщить об ошибке выполнения класса `UNCLOSED_CYCLE`, а не молча нести невозможный модальный цикл до конца программы.

---

## FANUC фрезерование

### Какие G-функции фрезерования распознаются?

В таблице перечислены G-коды, распознаваемые ядром `fanuc_mill`. Подробности и ограничения описаны ниже.

| G-код | Функция в ядре |
| --- | --- |
| G00 | Быстрое позиционирование |
| G01 | Линейная интерполяция |
| G02 / G03 | Круговая интерполяция по / против часовой стрелки |
| G04 | Сигнал выдержки времени без перемещения |
| G10 | Программирование смещений WCS (`L2`, `L20`) |
| G15 / G16 | Отмена / включение полярных координат |
| G17 / G18 / G19 | Выбор плоскости XY / XZ / YZ |
| G20 / G21 | Входные единицы: дюймы / миллиметры |
| G28 | Возврат в заданную опорную точку |
| G40 / G41 / G42 | Отмена / левая / правая компенсация радиуса фрезы |
| G43 / G49 | Учитывают / отменяют состояние коррекции длины; G43 не применяет H к траектории |
| G43.4 | TCP-перемещения G0/G1/G2/G3 для наклонных профилей стола AC/BC, включая дуги с поворотом; сочетание с G68.2 не поддерживается |
| G50 / G51 | Отмена / включение масштабирования координат |
| G52 | Локальное смещение координат |
| G53 | Немодальное движение в координатах станка |
| G54–G59 | Выбор рабочей системы координат |
| G54.1 P1–P99 | Разбирается и выбирается; в GUI нет настройки смещения, поэтому оно нулевое, если программа не задаёт его через G10 L20 |
| G65 | Вызов программы Macro B |
| G68 / G69 | Включение / отмена поворота координат |
| G68.2 / G53.1 | Наклонная рабочая плоскость / ориентация оси инструмента (3+2, `fanuc_mill` с двухосевой кинематикой стол-стол, голова-голова или голова-стол) |
| G73 | Цикл высокоскоростного сверления с периодическим выводом |
| G80 | Отмена постоянного цикла |
| G81 | Цикл сверления |
| G82 | Цикл сверления с выдержкой |
| G83 | Цикл сверления с полным выводом |
| G84 | Цикл нарезания резьбы метчиком |
| G85 | Цикл растачивания с возвратом на подаче |
| G86 | Цикл растачивания с сигналом остановки шпинделя |
| G90 / G91 | Абсолютное / инкрементальное программирование |
| G93 | Обратная подача по времени: каждый кадр подачи занимает 1/F минуты; при переключении G93/G94/G95 задайте новое положительное F. Циклы и коррекция радиуса под G93 не поддержаны |
| G94 / G95 | Подача в минуту / на оборот |
| G98 / G99 | Возврат на исходную плоскость / плоскость R в постоянном цикле |

### Какие M-функции фрезерования распознаются?

| M-код | Функция в ядре |
| --- | --- |
| M00 / M01 | Сигнал остановки / необязательной остановки |
| M02 / M30 | Завершение программы |
| M03 / M04 / M05 | Сигналы вращения шпинделя по / против часовой стрелки / остановки |
| M06 | Событие смены выбранного инструмента T |
| M07 | Распознаётся; действие для конкретной системы охлаждения не моделируется |
| M08 / M09 | Сигналы включения / выключения охлаждения |
| M19 | Сигнал ориентации шпинделя; S в этом блоке задаёт угол, а не обороты |
| M29 | Подготовка жёсткого резьбонарезания; S в этом блоке задаёт обороты для следующего G84 |
| M98 / M99 | Вызов подпрограммы / возврат из неё |

Неизвестные вспомогательные M-коды дают предупреждение `UNSUPPORTED_M_CODE` и позволяют выполнению продолжиться в FANUC milling/turning и SINUMERIK native/ISO milling, в том числе в кадрах с движением. Нативная/ISO-T токарка SINUMERIK вместо этого отклоняет немоделируемые M-функции с диагностикой неподдержанной команды. M0/M1 записывают сигналы останова станка без остановки расчёта траектории; M2/M30 завершают программу; FANUC M98/M99 моделируют вызов/возврат. Native SINUMERIK milling M17/M96/M97/M99 останавливают исполнение с диагностикой неподдержанного потока, а native milling M66/M98 дают вспомогательные предупреждения без вызова подпрограмм. Распознаваемые M-коды описывают сигналы и поток программы, но не моделируют оборудование станка.

`M29 S500` перед `G84` помечает жёсткое резьбонарезание в результате выполнения. При `G95` значение `F1.5` означает 1,5 мм/об в метрическом режиме; при `G94` эквивалентная подача для 500 об/мин — `F750` мм/мин. `G80` сбрасывает подготовку к жёсткому резьбонарезанию. Синтаксис M29 и необходимость его применения зависят от конфигурации станка. Ядро фиксирует семантику синхронизации, но не моделирует энкодер или разгон шпинделя.

### Какое базовое движение фрезерования моделируется?

Ядро фрезерования поддерживает ускоренное, линейное и круговое/винтовое движение XYZ в активной плоскости G17/G18/G19.

Объект `TraceMotion` содержит рассчитанную трёхмерную геометрию, хотя многие команды ЧПУ задают движение в плоскости.

### Как обрабатывается индексированное поворотное фрезерование?

Если расчёт остановился из-за отсутствующего профиля или неподдержанной им оси, над графиком появляется постоянное уведомление. Оно перечисляет обнаруженные адреса движения A/B/C, включая нулевые углы, и строку остановки. **Выбрать кинематику...** открывает существующее меню профилей; **Перейти к строке** переводит редактор к проблемному кадру. Ошибка сохраняется и после автообновления, не создавшего ни одного движения. Уведомление относится к активному MDI-документу и исчезает после успешного расчёта. Комментарии и аргументы макровызова G65 не считаются движениями осей. По буквам осей нельзя определить стол/голову, порядок вращений, направления и центры, поэтому профиль станка автоматически не выбирается.

Выберите профиль в **Настройки → Кинематика вращения** или передайте `--kinematics PROFILE_ID` с `--lang fanuc_mill` в CLI. Выбор GUI сохраняется как `CNC/ROTARY_KINEMATICS`. Профиль сопоставляет программируемые адреса A/B/C со знаковыми поворотными осями. G90 задаёт абсолютный поворотный угол; G91 добавляет приращение. Для проверенных профилей стола последующие движения XYZ, рассчитанные дуги и циклы фрезерования преобразуются в фиксированную систему отображения WCS, а воспроизведение ориентирует предварительный просмотр инструмента в рассчитанной точке вершины инструмента. Сами оси WCS не поворачиваются.

Возврат в опорную точку G28 и немодальный G53 сначала используют координаты осей станка, включая повторные возвраты и приращения G91, затем отображают свои точки трассы в индексированную систему отображения. Активная WCS остаётся выбранной после G53. Индекс A/B записывает событие и изменяет последующую геометрию; в настоящее время ядро не генерирует дискретизированную трассу вершины инструмента во время поворотного движения. График опускает соединительную линию через это изменение позиции.

Для проверенного профиля **4-axis Table C** одновременные блоки подачи X/C и блоки только C отображают свои конечные точки в фиксированную плоскость XY. Здесь X — это программируемый радиус, а C — угол вокруг Z; контурную выборку обеспечивает исходная программа. Эти блоки записывают `ROTARY_MOTION`, а не событие индексации.

### Какие поворотные профили были проверены?

Профили **4Ax Table A** и **4Ax Table B** были сопоставлены с программами в `tests/fixtures/milling/fanuc/indexed_table_a.nc` и `tests/fixtures/milling/fanuc/indexed_table_b.nc`. Профиль **4-axis Table C** проверяется по `tests/fixtures/milling/fanuc/indexed_table_c.nc`: его контур X/C накладывается на первый контур XY программы с точностью до 0.05 мм в выборочных конечных точках. Файлы фикстур — это эталонные входные данные, а не определения станка. Автоматические проверки также охватывают знаки углов A/B, G90/G91 и поведение повторных G28/G53.

Весь встроенный каталог из 24 конфигураций доступен во вкладке **Настройки → Параметры → Кинематика вращения**: Head A/B/C, ортогональные AC/BC, смешанные и наклонные схемы. Флажок **Включено (Enabled)** в панели параметров справа определяет видимость профиля в существующем меню **Настройки → Кинематика вращения**. Для встроенных профилей эта настройка хранится отдельно в пользовательском config.ini: их определения и исторические флаги `enabled` не меняются. Скрытые профили остаются во вкладке Options, чтобы их можно было включить снова. Видимость применяется по **OK**, **Отмена** отбрасывает изменения. Отключение активного профиля сбрасывает выбор и обновляет расчёт. По умолчанию все встроенные профили видны; пользовательские копии сохраняют своё состояние включения.

Для каждой поворотной оси пользовательской копии можно задать **Мин. (°)** и **Макс. (°)**: оба конечных числа, минимум не больше максимума. Оба поля пустые означают отсутствие ограничения (continuous). Встроенные профили не имеют пределов; для их настройки создайте копию. Выход исполняемого угла за включительный диапазон даёт предупреждение **ROTARY_AXIS_LIMIT_EXCEEDED** на строке источника во вкладке Tokens/Variables, без остановки выполнения и блокировки экспорта. Проверяются только изменившиеся оси; углы сравниваются как есть, без нормализации. Пределы не меняют геометрию и выбор решения TWP/TCP.

Прежняя практическая проверка относится только к пяти профилям **4Ax Table A**, **4Ax Table B**, **4-axis Table C**, **5Ax Table AC Angled** и **5Ax Table BC Angled**. Остальные профили и пользовательские копии доступны, но **не верифицированы**; статус во вкладке Options явно показывает это различие. Синтетические проверки направлений и порядка вращений подтверждают применение параметров ядром, а не соответствие произвольной УП физическому станку. По умолчанию активна настройка **Нет**.
Выбранный профиль явно определяет ось стола/головы и знак; программное обеспечение не может вывести эти свойства из слова A, B или C. Шаги выполнения сохраняют выбранную WCS и настроенные поворотные углы. G10 L2 и изменения WCS сохраняют текущую позицию станка после индексации стола.

Встроенные профили доступны только для чтения. Кнопка **Создать копию** создаёт пользовательский профиль; можно изменить название, доступность в меню, принадлежность осей столу/голове, адреса A/B/C, векторы направлений и порядок вращений. Строки задают порядок осей внутри каждой ветви. **Сохранить профиль** подготавливает изменения; **OK** атомарно записывает пользовательские копии в `rotary_profiles.json` рядом с `config.ini`. **Отмена** отбрасывает изменения и удаления. Редактирование отключённой копии не включает её автоматически. Просмотр и сохранение не активируют профиль: активация выполняется существующим меню, сохраняется между запусками и обновляет расчёт.

Параметры копий поступают в существующие матрицы вращения траектории и ориентации инструмента. TCP поддерживает наклонную ось A/B стола с последующим вращением C вокруг вертикали; непрерывное плоское C требует единственной вертикальной оси C стола. Неподдерживаемые схемы допускают индексацию и отклоняют неподдерживаемые команды TCP/непрерывного вращения. Это Rotary Axis Kinematics с неподвижной заготовкой, без размеров станка, pivot и физической машинной симуляции.

Старые overrides встроенных ID загружаются как отдельные пользовательские копии; сохранённый выбор GUI переводится на соответствующую копию. Чтение не меняет исходный файл. Перед первой последующей записью мигрированного каталога исходные байты сохраняются в `rotary_profiles.json.invalid-*.bak`. Ошибочные отдельные записи пропускаются с сообщением в журнале, остальные профили доступны. Полностью нечитаемые пользовательские файлы по умолчанию пропускаются с записью в журнале и в GUI, и в ядре/CLI: встроенные профили остаются работоспособны. Сохранение корректной пользовательской копии восстанавливает файл с резервной копией исходных данных. Для внутренней строгой проверки файла доступен вызов `load_catalog(ignore_user_errors=False)`.

### Что происходит, когда индексированная геометрия не может быть разрешена?

Изменённый адрес A/B/C без выбранного профиля или адрес, отсутствующий в выбранном профиле, останавливает выполнение фрезерования с явным диагностическим сообщением. Одновременное поворотное/XYZ-движение и неповоротная интерполяция с ускоренным ходом также останавливаются для индексированных профилей A/B; исключением является проверенный плоский контур подачи X/C **4-axis Table C**. Это текущая реализация, а не общее ограничение FANUC. A/B/C с неподдерживаемым G-кодом, изменяющим позицию, также останавливает выполнение. Неизвестные M-коды и G41/G42, которые невозможно проверить из-за отсутствующего инструмента или неподдерживаемых данных контура, выдают предупреждения и позволяют выполнению продолжиться. G30 не моделируется как G28: его зависящая от контроллера вторая опорная точка не выводится из настроенного дома G28.

Для **4-axis Table C** компенсация радиуса фрезы G41/G42 не поддерживается. Выполнение продолжается, но график X/C показывает запрограммированную траекторию вершины инструмента без смещения радиуса фрезы и сообщает `UNSUPPORTED_TABLE_C_CUTTER_COMPENSATION`. G40 отменяет модальный запрос. Не рассматривайте этот график как проверенный компенсированный контур.

Выбранный профиль делает расчёт воспроизводимым; сам по себе он не доказывает, что профиль соответствует физическому станку. Проверяйте диагностику и поддерживаемый контракт, прежде чем использовать `ok` или `complete` как решение об экспорте.

### Какие циклы фрезерования моделируются?

Текущий набор включает:

```text
G73
G80
G81
G82
G83
G84
G85
G86
```

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

### В чём разница между циклами сверления с периодическим выводом G73 и G83 при фрезеровании?

G73 — высокоскоростное сверление с коротким промежуточным отводом. G83 между проходами возвращается на R, затем быстро подходит с зазором d над предыдущей глубиной и продолжает на подаче. Повторный подход ограничен плоскостью R. Параметр ядра `milling_g83_clearance` задаёт d в миллиметрах, в том числе для дюймовых программ; значение должно быть конечным и неотрицательным. Значение по умолчанию 1,0 мм — допущение модели: настройку контроллера нельзя прочитать из программы. Меняются длина движения на подаче и статистика времени G83; токарный G83 и нативный SINUMERIK CYCLE83 сохраняют отдельное поведение.

В фрезерных циклах сверления глубина выше R вызывает `INVALID_DRILLING_DEPTH`. Z, равный R, допустим и не создаёт рабочего хода сверления.

### Как представлена выдержка G82?

G82 включает свою семантику выдержки, но выдержка сама по себе не создаёт пространственной геометрии.

### Как представлен G84 при фрезеровании?

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

### Как представлен G86 при фрезеровании?

Цикл моделирует семантику остановки шпинделя вместе со своим поведением сверления/возврата.

### Что означают G98/G99 при фрезеровании?

Для циклов фрезерования G98/G99 выбирают поведение возврата цикла. Это не значения режима подачи точения G98/G99.

### Какие режимы подачи при фрезеровании?

Для фрезерования:

```text
G94 -> подача в минуту
G95 -> подача на оборот
```

Статистика вычисляет достоверное время обработки только там, где известна необходимая информация о подаче/шпинделе.

### Какие системы рабочих координат поддерживаются?

Ядро поддерживает:

- `G54-G59`;
- `G54.1 P1-P99`;
- `G10 L2` во время выполнения;
- `G10 L20` во время выполнения.

### Как ведёт себя G10 при G91 во фрезеровании?

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

### Как работает G52?

`G52 X/Y/Z` устанавливает сдвиг локальной системы координат для последующего движения. Сам управляющий блок G52 не перемещает инструмент.

### Как работают G68 и G69?

G68 включает поворот координат вокруг запрограммированного центра в активной плоскости. G69 отменяет поворот.

В режиме SINUMERIK ISO-M (`G291`) поддерживается только вариант `G68` при активном `G90` и без вектора `I/J/K`. Варианты с углом G91 или с любым 3D-вектором `I/J/K` распознаются, но не поддерживаются. `G69` остаётся доступен.

Активное преобразование применяется к последующим конечным точкам и векторам дуг I/J/K. Включение или отмена преобразования само по себе не создаёт сегмент движения.

`G68.2 X/Y/Z I/J/K` задаёт наклонную рабочую плоскость 3+2 с углами Эйлера Z–X–Z. Выберите профиль кинематики с двумя разными поворотными осями; поддерживаются схемы стол-стол, голова-голова и голова-стол. Следующий отдельный блок `G53.1` рассчитывает углы выбранного профиля для совмещения физической оси инструмента с локальной +Z; недостижимая ориентация останавливает выполнение. `G69` отменяет наклонную плоскость, сохраняя положение индексированных осей. Эта модель работает только в `fanuc_mill`. Явные адреса A/B/C при активной наклонной плоскости и совмещение с G68 не поддерживаются. Опорные перемещения G53 и G28 используют координаты станка. Поддержанные индексированные фреймы G68.2/G53.1 и CYCLE800 для AC/BC экспериментально конвертируются через встроенные многоосевые посты; остальные сочетания фреймов отклоняются. Full Program сохраняет исходный текст.

### Как работает масштабирование G51/G50?

Фрезерный G51 поддерживает:

- равномерное масштабирование с P, где `P1000` означает коэффициент 1.0;
- поосевые коэффициенты через I/J/K.

G50 отменяет масштабирование фрезерования.

Для SINUMERIK ISO-M в `G51` используется моделируемый вес коэффициента 0,001 (`P2000` означает коэффициент 2,0). Другие варианты веса, заданные параметрами станка, не моделируются.

Центр масштабирования интерпретируется как абсолютные координаты даже при G91, а опущенные оси центра используют текущую позицию.

Поосевое масштабирование дуги может превратить окружность в некруговую геометрию. Ядро сообщает об этом неподдерживаемом случае, а не аппроксимирует его как окружность.

### Поддерживается ли G53 во фрезеровании?

Да. G53 — немодальное движение в машинных координатах. Оно не меняет активную WCS. Абсолютный нуль оси, например G53 Z0, означает настроенный дом станка по этой оси. Ненулевые абсолютные и относительные координаты сохраняют свой смысл.

### Поддерживается ли G28 во фрезеровании?

Да. Ядро разрешает опорный путь через настроенную точку дома станка. G91 G28 Z0 возвращает ось Z к настроенному Home Z; промежуточные и конечные точки рассчитываются в координатах станка.

При 4/5-осевой кинематике G28/G53 отображаются в текущей ориентации стола, без сброса ABC. Например, для стола B при Home Z=500 и нулевом смещении WCS возврат при B0 направлен к глобальному Z=500, а при B180 — к Z=-500. Если Z-возврат пересекает центральную плоскость WCS, выполнение останавливается с ошибкой: проверьте Home Z и смещение WCS. Эта проверка не является проверкой столкновений с моделью детали.

После G28/G53 в 4/5-осевой программе следующий подход может начинаться отдельным участком в новой ориентации стола. Соединяющая линия между участками не рисуется. В обычной 3-осевой программе непрерывность сохраняется, включая G28/G53.

### Как программируются дуги фрезерования?

Фрезерование поддерживает:

- относительные смещения центра IJK;
- абсолютные координаты центра IJK;
- программирование радиуса R.

Выбранная исходная интерпретация разрешается в одно аналитическое представление центра/радиуса/развёртки дуги.

### Что делает автоопределение типа дуги?

Если включено автоопределение, ядро проверяет дуги IJK в порядке их появления в программе до окончательного расчёта геометрии.

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

Дуги только с R игнорируются во время обнаружения, потому что они не различают соглашения IJK.

Если все кандидаты неоднозначны, используется выбранный резервный режим. GUI, CLI parse/trace/analyze и одиночный/пакетный экспорт включают определение по умолчанию для фрезеровки и токарки; резервный режим CLI — относительный IJK. Общий путь выполнения приложения использует допуск дуг GUI по умолчанию 0,01 мм. Прямой вызов ядра сохраняет явный выбор режима и допуска, а для токарки — допуск по умолчанию 0,001 мм.

Выбор типа дуги в GUI вручную переопределяет автоопределение для текущего документа. Настройка автоопределения остаётся включённой для следующего открытого документа. При точении дуга I/K, интерпретированная с неверным режимом центра, сообщает `INVALID_TURNING_ARC_CENTER`; выбор режима радиуса для дуги без слова R сообщает `TURNING_ARC_REQUIRES_R`.

### Может ли одна программа смешивать дуги R с дугами IJK?

Да. Обнаружение типа дуги определяет интерпретацию IJK. Блок только с R остаётся дугой R независимо от этого решения.

### Поддерживаются ли полные окружности?

Да. Аналитические полные окружности представлены непосредственно ядром.

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

### Поддерживается ли винтовая интерполяция?

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

### Что делает полярное программирование G16/G15?

`G16` включает программирование конечных точек в полярных координатах при фрезеровании, а `G15` возвращает к обычному декартову программированию.

Активная плоскость G17/G18/G19 определяет полярную плоскость:

- первая ось в плоскости = радиус;
- вторая ось в плоскости = угол в градусах.

### Как работает полярный G90?

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

### Как работает полярный G91?

При входе в `G91 G16` текущая позиция становится полюсом. Последующие полярные слова G91 инкрементируют модальный радиус или угол, а опущенные компоненты сохраняют своё предыдущее полярное значение.

### Масштабируют ли G20/G21 полярный угол?

Нет. Радиус — это длина, и он следует единицам. Угол остаётся в градусах.

### Поддерживаются ли полярные дуги G2/G3?

Реализованный контракт полярных круговых дуг требует программирования радиуса R. Программирование центра I/J/K при активном полярном режиме G16 отклоняется с явной диагностикой, а не угадывается.

### Поддерживается ли полярная интерполяция G12.1/G13.1?

Нет.

### Как работает компенсация радиуса фрезы?

G40/G41/G42 использует настроенный диаметр фрезерного инструмента и работает с поддерживаемыми контурами линий, дуг и совместимых винтовых линий.

Поддержаны Flat, Bull, Ball, Face, Slot и Chamfer Mill. Компенсация использует половину настроенного диаметра; для Chamfer Mill это номинальный радиус фрезы без расчёта радиуса контакта по глубине. В превью фрезерования и точения Tap имеет плоский торец.

Для индексированного фрезерования со столом A/B смещение рассчитывается в локальной программируемой рабочей плоскости, прежде чем завершённая геометрия преобразуется в фиксированный график WCS. Выполнение продолжается, когда инструмент или контур не удаётся проверить, с сообщением `UNVERIFIED_CUTTER_COMPENSATION`. В 3D-виде перетаскивание левой кнопкой панорамирует, а перетаскивание средней кнопкой вращает вокруг курсора, как в CNCEditor; предустановка 3D/ISO для стола B показывает +Y вертикально вверх, +X вверх-вправо и +Z вниз-вправо, тогда как стол A сохраняет предустановку вертикального фрезерного станка.

Для **4-axis Table C** компенсация G41/G42 не рассчитывается. Траектория сохраняет запрограммированные координаты вершины инструмента X/C и выдаёт `UNSUPPORTED_TABLE_C_CUTTER_COMPENSATION`; G40 отменяет этот режим. Это ограничение относится к текущей реализации стола C.

Движок компенсации разрешает:

- переходы входа;
- геометрию установившегося смещения;
- стыки линия/дуга и дуга/линия;
- углы;
- переходы выхода G40.

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

### Что означает `UNVERIFIED_CUTTER_COMPENSATION`?

Исходный код запросил G41/G42, но ядро не смогло доказать допустимый компенсированный путь с доступным инструментом/конфигурацией/геометрией.

Система явно помечает это состояние, а не представляет некомпенсированную геометрию как проверенную компенсацию.

### Применяется ли геометрия длины инструмента G43?

Нет. G43/G49 и значения H отслеживаются для выполнения и экспорта, но смещение H пока не применяется к рассчитанной траектории инструмента.

Это ограничение намеренно, и его не следует интерпретировать как смоделированную позицию станка с компенсацией длины инструмента.

### Поддерживается ли непрерывная пятиосевая TCP-обработка G43.4?

Для fanuc_mill на наклонных профилях стола AC и BC поддерживаются непрерывные перемещения G0/G1 одновременно по линейным и поворотным осям. Активация TCP сохраняет текущую физическую точку в траектории. При выключенном TCP индексация сохраняет программные XYZ и меняет отображаемую ориентацию стола. Дуги G2/G3 при TCP допускают одновременный поворот настроенных осей; XYZ задают траекторию центра инструмента, сохраняются ориентации начала/конца. Сочетание TCP с G68.2 не поддерживается. Это разбор траектории, а не полная симуляция станка или столкновений.

---

## Библиотеки инструментов и обнаружение инструментов

### Где хранятся постоянные инструменты?

Токарные и фрезерные инструменты хранятся в:

```text
%LOCALAPPDATA%\easy-gcode-plot\tools.db
```

Эта база SQLite является основным источником данных для инструментов Saved Library.

### В чём разница между Current Program и Saved Library?

Экспорт инструментов Current Program допускает только файлы `.json` (без учёта регистра). Другие расширения, включая `.nc` и `.mpf`, и имена без расширения отклоняются до записи; существующие файлы сохраняются без изменений.

**Current Program** — временное состояние открытой программы ЧПУ. Явно заданные команды `T` можно обнаружить в программе и сопоставить с геометрией инструмента без изменения постоянной библиотеки.

**Импорт** и **Экспорт** под Current Program переносят текущую фрезерную или токарную настройку в JSON независимо от Saved Library и `tools.db`. Экспорт сохраняет все текущие инструменты независимо от выбранной строки. Импорт сначала проверяет весь файл, заменяет совпадающие слоты T, оставляет остальные инструменты программы без изменений и сообщает о неиспользуемых номерах из файла. Сохраняются геометрия, идентификаторы стойки, коррекции и пользовательские метаданные; размеры задаются в миллиметрах. Импорт, Edit Geometry и назначения из библиотеки остаются в диалоге до **OK**. **Cancel** отбрасывает их без пересчёта симуляции.

Параметры симуляции в **Options**, **Tool Library**, **WCS** и **Stock** применяются после **OK**. Редактирование параметров, просмотр профилей поворотной кинематики и возврат к автоматическим границам не пересоздают 3D фрезерную или 2D токарную заготовку. **Cancel** сохраняет текущую симуляцию; **OK** без изменения её параметров не запускает пересчёт. Изменения пользовательских профилей во вкладке Options также применяются только после **OK** внешнего окна. Выбор активной кинематики через меню Настройки применяется сразу.

Сначала операция определяет тип инструмента для запасного варианта. Затем совпадающий номер T в соответствующей Saved Library предоставляет фактическую геометрию, включая сохранённые тип и размеры. Если подходящей корректной записи нет, discovery использует размеры из комментариев программы и дефолт по типу операции. Для фрезерования `T02` соответствует `T2`; для точения `T202` соответствует `T0202`, а разные упакованные номера коррекции остаются отдельными. Ручные изменения Current Program сохраняют приоритет при последующих пересчётах.

**Saved Library** является постоянной и фиксируется в `tools.db` только при принятии окна Tool Library.

В пустую УП импортировать инструменты нельзя: импорт обновляет слоты инструментов, уже найденные в исходном коде. Сначала напишите выбор/смену инструмента с номером из JSON, например `T1 M6` для фрезерования FANUC или `T0101` для точения FANUC. Обновите анализ программы или заново откройте Current Program, чтобы инструмент появился в списке, затем импортируйте файл. Для успешного импорта должен совпасть хотя бы один номер инструмента.

### Записывает ли открытие программы обнаруженные инструменты в базу данных?

Нет. Обнаружение инструментов является временным.

### Как представлены номера токарных инструментов?

Токарные выборы сохраняют упакованную форму инструмента/смещения, такую как:

```text
T0909
```

Фрезерные выборы используют номер инструмента, например `T03` становится ключом инструмента `T3`.

### Могут ли комментарии описывать геометрию инструмента?

Да. Обнаружение инструментов распознаёт полезные встроенные и близлежащие комментарии, например:

```text
(T3 D=6. CR=0. - FLAT END MILL)
(OD ROUGH R0.8)
(ID ROUGH R0.8)
(GROOVE H4)
(DRILL)
(TAP)
(THREAD)
(BALL)
(FACE MILL)
(CHAMFER)
```

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

### Что происходит, когда нет явного указания типа?

Контекст операции даёт практическое временное значение по умолчанию, где возможно:

- фрезерование G81-G83 -> сверло;
- фрезерование G84 -> метчик;
- нативные SINUMERIK CYCLE81/CYCLE82/CYCLE83 -> сверло;
- нативный SINUMERIK CYCLE84 -> метчик;
- точение G32/G33/G76/G92 -> резьбовой инструмент;
- иначе стандартная фрезерная или токарная резервная геометрия.

Нативные циклы классифицируются по AST контроллера с учётом модального MCALL, его отмены и смены инструмента. Названия циклов в комментариях или тексте MSG не определяют операцию. Тип операции имеет приоритет над противоречащей подсказкой типа в комментарии; автоматически найденный сохранённый инструмент сохраняет свою геометрию. Предварительное сканирование не исполняет макросы и не выводит физические размеры резца из траектории. В CLI/API снимок библиотеки можно передать через `execute_program(..., library_tools=...)`; исполнение не загружает локальную SQLite-библиотеку неявно.

Общее исполнение GUI/CLI строит Program/AST один раз, по тому же объекту подбирает инструменты до исполнения движений и затем рассчитывает траекторию. Discovery не запускает повторный проход frontend. Сканер Cython/Python по-прежнему извлекает комментарии и явно заданные номера инструментов; он не исполняет операции контроллера самостоятельно.

Найденный сохранённый инструмент или назначенный дефолт не гарантирует подтверждённую компенсацию. `UNVERIFIED` означает неподтверждённую компенсированную траекторию, а не просто неизвестный инструмент. G41/G42 может оставаться неподтверждённым при отсутствии геометрии, неподдерживаемом инструменте или некорректном входе/траектории, в том числе для именованных инструментов SINUMERIK без соответствующей числовой геометрии. Дефолты по типу операции существовали и до автоматического поиска в библиотеке.

### Распознаются ли выражения T с Macro B как явно заданные инструменты?

Нет. При обнаружении инструментов `T#1` и `T[expr]` намеренно не вычисляются. Обнаружение явно заданных инструментов и полное выполнение программы ЧПУ — разные задачи.

### Какие геометрии токарных инструментов хранятся?

Токарная библиотека использует девять канонических типов геометрии:

- Ромб 80;
- Ромб 35;
- Квадрат;
- Круг;
- Треугольник;
- Канавка;
- Резьба;
- Сверло;
- Метчик.

OD, ID и Face — это фильтры UI для доступных ориентаций трассировки, а не разные классы геометрии. Они не выбирают сторону съёма материала и не меняют результат Stock Removal при одинаковой траектории и физической геометрии.

### Какие фрезерные инструменты можно предварительно просмотреть?

Модель фрезерного инструмента включает плоские, радиусные, сферические, конические сферические, торцевые, дисковые и фасковые фрезы, свёрла и метчики.

### Как задаются длины фрезерного инструмента?

Фрезерный редактор сохраняет две длины в миллиметрах:

- `fluteLength` — длина режущей части от кончика; должна быть больше нуля.
- `bodyLength` — длина нережущей части от окончания режущей части до оправки; может быть нулевой.

Длина до оправки равна `fluteLength + bodyLength` и доступна в редакторе только для чтения. Поле совместимости `length` вычисляется из этой суммы; отдельного `shaftLength` нет. Переключатель Inches меняет отображение; SQLite и экспорт JSON/CSV сохраняют миллиметры.

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

В библиотеке режущая часть показана золотистым цветом, нережущая — серым. В 3D режущая часть по умолчанию жёлтая; тело почти белое в тёмной теме и тёмно-серое в светлой, чтобы отличаться от серых STL-моделей. Настройка цвета инструмента меняет только режущую часть. Инструменты без явно заданного разделения длин отображаются одним цветом.

Старые инструменты с одной `length` сохраняют общую длину и прежний вид без выдуманного разделения. Редактор отмечает такие записи как старые. Изменение прочих полей сохраняет неразделённую запись; ввод длин режущей и нережущей частей задаёт новую модель. Чтение библиотеки не переписывает базу данных.

Обе длины можно указать в комментарии, например `(FLAT END MILL D10 FL25 BL15)`. Размеры комментария учитывают единицы при выборе инструмента. Комментарий только с `L`/`LENGTH` сохраняет общую длину без разделения. При автоматическом обнаружении без указанных длин используются редактируемые значения по умолчанию, а не измеренные размеры.

### Загружает ли выполнение CLI сохранённую библиотеку GUI?

Нет. Запуски CLI используют то же временное обнаружение инструментов на основе исходного кода, что и только что открытая программа. Ручные назначения Current Program GUI и Saved Library не загружаются молча в выполнение CLI.

Это важно для проверки G41/G42: выведенные размеры инструмента нужно проверить, прежде чем полагаться на рассчитанную CLI траекторию с компенсацией.

---

## Интерфейс, редактор и воспроизведение

### Какие две основные панели GUI?

Левая сторона — редактор QScintilla с подсветкой синтаксиса, номерами строк, поиском/заменой и функциями очистки. Правая сторона — представление траектории OpenGL с осями, сеткой, управлением камерой, выбором траектории и воспроизведением.

Фрезерный 3D-вид использует ортографическую CAD-проекцию. При вращении из видов сверху, спереди и слева параллельные линии остаются параллельными, а видимый размер не зависит от глубины.

### Как измерить геометрию в графическом окне?

Выберите **вид сверху (XY)**, **спереди (XZ)**, **слева (YZ)** или **токарный вид**, затем включите **Функции ЧПУ → Измерение**. Щёлкните точку траектории, ребро или грань STL — это начало измерения. При движении мыши отображается синяя линейка; второй щелчок по геометрии фиксирует результат. Следующий щелчок начинает новое измерение. **Сбросить** или **Esc** в графическом окне очищает измерение; закрытие немодального диалога отключает линейку. В свободном 3D-виде измерение недоступно.

Диалог показывает XYZ начальной и конечной точек, разности координат со знаком, расстояние в плоскости текущего вида и полное пространственное расстояние. Строки таблицы: **От**, **До**, **Разность**; столбцы: **X/Y/Z**. Двойной щелчок по ячейке «От» или «До» позволяет ввести координату; разность вычисляется автоматически. **Дюймы** пересчитывает координаты и расстояния, не перемещая физические точки и не меняя единицы приложения. В токарном виде **X (D)** и разность X отображаются в диаметрах; оба расстояния считаются в физических радиусных координатах. Щелчки линейки не меняют курсор редактора и положение ползунка воспроизведения. Ctrl с перетаскиванием сохраняет панорамирование; масштабирование также доступно.

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

Выбор на STL использует отображаемые преобразованные грани, включая прозрачные объекты и активные сечения. Скрытые объекты исключаются. Измерения траектории соответствуют её отображаемому разбиению, а измерения mesh заготовки ограничены разрешением симуляции.

### Как вставить рассчитанную заготовку в «Объекты STL»?

Приостановите трёхосевой **съём материала** в нужной позиции ползунка. В контекстном меню графического окна выберите **Вставить mesh в графическое окно**. Перед вставкой дождитесь отображения выбранного кадра заготовки. Приложение считывает рассчитанное состояние GPU и создаёт независимый mesh в памяти без сохранения и повторного открытия STL-файла.

Новый **Снимок заготовки** появляется в **Объектах STL** в исходных физических координатах программы. Дальнейшее воспроизведение его не меняет. Доступны обычные преобразования, сечения и измерения; после выхода из съёма материала объект остаётся в графическом окне. Построение можно отменить. Оно сохраняет разрешение рассчитанной поверхности и отклоняет mesh, превышающий предел графического окна в два миллиона треугольников.

### Как импортированный STL влияет на видимость траектории?

В режиме сплошного тела поверхность STL скрывает сегменты траектории за ней. Каркас рёбер не имеет сплошной поверхности, чтобы заслонить эти сегменты. Это меняет только видимость на графике, а не рассчитанную геометрию траектории. Управляйте моделями через **Вид → Объекты STL**; преобразования, сечения, выбор точек и измерения описаны в следующем разделе.

### Как работать с панелью «Объекты STL»?

Панель **Вид → Объекты STL** изменяет импортированные объекты сцены STL, не меняя программу G-code. Импортируйте модель командой **Файл → Импорт STL**. В списке панели отображаются загруженные модели; выберите строку, чтобы применить к ней операцию. В списке операций доступны **Базовая точка**, **Положение**, **Преобразование**, **Круговой массив**, **Прямоугольный массив** и **Сечение**. Четыре компактные кнопки сверху управляют отменой, повтором, статистикой и удалением объектов STL.

#### Как импортировать и выбирать модели STL?

Используйте **Файл → Импорт STL**, чтобы загрузить ASCII- или бинарную сетку. Команда **Файл → Недавние STL** повторно открывает недавно использованную модель. Каждый импорт добавляется отдельной строкой в панели; выбранная строка становится целью операций и источником статистики. **Удалить** убирает только выбранную модель. **Файл → Очистить STL** удаляет все модели STL. Эти команды меняют объекты сцены, но не текст редактора и не траекторию G-code.

#### Что делают «Отменить», «Повторить», «Статистика» и «Удалить»?

История **Отменить** и **Повторить** для STL независима от истории текста редактора. Она сохраняет такие действия сцены, как добавление модели, смена базовой точки, перемещение, вращение, отражение, масштабирование, создание массивов, применение или очистка сечения и удаление объекта. Первая импортированная модель задаёт исходное состояние, поэтому отмена не закрывает панель и не удаляет эту первую модель. **Статистика** открывает копируемые измерения выбранного объекта. **Удалить** убирает только выбранную строку; для очистки всей STL-сцены используйте **Файл → Очистить STL**.

#### Как работают базовая точка STL и выбор углов параллелепипеда?

Список **Базовая точка** задаёт точку, вокруг которой выполняются вращение, отражение и масштабирование:

- **Центр** помещает её в центр ограничивающего параллелепипеда исходной сетки.
- **Угол габаритов** задаёт минимальные X, Y и Z исходной сетки и показывает габаритный параллелепипед преобразованного объекта цветом базовой точки.
- **Начало координат** задаёт точку `(0, 0, 0)` координат модели.
- **Пользовательская** включает поля X/Y/Z; введите координаты модели и нажмите **Задать базовую точку**.

У отображаемого параллелепипеда есть восемь угловых точек для выбора. Удерживайте **Shift** и щёлкните левой кнопкой мыши по углу в 3D-графике, чтобы переместить туда базовую точку. Выбранная точка становится крупнее и подсвечивается голубым; остальные семь остаются цветом базовой точки. После выбора режим становится пользовательским, а параллелепипед остаётся видимым, чтобы можно было выбрать другой угол. Выбор Центра или Начала координат выключает режим выбора углов.

На странице **Положение** отображается положение базовой точки в мировых координатах. Введите целевые X/Y/Z и нажмите **Переместить сюда**, чтобы поместить её в эти координаты. Перемещение меняет матрицу объекта, сохраняя форму модели.

#### Как задавать положение и преобразовывать модель STL?

На странице **Преобразование** выберите ось и угол вращения вокруг текущей базовой точки. **Отражение** зеркально отражает объект относительно плоскости, нормаль которой направлена вдоль выбранной оси X, Y или Z и проходит через базовую точку. **Масштабирование** применяет одинаковый коэффициент по всем осям относительно этой точки. Исходная STL-сетка сохраняется, меняется только преобразование объекта в сцене; файл на диске не перезаписывается.

#### Как работают массивы STL?

**Круговой массив** создаёт заданное число копий вокруг выбранной оси и центра на указанном общем угле. Нажмите **Создать**, чтобы построить массив. Если включён флажок **Вращать копии**, каждая копия поворачивается вместе со своим положением. Если флажок выключен, копии сохраняют ориентацию, а базовые точки размещаются по окружности. Для полного оборота 360° копии распределяются равномерно без дублирования первой копии в конце.

**Прямоугольный массив** создаёт копии вдоль X, Y и Z. Задайте количество копий и шаг для каждой оси, затем нажмите **Создать**. Исходный объект входит в массив. Создание массива считается одним действием истории STL и отменяется одной командой.

Создание массива отклоняется, если итоговая сцена превысит **1 000 объектов** или **2 000 000 треугольников**, включая уже находящиеся в ней объекты. Проверка выполняется до построения копий; при отказе сцена и история отмены не меняются.

#### Как выполнить 3D-сечение модели STL?

На странице **Сечение** выберите ось X, Y или Z, координату плоскости и сторону, которую нужно оставить. Изначально координата равна середине ограничивающего параллелепипеда выбранной модели в мировых координатах. Кнопка **Применить** обрезает сплошную модель в 3D и закрывает срез там, где сетка образует замкнутый контур; результат остаётся видим поверх исходной траектории. Кнопка **Очистить** возвращает целую STL-модель. Применение и очистка сечения отменяются через историю STL.

#### Что показывает статистика STL и как включить дюймы?

**Статистика** показывает площадь поверхности, объём, центр масс, мировые координаты границ и длины по каждой оси. Границы записываются явно как `Xmin`, `Xmax` и `Length`, а также аналогично для Y и Z. Флажок **Inches** в левом нижнем углу окна пересчитывает все длины, координаты, площадь и объём, не меняя модель. Без флажка значения отображаются в миллиметрах; с флажком — в дюймах, квадратных и кубических дюймах.

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

### Как изменить регистр букв или пометить необязательные блоки?

Используйте **Правка → В верхний регистр** (`Ctrl+Shift+U`) или **Правка → В нижний регистр** (`Ctrl+U`), либо соответствующие кнопки панели инструментов, чтобы преобразовать выделенный текст. Без выделения они преобразуют весь документ редактора. Их сочетания клавиш можно изменить в параметрах.

Выберите один или несколько блоков и нажмите **Ctrl+/**, чтобы добавить `/` в начало каждого выделенного непустого блока. Нажмите **Ctrl+Shift+/**, чтобы удалить один ведущий `/` из каждого выделенного блока. Без выделения эти команды ничего не делают. Оба сочетания клавиш фиксированы и не могут быть назначены другой команде. Косая черта — это маркер пропуска необязательного блока FANUC; выполняются ли такие блоки, зависит от настройки пропуска блоков.

Команда редактора **Перенумерация** добавляет или заменяет номера кадров в выделенных строках, а без выделения — во всём документе. Она пропускает разделители `%`, заголовки программ `O` и строки переменных соответствующего диалекта: `#` для FANUC, `R` для SINUMERIK и `Q` для iTNC. Ссылки переходов и границы контуров остаются без изменений; их наличие не блокирует команду. **Удалить номера** удаляет префиксы кадров без отказа и без изменения ссылок, сохраняет маркеры `/` и учитывает отступы и строчный префикс `n`. Числовые префиксы кадров Klartext обрабатываются отдельно от меток `LBL`.

### Как распечатать график?

Используйте **Файл → Печать** (`Ctrl+P`) или включите кнопку «Печать» через «Настроить панели». Приложение печатает чёткие векторные линии в текущей ориентации камеры, вписанные в альбомную страницу. Печать игнорирует ползунок воспроизведения и не скрывает линии за импортированным STL. В **Настройки → Параметры → График** можно показывать или скрывать ускоренные перемещения, отображать их пунктирными или сплошными и раскрашивать все перемещения по инструменту; печать следует этим настройкам. **FAQ** открывается по `F3`, а **Сетка** по умолчанию переключается по `F4`.

### Какие фиксированные виды доступны?

Top, Front и Left — ортогональные виды. Фрезерный ISO/3D-вид также использует параллельную проекцию, которая сохраняется при свободном вращении.

**Вид → Повернуть вид** поворачивает текущий фиксированный фрезерный вид вокруг оси модели X, Y или Z через текущий центр обзора. Укажите угол со знаком (по умолчанию 90°) и ось модели. Положительное направление определяется правилом правой руки. Повороты накапливаются; центр камеры, масштаб и рассчитанная траектория сохраняются, повторный расчёт УП не выполняется. Например, поворот Top на 180° вокруг X даёт вид снизу; поворот Front или Left на 180° вокруг Z даёт вид сзади или справа соответственно.

Та же команда с иконкой доступна в контекстном меню графика, панели «Вид», настройке горячих клавиш и настройке состава панелей. Сохранённый состав панелей учитывается; при необходимости включите кнопку в настройке панелей. Для ISO/3D и токарного режима команда недоступна. Кнопки Top/Front/Left восстанавливают стандартную ориентацию. Каждый документ MDI сохраняет свою повёрнутую камеру.

Если камера после поворота смотрит перпендикулярно XY, XZ или YZ, сетка и линейка используют эту фактическую плоскость. При произвольном наклоне плоская сетка и измерение отключаются до возвращения к координатной плоскости. Выбор движений траектории остаётся доступен. Поворот камеры не преобразует координаты программы, заготовку, объекты STL или кинематику станка.

### Как воспроизведение связано с ядром?

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

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

Во время воспроизведения кнопка Play показывает значок Pause. Повторное нажатие ставит воспроизведение на паузу; остановка или завершение возвращает значок Play.

### Что делают Step Backward и Step Forward?

Они перемещаются на одно логическое движение, включая сгенерированные движения из циклов и выполнения, раскрытого Macro B.

### Почему многие движения воспроизведения могут соответствовать одной строке исходного кода?

Один исходный блок может выдать много движений. Примеры включают:

- циклы точения;
- циклы фрезерования;
- циклы Macro B, которые выполняют одну и ту же строку исходного кода повторно;
- геометрию компенсированных переходов.

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

### Как настроить кнопки панелей инструментов?

Выберите **Настроить панели** по ПКМ на панели. Отметьте нужные кнопки; поиск фильтрует список, сохраняя выбор. **OK** применяет и сохраняет настройки, **Отмена** отбрасывает изменения, **Восстановить по умолчанию** подготавливает компактный исходный набор. Контекстное меню также позволяет скрыть целую панель или восстановить расположение и кнопки. Меню и горячие клавиши работают и без кнопки на панели. Доступны статические CNC Functions, библиотека инструментов, WCS, заготовка и Tokens/Variables; Recent Files и списки профилей кинематики остаются в меню. Виджеты типа исходника и скорости воспроизведения сохраняются.

Набор 2.6.0 включает сгруппированные операции с файлами, undo/redo/поиск, управление видом, навигацию по сменам инструмента, Compare/статистику/измерение и воспроизведение. Кнопки буфера обмена, смены регистра, очистки текста, «Сохранить как», печати, экспорта списка инструментов, сниппетов и калькуляторов включаются по желанию. Сохранённый набор пользователя действует до явного восстановления значений по умолчанию.

### Как найти отображённое движение в редакторе?

Используйте Shift+ЛКМ рядом с линией или дугой траектории, в том числе во фрезерном 3D-виде. Приложение выбирает исходный кадр и перемещает ползунок к соответствующему исполненному движению. При наложении сегментов в 3D учитывается глубина относительно камеры; скрытые ускоренные перемещения не выбираются.

**Настройки → Параметры → Общие → Cimco Like Picking** по умолчанию выключен. Включите его для выбора обычным кликом ЛКМ и перемещения сцены перетаскиванием ПКМ во фрезерных видах. Клик ПКМ без перетаскивания открывает контекстное меню; после перетаскивания меню не появляется. При выключенной настройке перетаскивание ЛКМ перемещает сцену, Shift+ЛКМ выбирает движение. Вращение средней кнопкой и масштабирование колёсиком сохраняются. Настройка применяется по OK, Отмена отбрасывает изменение. Управление токарным видом не меняется.

### Перемещает ли автоматическое обновление курсор редактора?

Обычное обновление выполнения/графика предназначено для обновления результата без использования перемещения курсора редактора как побочного эффекта. Воспроизведение/навигация могут намеренно выбирать местоположения исходного кода.

### Что происходит, когда Auto Update слишком дорого?

Auto Update имеет лимит выборочных сегментов. Большие правки могут оставаться в ожидании до явного Refresh, чтобы набор текста оставался отзывчивым.

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

В **Настройки → Параметры** также доступны допуск дуг, пресет их дискретизации, максимальный/минимальный радиус окружности и минимальная длина хорды. Параметры дискретизации меняют представление траектории в GUI, не изменяя рассчитанную геометрию ЧПУ. Общие настройки включают предел числа генерируемых движений, порог сегментов для автообновления и размер значков панели инструментов. Явный Refresh можно отменить.

### Что останавливает Cancel?

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

### Какие помощники редактирования ЧПУ включены?

GUI содержит:

- Hole Calculator;
- Pocket Calculator;
- Snippets.

Hole и Pocket Calculator только для фрезерования. Snippets доступны в обоих режимах станка.

### Что генерирует Hole Calculator?

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

Предпросмотр и генерируемый фрагмент ограничены **20 000 точек**; для сетки проверяется произведение количеств по X и Y. При превышении лимита предпросмотр очищается, а кнопка **Вставить** отключается с пояснением во всплывающей подсказке. Уменьшите количество отверстий, чтобы продолжить. Если выделения нет, вставка при каретке внутри существующего кадра помещает фрагмент перед всем этим кадром, сохраняя его команды.

### Что генерирует Pocket Calculator?

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

Сгенерированный фрагмент — отправная точка, а не сертификация безопасности станка.

### Где хранятся сниппеты?

В Windows библиотека SQLite обычно находится здесь:

```text
%LOCALAPPDATA%\easy-gcode-plot\snippets.db
```

Комбо **Стойка (Controller)** разделяет **Fanuc**, **Sinumerik**, **Heidenhain**, **Fanuc Lathe** и **Sinumerik Lathe**. У каждого пространства свои имена, тексты и порядок записей. При открытии выбираются стойка и режим станка активного документа; смена стойки в диалоге меняет только список сниппетов. Перед переключением записи/стойки или закрытием менеджера несохранённые изменения текста и картинки можно сохранить, отбросить либо оставить, отменив действие.

В каждом пространстве есть **Program Start**, **Toolchange**, **Toolchange (Drill)**, **Program End**, **Retract Home Z**, **Comment**, **Rapid Move**, **Linear Move**, **Circular Move** и **Drilling**. Для токарки также предусмотрены черновая обработка G71/CYCLE95 и резьба G76/CYCLE97. Примеры Fanuc Lathe рассчитаны на систему G-кодов A и диаметральные координаты X.

Для фрезеровки также доступны FANUC G73/G74/G76/G81–G87/G89, SINUMERIK CYCLE81/82/84–87/89/90, HOLES1/2 и POCKET3/4, HEIDENHAIN 200–209, 220/221, 240/241, 251/252 и 262. Координаты и числовые Q-параметры HEIDENHAIN сохраняют явные знаки `+`/`-`. Схемы 220/221 требуют ранее определённого цикла обработки, карманы и резьбофрезерование — заданной геометрии фрезы. В шаблонах POCKET3/4 доступны VARI=1/2/11/12; для остальных стратегий входа нужны дополнительные параметры. CYCLE84 использует введённые SST для резания и выхода в соответствии с поддерживаемым в проекте подмножеством цикла.

**Toolchange** запрашивает номер инструмента, корректор, обороты/направление шпинделя и координаты отвода. Вставляемый комментарий содержит тип и диаметр фрезы, а для токарки — тип инструмента, обозначение пластины и радиус вершины. HEIDENHAIN использует выбранную запись таблицы инструментов. В отдельном **Toolchange (Drill)** вводятся диаметр и угол заточки сверла, без полей пластины. Координаты, подачи и параметры циклов также вводятся в отдельных полях: проверяются числовые диапазоны, целые значения, допустимые варианты и зависимые ограничения. Составной P цикла G76 разделён на три двухзначных поля: число чистовых проходов, выход из резьбы и угол инструмента.

Единицы, систему координат, инструмент и начальную позицию задайте в окружающей программе. Для FANUC используются фрезерный G83 и осевой токарный G74. Фрезерный SINUMERIK использует **MCALL CYCLE83**: после него нужны кадры позиций отверстий, затем отмена **MCALL**. Токарный SINUMERIK использует CYCLE83, HEIDENHAIN — CYCL DEF 203 и CYCL CALL. Для G71/CYCLE95 нужен существующий контур. По умолчанию в сверлении SINUMERIK заданы DAM=0 и VARI=1, в HEIDENHAIN Q208=500. Circular Move задаёт конечную точку, радиус и подачу относительно подходящей начальной позиции; дополнительных отводов в нём нет.

Исходный текст редактируется прямо в компактном менеджере. Кнопка **Вставить (Insert)** открывает форму параметров с полями ввода, прикреплённой картинкой при её наличии и кнопками OK/Cancel. Текстового предпросмотра и вкладки Preview нет. При неверном вводе OK недоступна; отмена ничего не вставляет. Готовая вставка отменяется одним действием редактора, менеджер Snippets остаётся открытым. Шаблоны без полей ввода вставляются сразу. Боковая панель **Вид → Сниппеты** позволяет выбирать группы и искать шаблоны по имени, используя тот же механизм вставки.

| Литерал | Результат |
| --- | --- |
| `{{?D=10}}` | Поле D со значением 10; `{{?Name}}` требует ввода |
| `{{?D=10\|number\|gt=0}}` | Положительный числовой диаметр |
| `{{?Tool=1\|int\|min=0}}` | Целый неотрицательный номер инструмента |
| `{{?ReturnMode=98\|int\|choices=98,99}}` | Комбо с допустимыми вариантами |
| `{{?RPM=\|int\|optional\|min=1\|prefix=S}}` | Необязательные положительные обороты; при пустом поле адрес S не выводится |
| `{{?Z=-20\|number\|lt=ReturnZ}}` | Проверка ограничения относительно другого параметра |
| `{{D}}` | Повторное использование значения без второго поля |
| `{{?X=10:+\|number}}`, `{{X:+}}` | Явный плюс для неотрицательных значений, как в Klartext |
| `{{=1000*Vc/(PI*D):0}}` | Обороты без дробной части |
| `{{=(D/2)/TAN(Angle/2):4}}` | Высота вершины сверла с четырьмя знаками после запятой |
| `{{=TO_INCH(D):4}}`, `{{=TO_MM(Inches):3}}` | Миллиметры в дюймы или дюймы в миллиметры |
| `{{date}}`, `{{time}}`, `{{datetime}}` | Локальные дата и время из одного момента при вставке |
| `{{date:DD.MM.YYYY}}`, `{{time:HH:mm}}` | Форматированные дата и время |
| `{{file.name}}`, `{{file.stem}}` | Имя сохранённого документа с расширением или без |
| `{{file.path}}`, `{{file.dir}}` | Абсолютный путь файла или папки; файл должен существовать |
| `{{selection}}`, `{{cursor}}` | Выделенный текст; положение курсора после вставки |

Свойства поля разделяются символом `|`. Типы: `text`, `number`, `int`, `contour` (метки НАЧАЛО:КОНЕЦ). `min`/`max` включают границу, `gt`/`lt` задают строгое ограничение; в границах можно ссылаться на другие числовые поля. `optional` разрешает пустое значение, `oneof=Other` требует альтернативу при пустом поле, `width=2` дополняет целое число нулями, `prefix`/`suffix` выводятся только с непустым значением. Перед типом можно указать подпись поля.

Поддерживаются `+ - * / % ^`, скобки и `PI`. Функции: `SIN`, `COS`, `TAN`, `ASIN`, `ACOS`, `ATAN`, `ATAN2(y,x)`, `ABS`, `SQRT`, `ROUND`, `MIN`, `MAX`, `TO_MM`, `TO_INCH`, `TO_RAD`, `TO_DEG`. Тригонометрия использует градусы. Суффиксы `:0`–`:12` задают число знаков в выводе; промежуточные вычисления сохраняют точность. Числовые поля принимают десятичную запятую, а в УП вставляется точка. Переменные FANUC `#`, SINUMERIK `R` и HEIDENHAIN `Q` сохраняют обычный синтаксис своего языка.

У каждой стойки есть **Spindle speed (formula)** — обороты, **Drill point (formula)** — высота вершины сверла, отдельные **MM to INCHES** и **INCHES to MM**, **Trigonometry (formula)** — тригонометрия, **Document header** — реквизиты файла. В каждой конвертации ровно одно поле ввода. Формулы подставляют результат в текст сниппета; конвертации выводят комментарии.

В менеджере меню **Картинка (Picture) → Загрузить / Вставить из буфера / Удалить** добавляет, заменяет или удаляет PNG/JPEG/BMP/WebP/SVG у выбранного сниппета. **Сохранить** записывает текст и картинку вместе; редактирование только текста не стирает изображение. Подпись рядом показывает наличие картинки и несохранённое изменение. Ограничения: 10 МБ и 4096 × 4096 пикселей. В Insert изображение доступно только для чтения, с увеличением по нажатию и масштабированием; при отсутствии картинки её область скрыта. Редактирования и drag-and-drop изображений в Insert нет. Картинки хранятся в SQLite и не вставляются в УП. У Rapid, Linear, Circular Move и Drill point есть штатные схемы; для токарных движений — отдельные X/Z.

Стандартные тексты находятся в `app/gcode/snippet_defaults.py`, примеры формул — в `app/gcode/snippet_examples.py`. Новая библиотека заполняется один раз; повторное открытие не заменяет тексты и не восстанавливает удалённые записи автоматически. **Обновить стандартные (Update Defaults)** восстанавливает **все стандартные сниппеты выбранной стойки**, включая удалённые, и добавляет недостающие штатные картинки. Изменённые стандартные тексты заменяются: личный вариант предварительно сохраните под другим именем. Пользовательские имена, порядок/ID существующих записей и прикреплённые картинки сохраняются; другие стойки не затрагиваются. Кнопка неактивна, когда все стандартные тексты и штатные картинки на месте и актуальны. Удаление сниппета удаляет его картинку; восстановление стандартного сниппета возвращает штатную схему, но не ранее удалённое пользовательское изображение. Резервная копия `snippets.db` сохраняет все пять пространств с картинками.

Сохраняется однократный импорт прежних текстовых файлов без удаления оригиналов. Файлы с некорректным UTF-8 пропускаются с предупреждением в журнале; остальные импортируются. Этот импорт не связан с Update Defaults.

---

## Параметры и настройка сцены

### Как скрыть инструмент на графике?

Включите **Настройки → Параметры → График → Скрыть инструмент (Hide Tool)**. По умолчанию флажок выключен и влияет только на обычный график; в симуляции Stock Removal инструмент остаётся видимым.

### Где прочитать ошибки и предупреждения выполнения?

В статусной строке показан один компактный счётчик диагностики, например **Warnings: 2** или **Errors: 1**. Наведите на него курсор, чтобы прочитать полные сообщения с номерами строк исходного кода; диагностика также доступна в **Tokens**. Одинаковые сообщения для разных строк остаются отдельными записями. **READY**, **UPDATING** и **STALE** обозначают состояние расчёта. Длинные временные уведомления сокращаются многоточием с учётом доступного места; полный текст показывается при наведении на статусную строку. Изменение размера окна не продлевает время показа уведомления.

### Как изменить цвет подсветки текущей строки?

Откройте **Настройки → Параметры → Цвета** (**Настройки → Параметры → Цвета**). В группе **Редактор** отдельно задаются цвета текущей строки для светлой и тёмной тем: по умолчанию `#e8e8ff` и `#2a2d2e`. Нажмите кнопку с образцом цвета, чтобы открыть системный выбор цвета, либо введите `#RRGGBB`, затем нажмите **OK**. Оба цвета сохраняются независимо; смена темы или типа файла редактора не сбрасывает выбранные значения. **Отмена** сохраняет прежние настройки, а **Восстановить значения по умолчанию** сбрасывает оба цвета. В отдельной группе **График** находятся цвета траектории, инструмента, фона и STL.

Включение и отключение подсветки остаётся во вкладке **Настройки → Параметры → Редактор → Подсвечивать текущую строку** (**Настройки → Параметры → Редактор → Подсвечивать текущую строку**).

### Как изменить язык интерфейса?

Откройте **Настройки → Параметры → Общие** (**Настройки → Параметры → Общие**). В поле **Язык** выберите **Английский** или **Русский** и нажмите **OK**. Перезапустите Easy G-Code Plot: смена языка применяется после перезапуска, о чём программа выводит уведомление. Эта настройка меняет язык интерфейса, а не диалект ЧПУ для выполнения управляющей программы.

### Как изменить тему?

Откройте **Настройки → Параметры → Общие**, выберите **Светлая** или **Тёмная** в поле **Тема** и нажмите **OK**. Тема применяется сразу, без перезапуска. Выбранные язык и тема сохраняются в конфигурации приложения.

### Где задать рабочие системы координат и значения возврата домой?

Откройте **Настройки → WCS** (**Настройки → WCS**). Это отдельный диалог, а не вкладка «Параметров».

| Настройка | Как использовать |
| --- | --- |
| G54–G59 | Введите смещения X/Y/Z для каждой системы. Активную систему выбирает команда G54–G59 в УП; изменение строки диалога не добавляет эту команду в программу. |
| Home (G28) | Задайте координаты опорной точки возврата и отметьте, настроена ли она. Эти значения используются при расчёте возврата G28. |
| X/Z при точении | Поля X задаются в диаметрах; поля Y отключены. Z задаёт осевую координату. |
| X/Y/Z при фрезеровании | Доступны все три координаты; X задаётся как линейная координата. |
| Дюймы | Переключает отображение и ввод длин между миллиметрами и дюймами. Существующие физические значения пересчитываются, а не принимаются за значения в другой единице. |

Нажмите **OK**, чтобы применить значения и пересчитать программу. **Отмена** оставляет сохранённые значения без изменений. Для расширенных смещений G54.1 в этом диалоге нет полей; они остаются нулевыми, пока их не зададут поддерживаемые команды УП, например G10 L20.

### Как задать размеры токарной заготовки?

В режиме точения откройте **Настройки → Заготовка** (**Настройки → Заготовка**). Перед запуском снятия материала задайте размеры исходной заготовки.

| Поле | Назначение |
| --- | --- |
| Наружный диаметр | Исходный наружный диаметр заготовки. |
| Внутренний диаметр | Диаметр исходного отверстия; для сплошной заготовки задайте ноль. |
| Длина | Осевая длина заготовки. |
| Z переднего торца заготовки (Stock front Z) | Абсолютная координата Z переднего торца. Задний торец расположен в `Z переднего торца − длина`; поле задаёт координату, а не только толщину припуска. |
| Точность | Разрешение модели заготовки. Более высокая точность даёт более подробную модель и увеличивает время расчёта. |
| Дюймы | Отображение и ввод размеров в дюймах вместо миллиметров с сохранением физического размера. |
| Запуск снятия материала при нажатии Play | Включает воспроизведение снятия материала при нажатии Play. |
| Сброс к авто (Reset to Auto) | Возвращает размеры, рассчитанные по траектории резания текущей программы. |

Нажмите **OK**, чтобы применить ручные размеры; **Отмена** отменяет изменения в диалоге. Ручные размеры действуют до **Сброса к авто**, создания новой или открытия другой программы. Для снятия материала нужна рассчитанная полная токарная программа и настроенная геометрия инструмента. Автоматический расчёт размеров и поддерживаемые инструменты описаны в разделе [Удаление материала при точении](#удаление-материала-при-точении).

### Есть ли снятие материала при фрезеровании?

Да. **Трёхмерный фрезерный съём на GPU — основная новая возможность версии 2.0.0.** Симулятор показывает оставшийся материал на разных этапах трёхосевой обработки и сохраняет текущее состояние в STL. Ниже приведено [руководство по фрезерному съёму](#снятие-материала-при-фрезеровании). Токарный симулятор работает отдельно.

---

## Снятие материала при фрезеровании

### Как запустить фрезерную симуляцию?

1. Откройте трёхосевую фрезерную программу и успешно рассчитайте её до завершения.
2. Проверьте **Tool Library / Current Program**. Назначьте реальные типы и размеры фрез: от этой геометрии зависит форма съёма.
3. Откройте **Настройки → Заготовка** (**Настройки → Заготовка**), выберите фрезерную вкладку, задайте размеры и **Accuracy**.
4. Подтвердите настройки и включите **Stock Removal** на панели инструментов. Используйте Play/Pause, пошаговое движение и ползунок для просмотра разных стадий обработки.
5. Поверните сцену для осмотра обработанной поверхности, боковин и дна. При необходимости сохраните текущее состояние командой **Save stock as STL** в контекстном меню графика.

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

### Как задаются границы и припуск заготовки?

Начальная заготовка — прямоугольный параллелепипед. Автоматический расчёт учитывает границы режущих движений, радиус фрезы и припуск; верх заготовки находится на Z0 выбранной WCS. Нижняя граница Z проходит ниже режущей траектории. Припуск влияет на автоматический подбор границ, но сам по себе не добавляет материал выше нуля WCS.

Вручную задаются X−/X+, Y−/Y+ и Z−/Z+ относительно начала выбранной WCS. Для торцевания материала выше нуля задайте положительный Z+. Максимум каждой оси должен быть больше минимума. Ручные размеры сохраняются независимо от токарных настроек. **Определить границы автоматически** возвращает диалог к расчёту по траектории. Отображение в дюймах пересчитывает размеры; внутренняя геометрия использует миллиметры.

### Какие фрезы и движения поддерживаются?

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

Симулятор следует рассчитанным трёхосевым линейным, дуговым и спиральным движениям, включая движения поддержанных циклов и макросов. Прямые проходы и дуги XY на постоянной Z обрабатываются аналитически на GPU; остальные криволинейные траектории подготавливаются с выбранным контурным допуском. Быстрый ход через заготовку также удаляет пересечённый материал и отмечает повреждение.

### Что задаёт Accuracy при фрезеровании?

Для текстур GPU установлен **максимум 4 ГиБ**, включая округление размеров до степени двойки и все уровни иерархии. Доступная память GPU и максимальный размер текстуры устройства могут ограничить объём раньше. При нехватке ресурсов появляется предупреждение с причиной, симуляция останавливается; Accuracy сохраняется. Уменьшите заготовку или Accuracy и повторите запуск.

На крутых стенках нормали освещения сглаживаются, а мягкий дополнительный свет подавляет полосы от сетки. Это влияет только на освещение; рассчитанная заготовка, глубина пересечений и экспорт STL не меняются.

Приближение доступно во время воспроизведения. Обход сетки лучом GPU идёт в одном направлении и ограничен её размерами: изменение округления при масштабировании не приводит к повторному обходу общей границы ячеек. Accuracy при этом не снижается.

Ползунок имеет пять фиксированных уровней. Повышение Accuracy делает сетку высот XY мельче и уменьшает допуск подготовки криволинейной траектории. Растут расход памяти GPU и объём вычислений. Уровень сохраняется при любой скорости воспроизведения и размере программы; время кадра его не снижает.

В текущей реализации используются следующие внутренние параметры, в миллиметрах:

| Уровень слева направо | Контурный допуск криволинейной траектории | Параметр ограничения шага сетки |
| --- | ---: | ---: |
| 1 | 0,20 | 0,50 |
| 2 | 0,10 | 0,25 |
| 3 | 0,05 | 0,15 |
| 4 | 0,02 | 0,08 |
| 5 | 0,01 | 0,05 |

Фактический шаг узлов XY не превышает параметр сетки, делённый на √2, и подбирается так, чтобы включить границы заготовки. Это параметры дискретизации, а не сертифицированная граница суммарной погрешности обработки. Между сохранёнными высотами отображаются билинейные участки поверхности. Изменение Accuracy перестраивает заготовку на текущей позиции; более мелкая сетка может показать детали, которые отсутствовали на грубой.

### Как воспроизведение и правка инструмента меняют заготовку?

Play/Pause, пошаговое движение и перемотка используют ту же позицию логического движения, что и отображение инструмента. При движении вперёд новые проходы изменяют существующее состояние GPU-заготовки. Перемотка назад очищает состояние и повторяет нужную часть траектории для восстановления более ранней стадии. Смена детализации также пересчитывает текущую стадию на новом разрешении.

Правка или назначение геометрии инструмента текущей программы перестраивает активную симуляцию с восстановлением позиции воспроизведения. Фоновая подготовка объединяет запросы перемотки и отбрасывает устаревшую работу. Выход из симуляции или закрытие окна отменяет незавершённые фрезерные задания. У точения остаются собственные ядро заготовки и механизм воспроизведения.

### Что показывают цвета и грани заготовки?

В Options отдельно задаются цвета исходного материала и обработанной поверхности. Неснятый материал сохраняет цвет заготовки; обработанный участок получает цвет обработки и освещение по форме поверхности. Съём на быстром ходу отмечается цветом повреждения. Это отображение пересечения с заданной заготовкой, а не проверка столкновений всего станка.

Боковины и дно видны там, где материал остаётся. Сквозной съём не оставляет искусственную крышку снизу. Для осмотра дна поверните сцену. GPU вычисляет нормали интерполированной верхней поверхности, а для внешних граней использует нормали соответствующих плоскостей box-заготовки.

### Как сохранить результат фрезерного съёма в STL?

В активной фрезерной симуляции выберите **Save stock as STL** в контекстном меню графика. Экспорт получает реальное состояние GPU-заготовки на текущей позиции: можно сохранить промежуточную операцию или завершённую обработку. Сначала задайте необходимую Accuracy симуляции.

| Настройка экспорта | Фактическое действие |
| --- | --- |
| Единицы длины | Координаты записываются в миллиметрах или дюймах. |
| Рассчитанная заготовка без уточнения сетки | Включено по умолчанию. Сохраняется отображаемое GPU-состояние без повторного проигрывания и дополнительного дробления. Участки постоянной высоты объединяются точно для уменьшения файла. |
| Максимальная длина ребра | Начальное значение берётся из Accuracy симуляции. Ограничение применяется только при включении дополнительного уточнения сетки. |
| Линейное/угловое отклонение | Линейное отклонение берётся из Accuracy симуляции. Отдельного углового допуска у симуляции нет. Дополнительное уточнение следует полученной билинейной поверхности без повторного расчёта съёма материала. |

Чтение GPU-состояния выполняется в потоке OpenGL-контекста; снимок используется повторно, пока заготовка на GPU не изменилась. Запись сетки работает в отменяемом фоновом задании и заменяет файл назначения только после успешного завершения. Время экспорта зависит от сложности оставшейся поверхности и размера файла; более короткие рёбра сами по себе не восстанавливают детали, отсутствующие в симуляции.

### Как устроено GPU-ядро съёма?

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

Шейдер отображения проходит по этой иерархии, вычисляет пересечения лучей камеры с билинейными участками, их нормали и глубину в сцене. CPU не перестраивает и не загружает треугольную сетку для каждого отображаемого кадра. На CPU остаются исполнение ЧПУ-программы, подготовка инструмента/траектории и запись STL. Фоновый поток готовит неизменяемые кадры траектории; GPU-съём, отображение и чтение состояния выполняются в потоке OpenGL-контекста.

Основные файлы: `app/gcode/stock/milling_stock.py`, `milling_stock_sweep.py`, а также `app/ui/plot/milling_stock_gpu.py`, `milling_stock_shaders.py`, `milling_stock_overlay.py`. Построение треугольников на CPU остаётся для STL-экспорта прочитанного GPU-состояния.

### Каковы требования и ограничения фрезерного съёма?

- Нужны **OpenGL 4.3** и рабочий графический драйвер. CPU-варианта фрезерного съёма нет.
- Модель хранит одну оставшуюся высоту на узел XY над основанием заготовки. Поддержаны вертикальные фрезы и трёхосевая работа; поворотные/TCP-движения, наклонные фрезы и поднутрения не входят в модель.
- Импортированные STL остаются опорной геометрией. Съём работает с заданным параллелепипедом, а не произвольным STL-телом.
- Разрешение ограничено максимальным размером текстуры устройства и доступной памятью GPU. Превышение предела размера текстуры вызывает явную ошибку без скрытого снижения Accuracy.
- Скорость зависит от GPU, размеров заготовки, Accuracy и проходов фрезы. Фиксированный множитель ускорения не заявляется.

Если заготовка расположена неверно, проверьте WCS и шесть границ. Если ширина или форма съёма неправильные — геометрию активного инструмента. При нехватке мелких деталей повысьте Accuracy. При ошибке инициализации OpenGL или размера текстуры проверьте драйвер и выбранные размеры/разрешение заготовки.

---

## Удаление материала при точении

### Что такое Turning Stock Removal?

Это осесимметричный предварительный просмотр удаления материала на основе рассчитанной траектории точения и настроенной геометрии резца.

Это не симуляция станка.

### Как оценивается автоматический припуск?

Рассчитанная траектория резания G1/G2/G3 позволяет определить минимальный наружный диаметр и длину. Выбросы ускоренного хода G0 игнорируются, режущие движения, сгенерированные циклом, включаются, а экстремумы дуг G18 оцениваются аналитически.

### Можно ли переопределить размеры заготовки вручную?

Да. **Настройки → Заготовка** позволяет задать наружный и внутренний диаметры, длину, абсолютную координату Z переднего торца и точность/разрешение. Поля и включение воспроизведения описаны в разделе [Как задать размеры токарной заготовки?](#как-задать-размеры-токарной-заготовки).

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

### Какие инструменты удаляют материал?

Поддерживаемые геометрии токарных инструментов включают девять канонических типов библиотеки инструментов. Stock Removal использует рассчитанную траекторию, ориентацию трассировки и физическую геометрию резца. Флажки OD/ID/Face только фильтруют доступные варианты трассировки в редакторе инструмента; изменение этих фильтров не меняет съём при одинаковой траектории и геометрии резца.

Ограниченный контур перемещения резца удаляет только материал, с которым пересекается. Сохраняются отдельные оставшиеся кольца материала, в том числе наружная стенка при расточке G71. Возврат назад и повторное воспроизведение тех же движений восстанавливают одинаковое сечение заготовки. Для канавок поле **Геометрия канавочного резца** отдельно выбирает радиальную или торцевую геометрию независимо от флажков.

### Как резьбы представлены в Stock Removal?

Синхронизированные режущие движения G32/G33, модального G92 и G76 используют детерминированную модель продольного сечения резьбы, а не развёртывание полного тела пластины как обычного твёрдого тела.

Запрограммированный X определяет глубину впадины, F определяет шаг/ход, а настроенная геометрия резьбы формирует сечение.

Изображение резьбовой пластины — отдельный фиксированный контур, общий для Tool Library и инструмента в Stock Removal: треугольный корпус с тремя маленькими режущими треугольниками 60° и уступами между ними. Активная точка трассировки привязана к запрограммированному положению инструмента. В стандартном токарном виде наружная вершина P8 направлена вниз, внутренняя P6 — вверх.

Контур масштабируется только по диаметру пластины. Исходный контур построен для Ø12; при Ø20 все координаты умножаются на `20 / 12`, примерно 1,667. EX, RC и угол профиля резьбы не деформируют изображение корпуса. Угол остаётся в расчёте съёма, но скрыт в редакторе; в сводке библиотеки показывается ориентация трассировки. Эти изменения отображения не перезаписывают записи инструментов в SQLite.

### Обнаруживает ли Stock Removal столкновения станка?

Токарный CPU Stock Removal проверяет пересечение существующего контура инструмента с оставшимся материалом заготовки на всём пути G0. Пересечённый материал окрашивается красным без удаления. След сохраняется после отхода инструмента, исчезает на участках, удалённых последующей обработкой G1/G2/G3, и восстанавливается при воспроизведении и перемещении ползунка. Уже снятый материал, отверстия и промежутки не отмечаются; касание границы без проникновения игнорируется. Новая симуляция начинается без отметок.

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

---

## Статистика и Tokens/Variables

### Что содержит Toolpath Statistics?

Откройте **Функции ЧПУ → Статистика**. Инспектор находится в **Функции ЧПУ → Токены/Макропеременные**, а не в меню настроек.

Статистика рассчитывается по траектории и включает:

- количество логических движений;
- разбивку по длине;
- известное и неизвестное время обработки;
- среднюю подачу;
- предполагаемую скорость ускоренного хода;
- границы XYZ;
- секции по инструментам.

Окно Statistics отображает HTML-сводку. Выбор инструмента переключает таблицу между всей программой и одним инструментом. Export HTML сохраняет сводку и все секции инструментов с таким же переключателем и текущими единицами отображения. Только в экспортированном отчёте под таблицей добавляется статичная SVG-проекция: XY для фрезеровки, XZ для токарки. Выбор инструмента фильтрует и изображение. Экспорт из GUI использует ту же подготовленную геометрию, компоновку страницы и стили линий, что Print. Все движения сохраняются. Исходная УП в файл не включается.

Переключатель Inches преобразует значения без изменения физической геометрии. Аналог в CLI: `python -m app analyze program.nc --html statistics.html` (добавьте `--inches` для дюймов).

### Почему время обработки может быть UNKNOWN?

Ядро избегает фабрикации физической скорости подачи. Распространённый случай — движение с подачей на оборот без известной скорости шпинделя.

### Что такое вкладка Tokens?

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

Первые столбцы — **Ln, Raw, Support, Action, Valid**, остальные сохраняют прежний порядок. Поддержка и диагностика находятся рядом с исходным кадром. Native-слова Klartext и присваивания параметров Siemens отображаются непосредственно, без преобразования в токены FANUC. CSV использует тот же порядок столбцов.

Слева над таблицей расположен фильтр **Все / Предупреждения / Ошибки**. Счётчик **Строки: показано / всего** находится внизу слева, на одной строке с кнопками. Справа — поиск по исходному тексту, словам и диагностике, например `T1 M6`. Поиск не учитывает регистр и повторные пробелы; он оставляет совпавшие строки, а не весь участок обработки инструментом. Оба фильтра применяются одновременно к уже загруженной таблице без повторного расчёта программы. Кнопка очистки снимает текстовый фильтр; копирование и CSV включают только видимые строки. **Обновить** перечитывает анализ текущего документа, сохраняя выбранные фильтры.

Открытие Tokens, возврат на вкладку и кнопка **Обновить** используют уже рассчитанный результат активного документа, если программа и параметры расчёта не изменились. Новый анализ запрашивается только при отсутствующем или устаревшем результате. Если расчёт уже идёт, открытие инспектора не запускает второй и не отменяет текущий. Variables продолжает читать снимки воспроизведения.

### Что такое вкладка Variables?

Variables показывает сохранённое состояние переменных в текущей позиции логического воспроизведения для активного языка:

- **FANUC Lathe/Mill:** номерные `#1` и именованные `#<NAME>`, включая сохранённые локальные области G65 и восстановление вызывающей стороны после M99.
- **SINUMERIK:** `R0`, `R1` и другие R-параметры, а также поддержанные объявленные/именованные переменные. Идентификаторы Macro B в смешанном вводе сохраняют префикс `#`.
- **HEIDENHAIN iTNC 530:** `Q`, `QL` и `QR` из native-снимков, без оформления FANUC.

Над таблицей указаны язык, физическая строка исходника и номер её исполнения. Номерные семейства сортируются численно: Q2 перед Q10. Столбцы — **Переменная / Значение**, CSV сохраняет отображаемые имена нужной стойки. В конце программы показан итоговый снимок; программа только с присваиваниями может показать последнее исполненное состояние даже без движений. Неопределённое сохранённое значение отмечается явно. Это данные поддержанного исполнителя, а не чтение памяти реальной стойки или полное покрытие её переменных.

Инспектор использует готовые снимки и не перезапускает программу ЧПУ при перемещении ползунка воспроизведения.

### Почему Variables могут быть недоступны?

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

---

## Экспорт

**Пятиосевая конвертация FANUC ↔ SINUMERIK поддерживается экспериментально и может содержать ошибки. Применяйте полученную УП исключительно на свой страх и риск.** Успешный экспорт и отсутствие ошибок в Tokens не гарантируют правильную обработку и отсутствие столкновений. Перед запуском на станке независимо проверьте целевую стойку и пост, кинематику, WCS, номера инструментов и коррекцию длины, компенсацию, ветви поворотных осей, подводы и отводы; проверьте результат в подходящей симуляции станка и выполните контролируемый холостой прогон. OEM-траектории отвода CYCLE800 и полная физическая модель станка не моделируются.

Конвертация индексированных фреймов 3+2 охватывает **5Ax Table AC**, **5Ax Table BC**, **5Ax Table AC Angled** и **5Ax Table BC Angled** через `fanuc_mill_multiaxis` / `sinumerik_840d_multiaxis` с абсолютным выводом координат. Конвертация TCP ограничена поддержанным подмножеством AC/BC. При выводе наклонных плоскостей сохраняется выбор G54–G59, а требуемые смещения указаны в комментариях; настройте те же смещения на целевой стойке. Имена инструментов SINUMERIK сохраняются в исходном документе; GUI запрашивает разные номера FANUC T1–T99 и записывает соответствие в комментарии. Проверьте соответствующие H-корректоры в таблице инструментов цели. Явные ненулевые цели G53/SUPA сохраняются явно. Непроверенная геометрия и неподдержанные сочетания по-прежнему отклоняются.

**Радиусная коррекция G41/G42:** EXPANDED не выводит команды G41/G42; встроенные фрезерные посты выводят G40. Перед пятиосевой конвертацией отключите коррекцию в **Options**, чтобы избежать ошибок расчёта коррекции и экспорта. При отключённой коррекции экспортируется контур без радиусной компенсации, а не скорректированная траектория центра инструмента; результат обработки нужно проверять независимо. Это указание относится к радиусной коррекции, а не к коррекции длины H/D. Корректность пятиосевой конвертации со включённой радиусной коррекцией не гарантируется.

### Какие семейства экспорта GUI существуют?

Для NC/геометрии есть три режима:

- **FULL** — безопасная нормализация исходной УП;
- **EXPANDED** — рассчитанная геометрия/состояния через профиль целевой стойки;
- **DXF** — геометрия траектории.

Tool List и Statistics — отдельные экспорты отчётов, а не режимы NC.

### Повторно ли интерпретируется G-код при экспорте?

Нет. FULL использует точный исходный текст вместе с авторитетной картой исполнения. EXPANDED и DXF используют рассчитанную геометрию/состояния выполнения. Ни один путь не запускает второй интерпретатор ЧПУ.

### Что означает Full Program?

FULL сохраняет обычные исходные кадры, комментарии, модальные команды, диалект и поддерживаемые циклы. Конструкции FANUC, зависящие от потока выполнения и меток, раскрываются по карте исполнения до перенумерации: вычисленный Macro B, IF/GOTO/WHILE, вызовы G65 и M98/M99, а также токарные G70–G76. Поддержанные native-выражения фрезерного SINUMERIK и поток WHILE/GOTO/IF сохраняются в исходнике; числовые метки переходов сохраняются, а перенумерация кадров для программ с native-переходами отклоняется. Нормализация FULL для HEIDENHAIN и токарного SINUMERIK не поддержана; для сохранения исходника используйте Save/Save As. FULL не конвертирует программу на другую стойку.

### Что означает Expanded Execution?

EXPANDED — путь конвертации между стойками. Один общий постпроцессор выводит рассчитанную геометрию и машинные состояния через JSON-профиль. Циклы, переменные и поток подпрограмм к этому моменту уже исполнены. Профиль цели задаёт синтаксис, обязательные кадры, возможности и значения по умолчанию; он не отключает пользовательские параметры вывода.

Встроенные профили: `fanuc_mill`, `fanuc_mill_multiaxis`, `fanuc_lathe_a`, `fanuc_lathe_b`, `sinumerik_iso`, `sinumerik_840d`, `sinumerik_840d_multiaxis`, `heidenhain_itnc530`; внешний JSON выбирается через `--post-profile`. Профили `*_multiaxis` объявляют `supports.axes` `X/Y/Z/A/B/C` и выводят явные resolved rotary coordinates; трёхосевые профили остаются только XYZ и по-прежнему отклоняют rotary-геометрию.

При выводе поддержанных наклонных плоскостей сохраняются G54–G59 и требуются такие же смещения на цели; остальные случаи индексирования вокруг смещённой WCS отклоняются с `UNSUPPORTED_INDEXED_WCS_EXPANDED_EXPORT`. Разбиение TCP-дуг распределяет ABC вместе с XYZ; вывод rotary в G91 избегает накопления ошибки округления. Для пользовательского поста с G93 сохраняется длительность исходного кадра, а перед следующим движением восстанавливается исходная подача. Непроверенная компенсация и проигнорированные native-команды, меняющие геометрию, возвращают `UNSUPPORTED_UNVERIFIED_GEOMETRY_EXPANDED_EXPORT` с конкретными кодами диагностики исполнения.

### Что означает Auto (source controller)?

`Auto (source controller)` — не отдельный режим возможностей. Токарный FANUC берёт выбранный профиль A/B, фрезерный FANUC — `fanuc_mill`, фрезерный SINUMERIK ISO-M — `sinumerik_iso`, нативный фрезерный SINUMERIK — `sinumerik_840d`, HEIDENHAIN — `heidenhain_itnc530`. Для токарного SINUMERIK Auto сейчас выбирает токарный пост FANUC A/B: встроенного выходного поста Siemens для токарки нет, исходная стойка не сохраняется. EXPANDED пересобирает рассчитанное исполнение и сохраняет ограничения предварительной проверки экспорта.

### Как управлять пользовательскими постпроцессорами в GUI?

Для создания и редактирования откройте **Настройки / Постпроцессоры**. Слева расположен список, справа — встроенный редактор. Кнопки под списком создают копию, сохраняют, переименовывают и удаляют профиль. Встроенные профили доступны только для чтения. Новая копия остаётся в памяти до **Сохранить** или **OK**; **Отмена** отбрасывает несохранённые изменения. При смене профиля предлагается сохранить, отбросить изменения или отменить переход.

Редактор содержит вкладки **Source**, **Output**, **Format**, **Sequencing**, **Motions**, **Home**, **Cycles**, **Commands**, **Program** и **Supports**. Format задаёт общий формат чисел. На Sequencing перетаскивайте плитки адресов для изменения порядка и выбирайте плитку для настройки точности, знака и повторения. Нестандартные углы разбиения дуг, включая 5400 градусов, отображаются без подмены.

**Сохранить** проверяет профиль тем же загрузчиком, что использует CLI, и атомарно заменяет пользовательский JSON. Ошибки оставляют редактор открытым и сохраняют прежний файл. Сохранение профиля действует независимо от OK/Cancel внешнего окна настроек.

В **Параметры экспорта / EXPANDED EXECUTION** выберите **Target CNC** или нажмите **Добавить готовый…**, чтобы импортировать проверенный JSON для текущего типа станка. Импорт сохраняет копию в папку `post-profiles` каталога конфигурации, не меняя исходный файл. Редактирование и управление находятся в настройках; переименование сохраняет путь и `id` контроллера.

Встроенный `heidenhain_itnc530` — цель вывода EXPANDED, отдельная от собственного входного парсера и трёхосевого исполнителя. Выводятся `BEGIN/END PGM`, `TOOL CALL`, `L/FMAX`, `CR`, `CC` с `C/CP`, циклы 200/201/202/203/207 и быстрые возвраты XYZ в машинных координатах с `M91`. Знаки IPA и DR совпадают; Q239 отрицателен для левой резьбы. G85 использует цикл 201 с отводом на подаче, G86 — цикл 202 с остановкой шпинделя и быстрым отводом. Дуги вне плоскости шпинделя из TOOL CALL линеаризуются с допуском экспорта. Нумерация не содержит `N`. Неподдержанные поворотные/TCP-операции и циклы отклоняются до записи файла. Возможности экспорта не означают поддержку исполнения тех же команд на входе: см. [таблицу покрытия](#что-входит-в-поддержку-heidenhain).

Экспорт передаёт путь JSON тому же механизму, что CLI `--post-profile`, включая расширение файла. Выбор сохраняется по идентификатору/пути. Для отсутствующего, повреждённого или несовместимого профиля нужно явно выбрать Auto или другой исправный профиль. В FULL и DXF выбор профилей отключён. Cancel в Export Options отменяет параметры вывода и временный выбор; отдельно сохранённые профили остаются доступными.

### Как работает Modal Feed?

`Modal Feed` управляет повтором `F`: **Да** выводит `F` только при смене подачи или режима подачи, **Нет** повторяет `F` в каждом режущем перемещении.

### Можно ли выбирать параметры форматирования при конвертации на конкретную стойку?

Да. EXPANDED рассматривает Целевое ЧПУ как целевой синтаксис/профиль, а не как выключатель возможностей. Координаты (G90/G91), номера кадров, разделитель, ведущий ноль, модальная подача, десятичных знаков, десятичная точка и знак плюс, вывод дуг и начало/конец программы остаются доступными и соблюдаются для FANUC → FANUC, FANUC → SINUMERIK ISO, FANUC → SINUMERIK native и SINUMERIK → FANUC. Значение профиля применяется только когда вы его не выбрали. Если профиль объявляет обязательный префикс (например, `G290`/`G291`), он остаётся первым, а ваш текст начала идёт после него. Профиль используется только для реальных ограничений возможностей: rotary/TWP/TCP, отсутствующая ось или неподдерживаемое состояние дуги/подачи.

### Что содержит DXF?

DXF содержит доступную рассчитанную геометрию движений. Быстрые и режущие движения находятся на разных слоях. Для точения используется представление Z/X как на Plot; для фрезерования записываются 3D-линии и аналитические дуги/окружности, где это возможно, а непредставимая одной DXF-дугой геометрия дискретизируется в полилинию.

### Разбирает ли DXF G-код заново?

Нет. DXF writer работает с геометрией движений и не интерпретирует слова стойки или параметры NC-форматирования.

### Какие параметры форматирования NC существуют?

Общие параметры экспорта включают:

- абсолютные/инкрементальные координаты, где поддерживается;
- номера последовательности;
- начало и приращение последовательности;
- интервал номеров последовательности;
- пробелы/без пробелов между словами;
- ведущие нули (`G01` против `G1`);
- комментарии/без комментариев;
- строка безопасности (объявленная в профиле);
- десятичных знаков, десятичная точка и знак плюс;
- начало и конец программы;
- представление дуг фрезерования.

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

### Как пост-профиль управляет порядком и обязательностью вывода слов?

Объект `format.words` в профиле задаёт каждому токену кадра поля `order` и `required`: `motion`, `X`, `Y`, `Z`, `A`, `B`, `C`, `I`, `J`, `K`, `R`. `required=true` выводит адрес при наличии resolved value (например `Y0` вместо пропуска нулевого `Y`); `required=false` допускает обычный пропуск неизменившегося значения. `motion.required=false` делает код движения модальным: `G1` повторяется только при смене движения. `decimals`/`sign` для слова хранятся в том же объекте. Ось допустима только если объявлена в `supports.axes`, а `F` намеренно исключён, поскольку подачей управляет Modal Feed. Обязательность адресов — свойство конкретного post/controller, поэтому она задаётся только в профиле и не имеет отдельной настройки GUI/CLI.

Редактор постпроцессора показывает этот упорядоченный список на вкладке **Sequencing**. Перетаскивание плиток меняет сохраняемый порядок адресов, а выбор плитки открывает ниже её настройки форматирования.

Дополнительные параметры дуг находятся в `format`: `turnsWord`, `radiusSplitAngle`, `arcSplitAngle` и `fullCircle`. В `supports` объявляются возможности `axes`, `inverseTime`, `multiTurnArcs` и `absoluteArcCenters`. Запрос за пределами возможностей выбранного поста возвращает `UNSUPPORTED` вместо частичной NC-программы. Трёхосевые посты отклоняют поворотную/TWP/TCP-геометрию; для поддержанного индексирования/TCP нужен соответствующий многоосевой пост.

### Какие режимы вывода дуг Expanded для фрезерования существуют?

Контракт CLI предоставляет:

```text
auto
ijk-relative
ijk-absolute
radius
linearized
```

`auto` использует соглашение из пост-профиля. Четыре явных режима: относительные IJK, абсолютные IJK, радиус и линеаризация. Исходный синтаксис дуг уже разрешён до постпроцессинга. Native SINUMERIK выводит абсолютные центры как `I=AC(...)` / `J=AC(...)` / `K=AC(...)`, а радиус — как `CR=`.

### Что происходит, когда полная окружность экспортируется в режиме R?

Она выдаётся как две точные полуокружности R.

### Можно ли преобразовать Expanded NC между миллиметрами и дюймами?

Да. Преобразование единиц выполняется на границе постпроцессора по рассчитанной геометрии/состоянию. Координаты, геометрия дуг, I/J/K или радиус, подачи и поддерживаемые состояния стойки выводятся в выбранных единицах и проверяются повторным исполнением в тестах экспорта.

FULL сохраняет исходник и поэтому принимает только `--units auto`.

### Можно ли принудительно задать Full Program в мм или дюймах?

Нет. Экспорт Full Program CLI в настоящее время принимает только `--units auto`.

Семантическая нормализация единиц — это функция Expanded Execution.

### Какие единицы использует DXF?

DXF может выводиться в миллиметрах или дюймах. `auto` сохраняет текущее поведение DXF по умолчанию, то есть миллиметры.

### Можно ли удалить комментарии из экспорта?

Да. `--no-comments` удаляет исходные комментарии из FULL и подавляет перенос исходных комментариев в EXPANDED. Синтаксис комментариев EXPANDED задаётся выбранным пост-профилем.

### Записываются ли экспорты атомарно службой CLI?

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

### Может ли экспорт CLI перезаписать исходный файл?

Нет. Исходный и выходной пути должны быть разными.

### Можно ли напрямую сравнить экспорт CLI с эталонным NC-файлом?

Да. Добавьте `--compare-with FILE` к экспорту одного NC-файла в режиме FULL или EXPANDED:

```powershell
.\easy_gcode_plot_cli.exe export source.nc --lang fanuc_mill --post-profile sinumerik_840d -o actual.mpf --compare-with expected.mpf
```

CLI сравнивает фактически сгенерированный файл с эталоном в UTF-8. Окончания строк LF и CRLF считаются одинаковыми; пробелы, комментарии и завершающий перевод строки сравниваются. Код завершения `0` означает совпадение, `1` — расхождение, `2` — ошибку экспорта или работы с файлом. При расхождении в stdout выводится unified diff без временных меток: сначала эталон (`---`), затем результат (`+++`). Сгенерированный файл сохраняется; эталон не может быть выходным файлом и не перезаписывается. Для DXF и `batch-export` этот параметр недоступен.

Это прямая регрессионная проверка текста. Проверки исполнения и повторного исполнения экспорта по-прежнему нужны для семантической эквивалентности, когда разный NC-текст описывает одну операцию.

---

## SINUMERIK 840D

**Настройки → Параметры → Общие → 840D Extended cycles** выбирает интерфейс циклов для чтения native-программы и её native-экспорта EXPANDED. Включён (по умолчанию): интерфейс Siemens 03/2009, CYCLE81/82/83/84 с 9/9/20/24 параметрами. Выключен: классический интерфейс 01/2008 с 5/6/17/21 параметрами. Короткие совместимые вызовы принимаются; сигнатуры 840D Extended cycles в классическом режиме дают диагностику. Изменение настройки пересчитывает текущую программу. Выбор не меняет G290/G291 и кинематику: совместимость определяется установленным пакетом циклов, а не одним названием платформы. В CLI используется `--sinumerik-cycles classic|sl`; в JSON native-постов оба набора находятся в `cycleProfiles.classic_0108` и `cycleProfiles.sl_0309`.

Исходные [ext_cycles.mpf](tests/fixtures/milling/sinumerik/ext_cycles.mpf) и [no_ext_cycles.mpf](tests/fixtures/milling/sinumerik/no_ext_cycles.mpf) теперь исполняются целиком в соответствующих профилях, включая глубокую/левую резьбу и CYCLE85/86/87/89. Native M19 выдаёт сигнал ориентации шпинделя.

Интерпретация центров дуг определяется режимом в момент исполнения: native и ISO-M (`G291`) используют относительные IJK; в native абсолютный центр явно задаётся I=AC/J=AC/K=AC. В смешанной программе `G290/G291` каждая дуга разрешается в своём активном режиме; настройка дуг документа и автоопределение не переопределяют эту семантику. В native доступны настроенные поворотные оси в пределах поддержанного TCP/indexing subset; в G291 поворотные A/B/C отклоняются.

Результат исполнения и структурированные CLI/batch-отчёты содержат `source_dialect` (`fanuc` или `sinumerik`) независимо от общей геометрической модели `fanuc_mill`. Это семейство исходной программы, а не один режим для всей смешанной программы. Конкретные неподдержанные G/M-коды SINUMERIK учитываются в сводке batch; ошибки синтаксиса и функций не превращаются в выдуманные G/M-записи.

Поддержка SINUMERIK охватывает **native CAM-траектории и ограниченные параметрические программы**: арифметику R, WHILE/ENDWHILE и GOTO/IF GOTO с числовыми метками. Это описанное подмножество языка Siemens; массивы, системные переменные и произвольные вызовы подпрограмм остаются неподдержанными. Исполнение подпрограмм из режима SDI пока также недоступно. SPF можно открыть как документ, но это не означает поддержку произвольных вызовов подпрограмм Siemens.

MPF/SPF сохраняют выбранный поворотный профиль. Меню Settings и список Options остаются доступными. Native CYCLE800/TRAORI поддерживают наклонные столы AC/BC; несовместимые профили, оси и поворотные команды ISO-M отклоняются ядром с диагностикой.

### Какая поддержка SINUMERIK включена?

Приложение поддерживает ограниченные нативные подмножества Siemens для фрезерования и токарки (`G290`, также начальный режим MPF/SPF). `G291` выбирает ISO Dialect M при фрезеровании и ограниченное подмножество ISO Dialect T при токарке. Оба публикуют общий рассчитанный trace; ограничения токарки описаны ниже.

Таблица и последующие правила переходов native/ISO-M, циклов и TCP относятся к **фрезерованию**. Диаметральные режимы, политика M-кодов и ограничения токарных циклов описаны в [поддержке токарного SINUMERIK](#поддерживается-ли-токарный-sinumerik); возможности фрезерования не переносятся на токарку автоматически.

| Нативная функция | Текущее поведение |
| --- | --- |
| `G0/G1`, `G2/G3`, `G17/G18/G19`, `CR=` | Позиционирование XYZ и дуги в выбранной плоскости; отрицательный `CR` задаёт большую дугу |
| `G90/G91`, `G54`–`G59` | Абсолютные/приращённые координаты и рабочие смещения |
| `G70/G71` | Длины в дюймах/мм; единицы подачи не меняются |
| `G700/G710` | Длины и подача в дюймах/мм; числовое модальное F сохраняется |
| `G93` | Обратное время: каждое движение подачи занимает 1/F минуты, включая вращение под TCP. F должно быть положительным; при переключении G93/G94/G95 задайте новое F. Циклы и коррекция радиуса под G93 не поддержаны |
| `G40/G41/G42` | Моделируемая радиусная компенсация по настроенному инструменту |
| `DIAMON/DIAMOF/DIAM90` | Только предупреждение; все координаты исполняются в семантике DIAMOF |
| `CHR/RND` | Немодальные длина стороны фаски / радиус скругления между непрерывными плоскими элементами G1 до коррекции инструмента. При фиксированном повороте и наклонной рабочей плоскости расчёт выполняется в локальных координатах; сам выбранный профиль не меняет трёхосевой контур. Соседние элементы должны иметь общие плоскость, инструмент и режим коррекции |
| `CHF/RNDM/FRC/FRCM` | Распознаются с предупреждением без изменения геометрии/подачи. Модальное скругление и подача на переходах не моделируются. RNDM=0 не меняет геометрию; предупреждения об игнорируемых словах блокируют экспорт рассчитанной NC-программы |
| `G60/G64` | Точный останов / непрерывное движение как метаданные; разгон, время останова и сглаживание не моделируются |
| `G500` | Модальное отключение рабочего смещения с пересчётом координат; G500/базовый фрейм по умолчанию нулевые, API `wcs_offsets[500]` позволяет задать смещение; OEM-повороты, отражения и масштабирование базового фрейма не моделируются |
| Присваивания R и адресные/цикловые выражения | Ограниченные `+ - * /`, скобки, сравнения и `SIN/COS/ABS/SQRT`; тригонометрия в градусах; отдельное состояние Siemens R |
| `WHILE/ENDWHILE`, `GOTO N...`, `IF условие GOTO N...` | Вложенные циклы и переходы по числовым меткам; общие лимиты исполнения/итераций и отмена; ошибки потока останавливают исполнение с указанием исходной строки |
| `M19` | Сигнал ориентации шпинделя без движения и изменения состояния шпинделя |
| `G96/G961`, `G97/G971` | CSS или RPM с подачей на оборот/в минуту соответственно; CSS сохраняет скорость резания без вычисления мгновенных RPM |
| `ANG`, `SCALE/ASCALE`, `MIRROR/AMIRROR` | Распознаются, но геометрия не моделируется; исполнение останавливается до движения |
| `DEF REAL`, прямые присваивания именованных скаляров | Принимаются ограниченные скаляры `DEF REAL` с именами, начинающимися с подчёркивания, используемые в CAM-заголовках, и прямые присваивания чисел/R/скаляров; составные присваивания именованным скалярам остаются неподдержанными |
| `T`, `M6`, `D0..D12`, `S`, базовые M-команды | Смена инструмента, выбор/отмена моделируемой режущей кромки, сигналы шпинделя и СОЖ; таблицы коррекций контроллера не моделируются |
| Именованные инструменты с `M6` | Смена именованных инструментов принимается; если геометрия фрезы неизвестна, `G41/G42` остаётся непроверенным, а радиус не подставляется автоматически |
| `G0 SUPA ... D0` | Немодальное абсолютное перемещение XYZ и настроенных A/B/C, независимо от G91. В модели приложения нулевые XYZ-адреса используют настроенную позицию возврата G28/SUPA, как FANUC G53. WCS и текущий поворотный кадр определяют отображение возврата. Нулевые поворотные адреса означают A/B/C=0; для `SUPA G0 B0 C0 D0` нужен совместимый профиль BC |
| `G64`, `MSG(...)`, `WORKPIECE(...)`, комментарии `;` | Метаданные и комментарии; сглаживание траектории и геометрия заготовки по этим объявлениям не рассчитываются |
| `SETMS(1)`, `FNORM`, `COMPOF`, `CYCLE832` | Принимаются как CAM-команды настройки/управления; `CYCLE832` игнорируется без геометрии и событий отображения |
| `MCALL CYCLE81/82/83/84/85/86/87/89(...)` | Модальное сверление/нарезание резьбы по Z в `G17/G40`, запускаемое последующими кадрами XY; отдельный `MCALL` отменяет цикл |
| `CYCLE81/82` | Сверление и быстрый возврат, выдержка в секундах для `CYCLE82`; безопасная плоскость `RFP + SDIS`, возврат на `RTP`; принимается также четырёхпараметрическая форма `CYCLE81` |
| `CYCLE83` | Первая глубина, уменьшение шага на заданную величину, минимальный шаг, дробление стружки/полный отвод и зазор повторного подхода в пределах реализованных параметров |
| `CYCLE84` | Правая/левая метрическая резьба в G94, включая VARI=1/2, DAM/VRT и выравнивание последних шагов. PIT задан явно; SST равен S, SST1 равен ему либо пропущен. Учитывается SDAC=3/4/5. Синхронный выход до RFP+SDIS, затем быстрый возврат до RTP. |
| `CYCLE85/86/87/89` | CYCLE85 учитывает отдельные подачи входа/выхода FFR/RFF; CYCLE89 выполняет вход и выход на подаче с выдержкой. CYCLE87 фиксирует останов шпинделя и оператора, затем быстрый выход. CYCLE86 строит ориентированный останов POSS и отвод по RPA/RPO/RPAP. |
| `POCKET3/POCKET4` | Позиционный интерфейс classic 01/2008: 17–23 / 14–19 аргументов; прямоугольные/круглые карманы, черновая либо чистовая обработка, припуски и поддерживаемые стратегии входа VARI. Заготовки AP1/AP2/AD и расширенные сигнатуры диагностируются |
| `HOLES1/HOLES2` | Шесть позиционных аргументов; позиции ряда/окружности вызывают активный поддерживаемый цикл сверления MCALL в G17 без TCP. HOLES1 начинает с ближайшего конца ряда; HOLES2 допускает пустой/нулевой INDA для равномерного шага |
| `CYCLE90` | Классический вызов с 13 аргументами: внутренняя/наружная резьба по TYPTH, явный шаг, направление G2/G3 и аналитические многовитковые винтовые движения |
| `TRAORI` / `TRAFOOF` | GUI/CLI/kernel TCP через общее ядро наклонных столов AC/BC; G0/G1/G2/G3 с числовыми A/B/C и прямыми R-ссылками; IC поддержан; `DC` выбирает кратчайший подход к абсолютному поворотному углу, а неоднозначность ровно 180° отклоняется |
| `CYCLE800` | GUI/CLI/kernel статические фреймы: режимы 57/54/39/27/30/45, ST0/1/200000/200001/220000/220001, DIR-1/0/1; принимаются вызовы с 14/15/16 аргументами и старый вариант R_DATA; сброс активного фрейма пустым вызовом, bare-командой или TC="0" |
| `CIP` | Пространственная окружность через начальную, промежуточную I1/J1/K1 и конечную точки, независимо от G17/G18/G19. Поддержаны G90/G91 и явные AC/IC для промежуточной точки. Требуются фиксированный фрейм и G40; одновременный поворот осей отклоняется. Plot/Playback сохраняют окружность; EXPANDED выводит хорды G1 с заданным допуском линеаризации. |
| `TRANS/ATRANS`, `ROT/AROT`, `RPL=` | Программируемые жёсткие фреймы: замена/сброс либо композиция в локальных осях с сохранением физической позиции инструмента. Пространственный поворот использует RPY (MD10600=1); RPL вращает в активной плоскости. Сочетание с активными TWP/TCP, полярным режимом, циклами или коррекцией радиуса отклоняется |
| `G505`–`G599`, `G601/G641/G642/G645` | Принимаются с предупреждениями UNVERIFIED; зависящие от контроллера эффекты не моделируются |
| Неизвестные вспомогательные M-коды | Неблокирующие предупреждения `UNSUPPORTED_M_CODE`; движения и известные команды того же кадра выполняются. M2/M30 завершают программу. Native M17/M96/M97/M99 останавливают исполнение; M66/M98 предупреждают без вызова подпрограмм |

POCKET3/4 и CYCLE90 требуют G17, G40, G80, подачу в минуту, отсутствие активного MCALL и заданный диаметр фрезы через `milling_tools`/`tool_resolver`. Сочетания с TCP, полярным режимом и CIP не входят в поддерживаемое подмножество. Эти вызовы используют classic-сигнатуры 01/2008 независимо от переключателя расширенных циклов сверления; новые сигнатуры не переинтерпретируются молча. Короткие примеры находятся в [`sinumerik/cycles/`](tests/fixtures/milling/sinumerik/cycles/). Внутренние последовательности проходов не подтверждены независимой трассой стойки.

Несохранённый текст редактора выбирает native SINUMERIK по исполняемым командам, например SUPA, CIP, MCALL, TRANS или CYCLE800. Комментарии и строки в кавычках не переключают диалект; Undo/Redo обновляет выбор. Для файлов с именем сохраняется определение по расширению.

`D0` отменяет выбор режущей кромки; `D1`–`D12` выбирают кромку с сохранением номинальной геометрии инструмента. Кромки выше D1 дают `UNVERIFIED_SINUMERIK_EDGE_OFFSETS`, поскольку таблицы коррекций стойки недоступны. CYCLE800 ST220000/220001 рассчитывает новый/добавочный фрейм без индексирования. Имя набора данных `DMG` для расчёта фрейма принимается на **5Ax Table BC Angled** с FR0; OEM-индексирование не моделируется.

Программируемые `TRANS`/`ATRANS` и `ROT`/`AROT` изменяют последующую XYZ-геометрию относительно активной WCS. `TRANS` и `ROT` заменяют все компоненты programmable frame; команды без аргументов сбрасывают его. `ATRANS` добавляет смещение в текущих локальных осях, `AROT` — локальный поворот с сохранением смещения. При смене frame программные координаты пересчитываются, а физическая позиция инструмента сохраняется без движения. Для пространственных XYZ-углов используется стандартный порядок Siemens RPY Z → Y′ → X″ (MD10600=1), независимо от порядка адресов в кадре. Станки с настройкой порядка Euler этим правилом не покрываются. `RPL=` поворачивает в активной плоскости вокруг +Z (G17), +Y (G18) или +X (G19). Каждая команда требует отдельного NC-кадра; поддержаны числа, прямые R-ссылки и уже поддерживаемые именованные скаляры, без расширения языка выражений. Сочетания с активными TWP/CYCLE800, TCP, полярным режимом, циклами и коррекцией инструмента отклоняются. SCALE/ASCALE и MIRROR/AMIRROR остаются неподдержанными. FULL сохраняет команды frame; EXPANDED выводит их результат в координатах движений, а дуги вне стандартной плоскости вывода линеаризует с выбранным допуском.

Радиусные дуги CR требуют документа SINUMERIK: используйте .mpf/.spf или несохранённый текст, определённый по исполняемым native-командам. Файл .nc сохраняет синтаксис FANUC. Native X/Y/Z=IC(...) задаёт приращение независимо от G90/G91. MSG() принимается.

`CYCLE84` принимает вызов CAM с 24 параметрами и сокращённые числовые объявления. В режиме совместимости глубина задаётся через `DP` или положительный относительный `DPR`; абсолютный режим `AMODE=2/1001002/1002002` требует `DP`. Поддержаны правая/левая метрическая резьба и глубокая резьба (`VARI=1/2`, `DAM`, `VRT`). `MPIT`/таблицы резьб, неметрические единицы шага, ориентация шпинделя, технологические опции и разные обороты входа/выхода отклоняются с диагностикой. Синхронизация и реверс представлены логическими сигналами без моделирования углового положения шпинделя. Параметры сверены с [руководством Siemens по циклам](https://cache.industry.siemens.com/dl/files/633/109443633/att_829767/v1/PGZ_1106_en.pdf); парные фикстуры проверяют геометрию резьбы и повторное исполнение trace.

Cython ускоряет последовательные участки обычных числовых кадров позиционирования; capability gate проверяет каждый кадр до изменения состояния. Нативные декларации и переключения G290/G291 прерывают только текущий участок, после чего ускорение возобновляется на подходящих кадрах. Координаты при активном цикле MCALL исполняются через Python до отмены цикла. Наличие метаданных или нативного цикла в другом месте файла не отключает ускорение всей программы.

Присваивания R-параметров, адресные значения и параметры поддержанных циклов принимают ограниченную арифметику (`+ - * /`), скобки, сравнения и `SIN/COS/ABS/SQRT`. Тригонометрия использует градусы. Состояние Siemens R отделено от FANUC `#` и создаётся заново для каждого исполнения. Неопределённые ссылки, некорректные выражения, недопустимые значения функций и деление на ноль останавливают исполнение. Native `WHILE/ENDWHILE` допускает вложенные циклы; `GOTO N...` и `IF условие GOTO N...` используют числовые метки кадров. Отсутствующие/повторные метки и несогласованные циклы дают диагностику с исходной строкой. Действуют общие лимиты исполнения, итераций и отмена. `GOTOF/GOTOB/GOTOC`, `RET`, массивы, системные переменные и произвольные вызовы подпрограмм остаются неподдержанными; распознавание SPF не включает исполнение подпрограмм.

Native `M19` создаёт сигнал ориентации шпинделя без движения инструмента и изменения состояния шпинделя. `G96/G961` включают CSS с подачей на оборот/в минуту соответственно; `G97/G971` выбирают RPM с подачей на оборот/в минуту. CSS сохраняет заданную скорость резания; мгновенные RPM не выводятся из координаты X фрезерного станка. FULL сохраняет поддержанные native-выражения и поток управления; EXPANDED выводит разрешённую геометрию, но отклоняет CSS без достоверной опорной оси. `ANG`, `SCALE/ASCALE` и `MIRROR/AMIRROR` распознаются, однако их геометрия не моделируется: исполнение останавливается до движения. Native-поток `M17/M96/M97/M99` не поддержан; `M66` и `M98` сохраняют явные предупреждения, а native M98 никогда не запускает FANUC-подпрограмму.

Нативный `TURN=n` добавляет целое число 0..999 полных оборотов к основной дуге `G2/G3` с IJK или CR, при G40 и без активного MCALL — согласно [Siemens](https://support.industry.siemens.com/cs/attachments/104985512/802Dsl_BPF_1006_en.pdf). В trace остаётся один аналитический объект дуги/спирали с полным углом. Отрисовка, playback и статистика учитывают все витки; DXF сохраняет их полилинией, FANUC/ISO делят дугу только при сериализации. Снятие материала поддерживает точение и, начиная с 2.0.0, трёхосевое фрезерование вертикальными фрезами. Отдельный нативный `G4 F...` задаёт секунды и не меняет модальную подачу; выдержка в оборотах шпинделя пока не моделируется.

GUI/CLI/kernel поддерживает ограниченный TCP subset TRAORI/TRAFOOF для **5Ax Table AC Angled** и **5Ax Table BC Angled**. Числовые A/B/C и прямые R-ссылки для настроенных осей следуют G90/G91; IC(число/прямая R-ссылка) всегда задаёт приращение. TCP-дуги сохраняют аналитическую XYZ-геометрию и ориентации начала/конца. CYCLE800 строит матрицу по правилам Siemens и использует общий TWP solver и ребазирование. FR0/1/2 фиксируются как запросы отвода без моделирования OEM-траектории; FR_I должен быть нулевым/пустым, поддержан DMODE0/1. DIR выбирает ветвь по знаку главного угла первого шарнира стола. ORI*, FGROUP, FL[], FGREF[], SPOS, CUT3DC/CUT3DF/CUT3DFF и расширенные режимы управления движением принимаются с предупреждением: их эффекты не моделируются. G505–G599 не выбирают новое смещение; текущая WCS сохраняется. Конвертация такой непроверенной геометрии в NC отклоняется. Произвольные вызовы подпрограмм остаются fail-closed. G290/G291 при активном TWP/TCP отклоняются. Native MCALL и G41/G42 нельзя активировать под TCP; активный MCALL нужно отменить перед поворотным позиционированием. GUI сохраняет выбранную кинематику MPF/SPF и передаёт её общему ядру. Встроенные многоосевые посты реконструируют настроенное индексирование A/B/C, проверенное непрерывное движение **4-axis Table C** и поддержанный AC/BC TCP subset между FANUC и SINUMERIK. Поддержанные индексированные фреймы G68.2/G53.1 и CYCLE800 для AC/BC экспериментально конвертируются через встроенные многоосевые посты; остальные сочетания фреймов отклоняются.

Профили EXPANDED проверяются повторным исполнением в тестах: сравниваются геометрия, подачи и машинные сигналы. FULL сохраняет диалект исходника.

В режиме `G291` принимаются распространённые целочисленные фрезерные G-коды, выбор единиц, системы координат, отдельные циклы и `G50/G51`. Расширенные рабочие смещения задаются через `G54 P1..P48`; исходные `G54.1` и другие дробные G-коды отклоняются, хотя `G54 Pn` внутри нормализуется в форму `G54.1 Pn` для ядра фрезерования. Обычное инкрементальное позиционирование `G91` поддерживается. `G68` ограничен отдельным 2D-блоком при активном `G90`; допускаются только центр в осях активной плоскости и `R`, без `I/J/K`. Инкрементальный угол и 3D-вектор не поддерживаются. `G69` поддерживается. Поток Macro B и неподдерживаемые функции ISO приводят к диагностике. Для `G51` используется моделируемый вес `P/1000`; альтернативные веса из параметров конкретного станка не моделируются.

`G290` выбирает нативное подмножество выше, `G291` — ISO-M. Переключатели должны находиться в отдельных кадрах. Перед `G291` отмените нативную радиусную компенсацию и `MCALL`; перед `G290` — несовместимые ISO-циклы, преобразования и расширенные смещения.

### Как определяется формат MPF и SPF?

Фильтры открытия и сохранения GUI включают `.mpf` и `.spf`. CLI и пакетный сканер по умолчанию включают эти расширения и выбирают SINUMERIK для любого `.mpf`/`.spf` независимо от содержимого; исполнение начинается в нативном режиме и обрабатывает отдельные переключатели `G290/G291`. Для анализа фрезерования укажите `--lang fanuc_mill`; этот параметр выбирает геометрическую модель фрезерования и не включает полную поддержку Siemens. Для смешанных каталогов набор файлов можно ограничить через `--extensions`.

### Можно ли конвертировать фрезерную программу FANUC в SINUMERIK?

Да. Выберите **EXPANDED EXECUTION** и целевую стойку. Постпроцессор берёт рассчитанную геометрию ядра; `sinumerik_iso` выводит ISO-M с G291, `sinumerik_840d` — native с G290.

```powershell
.\easy_gcode_plot_cli.exe export fanuc_part.nc --lang fanuc_mill --mode expanded --post-profile app\gcode\export\posts\sinumerik_iso.json -o iso_part.mpf
```

### Можно ли конвертировать SINUMERIK native в FANUC milling?

Да. Параметры и CYCLE81/82/83/84 уже исполнены ядром; EXPANDED выводит полученные перемещения, подачи, выдержки и машинные сигналы. Поддержанные операции сверления и нарезания резьбы выводятся через шаблоны выбранного поста; параметры разрешаются ядром, а исходные определения MCALL не копируются. Трёхосевой профиль `fanuc_mill` отклоняет rotary/TCP-геометрию; `fanuc_mill_multiaxis` реконструирует настроенное индексирование A/B/C, проверенное непрерывное движение **4-axis Table C** и поддержанный AC/BC TCP subset. Поддержанные индексированные фреймы G68.2/G53.1 и CYCLE800 для AC/BC экспериментально конвертируются через встроенные многоосевые посты; остальные сочетания фреймов отклоняются. Непроверенные изменения геометрии по-прежнему отклоняются.

```powershell
.\easy_gcode_plot_cli.exe export native_part.mpf --lang fanuc_mill --mode expanded --post-profile app\gcode\export\posts\fanuc_mill.json -o fanuc_part.nc
```

### Чем отличаются Full Program и Expanded Execution?

**FULL** отвечает на задачу «сохранить эту программу для той же стойки, но безопасно нормализовать её» для поддержанных исходников FANUC и фрезерного SINUMERIK. Нормализация FULL для HEIDENHAIN и токарного SINUMERIK не поддержана. Обычная структура исходника и исходный диалект сохраняются; раскрываются конструкции потока FANUC, которые нельзя безопасно оставить при перенумерации. Поддержанные native-выражения SINUMERIK и WHILE/GOTO/IF сохраняются; числовые метки переходов сохраняются, а перенумерация для native-переходов отклоняется.

**EXPANDED** отвечает на задачу «вывести рассчитанное исполнение для выбранной стойки». Геометрия и состояния сериализуются единым движком через JSON-профиль. Трёхосевые профили остаются XYZ-only; встроенные многоосевые профили дополнительно реконструируют проверенные rotary/TCP subsets. Обычные траектории используют G54 с нулевыми смещениями; программы с поддержанными наклонными плоскостями сохраняют G54–G59 и требуют таких же смещений на цели; поддержанные фрезерные операции сверления и нарезания резьбы выводятся через шаблоны циклов поста, если их можно представить без изменения исполнения. Остальные операции сохраняют рассчитанные движения; макропеременные и вызовы подпрограмм заново не создаются.

```powershell
.\easy_gcode_plot_cli.exe batch-export C:\Fanuc --lang fanuc_mill --mode expanded --post-profile app\gcode\export\posts\sinumerik_iso.json -o C:\SiemensISO
.\easy_gcode_plot_cli.exe export native_part.mpf --lang fanuc_mill --mode full -o normalized.mpf
```

GUI и CLI используют одно разделение FULL / EXPANDED / DXF. Целевая стойка относится к EXPANDED. Трёхосевые посты отклоняют rotary/TCP-геометрию, а встроенные многоосевые посты реконструируют настроенное индексирование A/B/C, проверенное непрерывное движение **4-axis Table C** и поддержанный AC/BC TCP. Поддержанные индексированные фреймы G68.2/G53.1 и CYCLE800 для AC/BC экспериментально конвертируются через встроенные многоосевые посты; остальные сочетания фреймов отклоняются. Сам по себе выбранный профиль кинематики не превращает XYZ-программу в многоосевую. DXF — отдельный геометрический вывод без NC-постпрофиля.

### Поддерживается ли токарный SINUMERIK?

**Да, в пределах нативного токарного подмножества XZ.** `.mpf/.spf` выбирают контейнер SINUMERIK с начальным G290. DIAMON/DIAMOF/DIAM90 и CYCLE93/95/97 автоматически выбирают токарку; для неоднозначной программы выберите токарный режим GUI или `--lang fanuc_turn` в CLI. Отдельные кадры G290/G291 сохраняют инструмент, позицию и WCS. G291 использует выбранную систему токарных кодов A/B; нативные команды доступны после возврата G290.

Поддержаны G0/G1/G2/G3, G18, G33 с шагом I/K, дуги CR, IC/AC, DIAMON/DIAMOF/DIAM90, G70/G71 и G700/G710, G90/G91, G94/G95, G96/G97 и LIMS, числовой T и логический D, G40/G41/G42, G53/G153/SUPA, G54–G59/G500, TRANS/ATRANS XZ, скалярные выражения и поддерживаемый поток WHILE/IF/GOTO. В публичном trace X остаётся диаметром; I дуги и TRANS X задаются радиусом. Нативный G71 включает метрические размеры, а не цикл черновой обработки FANUC.

- CYCLE95: локальный контур `"START:END"`, включая метки после M30, наружная/внутренняя продольная/торцевая обработка, равномерные черновые проходы, припуски X/Z и чистовой контур. Поднутрения, нормальный припуск, дробление стружки и расширенные режимы G/диаметра отклоняются. Расчёт использует номинальный контур; автоматическая коррекция радиуса вершины и точная оптимизация проходов контроллером не моделируются.
- CYCLE93: прямоугольные осевые канавки, варианты 1–8/11–18, настроенный канавочный резец с шириной, активный D и нулевой радиус вершины. Наклонные стенки, радиусы и фаски отклоняются. D выбирает логическую кромку; смещения из таблицы инструмента станка не импортируются.
- CYCLE97: продольная цилиндрическая/коническая резьба с явным шагом, постоянной глубиной/площадью врезания, чистовым припуском и холостыми проходами. Нужны постоянные обороты работающего шпинделя, IANG=NSP=0 и NUMTH=1. Другие варианты врезания и многозаходная резьба отклоняются.
- Сверление по центру: CYCLE81/82/83/84/85/89 через поддерживаемые общие осевые интерфейсы. Токарный MCALL и произвольные вызовы подпрограмм не реализованы.
- ISO-T: линии/дуги, подачи/шпиндель, WCS и резьба G32/G33 в выбранной системе A/B. Токарные циклы ISO и возврат G28 пока не поддержаны.

Оба CAM-файла в `tests/fixtures/turning/sinumerik` доходят до M30. Оба содержат CYCLE95 и CYCLE97; второй раскрывает сверление и не является независимым полностью раскрытым эталоном токарки. Размеры циклов и врезания проверяются отдельными численными тестами. Нормализация FULL и нативный выходной пост Siemens для токарки не реализованы; EXPANDED сохраняет прежние ограничения предварительной проверки, включая запрет native CSS. Для сохранения нативной УП используйте сохранение исходного документа.

Интерфейсы сверены с [руководством Siemens 840D](https://cache.industry.siemens.com/dl/files/510/28713510/att_53953/v1/PGK_1000_en.pdf) и [совместимыми токарными циклами Siemens](https://cache.industry.siemens.com/dl/files/300/109751300/att_931853/v1/808D_808D_ADV_turning_op_man_0917_en-US.pdf).

**Граница проверки CYCLE95:** при активном D и настроенном ненулевом радиусе вершины `UNVERIFIED_SINUMERIK_CYCLE95_NOSE_COMPENSATION` обозначает расчёт номинального контура без автоматической коррекции стойки. Достижение M30 не подтверждает эквивалентность расчёту контроллера. Текущая модель масштабирует FALX через активный диаметральный режим (DIAMON FALX=0.2 добавляет 0,1 мм по радиусу) и равномерно распределяет параксиальные врезания; соответствие припусков и планирования проходов стойке ещё требует независимой проверки с известными данными инструмента. DXF другого бэкплоттера служит материалом для сравнения, а не нормативным эталоном Siemens, и сам по себе не определяет, какая модель верна.

Само предупреждение CYCLE95 о коррекции вершины не блокирует EXPANDED. Native CSS и другие ограничения предварительной проверки могут независимо отклонить экспорт; успешный экспорт не является дополнительной проверкой геометрии цикла.

Нативная/ISO-T токарка принимает только моделируемое подмножество M-функций; неизвестные M-коды останавливают исполнение, в отличие от политики вспомогательных предупреждений фрезерования. Контакт с заготовкой на G0 и токарная симуляция используют тот же trace и не подтверждают семантику циклов независимо.

---

## Ввод HEIDENHAIN iTNC 530

HEIDENHAIN — отдельный входной язык, а не вариант FANUC/SINUMERIK. Файлы `.h`/`.H` — либо вставленный текст, содержащий `BEGIN PGM ... MM/INCH`, — выбирают native-исполнение фрезерования (`fanuc_mill` с `source_dialect=heidenhain`). Тип исходника **iTNC-code** включает его вручную и подсветку Klartext. Разбор строит неизменяемый native AST с невычисляемыми выражениями Q/QL/QR, отдельными картами числовых и именованных меток и физическими позициями в исходнике; исполнитель работает с этим AST напрямую и никогда не понижает команды до ISO.

Область применения — **трёхосевые CAM-контуры, ограниченные параметрические программы, индексирование 3+2 и TCP на настроенных столах AC/BC**. Неподдержанная семантика не пропускается молча: расчёт останавливается на исходном кадре с диагностикой и сохраняет корректную часть траектории. Структурированные результаты и отчёты CLI/batch показывают `source_dialect=heidenhain` независимо от общего геометрического языка `fanuc_mill`.

Для A/B/C и PLANE необходимо выбрать профиль кинематики, даже при нулевых углах. `PLANE SPATIAL SPA/SPB/SPC` задаёт повороты вокруг фиксированных осей: `Rz(SPC) Ry(SPB) Rx(SPA)`. STAY меняет координаты без индексирования; TURN решает направление оси инструмента для настроенного профиля с двумя поворотными осями, с выбором ветви SEQ+/SEQ−. PLANE RESET отменяет наклонную плоскость. MOVE и TABLE COORD не поддерживаются. `M128/M129` включают/отменяют управление логической вершиной инструмента на столах AC/BC при сброшенной PLANE. Поддерживаются `FUNCTION TCPM F TCP AXIS POS PATHCTRL AXIS` и `FUNCTION RESET TCPM`. Непрерывные поворотные перемещения требуют кадров L и активного TCP. `M126/M127` включают/отменяют кратчайший поворот; `M94` приводит отображаемые углы. Длины физических центров поворота и ходы станка не моделируются.

Неизменённый проект для трёх стоек хранится в `tests/fixtures/milling/test_5ax/1001.nc`, `1001.mpf` и `1001.h`. Все три УП доходят до M30 с профилем `5ax_table_ac` и Home Z=100. Тесты сравнивают все 1182 нормализованных рабочих участка, центры и промежуточные точки дуг, подачи, инструменты и направления оси инструмента в начале/конце. Допуск координат — 0,002 мм с учётом округления постпроцессорами. Ускоренные перемещения и отводы Home проверяются отдельно от рабочей геометрии. GPU-симуляция съёма материала остаётся трёхосевой.

### Что входит в поддержку HEIDENHAIN?

| Native-функция | Текущее поведение |
| --- | --- |
| `BEGIN/END PGM`, `MM/INCH`, `BLK FORM 0.1/0.2` | Метаданные программы/единиц и границы заготовки; координаты и подачи приводятся к миллиметрам |
| `L` и прямолинейные кадры без `L` | Перемещения XYZ с инкрементными `IX/IY/IZ` и `F`/`FMAX`/`FAUTO`, `R0/RL/RR` |
| `CC`, `C`, `CR`, `CT` | Центр окружности и полные/частичные дуги с `DR+`/`DR-`, дуги по радиусу и касательные; для круговых перемещений требуется явное направление |
| `LP`, `CP` | Полярное позиционирование и полярное/винтовое круговое движение с `PR/IPR/PA/IPA` |
| `APPR/DEP LT/LN/CT/LCT` | Линии и касательные дуги подхода/отхода к плоскому контуру |
| `TOOL CALL`, `TOOL DEF` | Числовые, именованные и Q-инструменты, ось шпинделя X/Y/Z, `S`/`F`; коррекции `DL/DR/DR2` разбираются, но останавливают расчёт |
| `M0/M1/M2/M3/M4/M5/M6/M8/M9/M13/M14/M30` | Логические сигналы/состояние шпинделя и конец программы; `M99` вызывает активный цикл. Остальные M-слова останавливают расчёт |
| `M91` | Непозиционное абсолютное машинное XYZ с учётом настроенного WCS |
| `Q/QL/QR`, `FN 0–4/6/7`, выражения | Ограниченная арифметика, сравнения, тригонометрия и деревья функций без `eval`; QL-локальные значения сохраняются при вызовах меток |
| `LBL`, `CALL LBL`, `REP`, `FN 9–12` | Числовые и именованные метки, стек вызовов, повторы и условные `GOTO`; неопределённые/дублирующиеся метки и неверный LBL 0 диагностируются |
| `CYCL DEF`/`CYCL CALL` | Цикл 32 — только метаданные; циклы сверления/растачивания/резьбы 1/2, 200–209 и 240/241 разворачиваются в физическую геометрию; 251/252 выполняют фрезерование карманов, 262 — резьбофрезерование; 220/221 выполняют образцы расположения при определении; цикл 9 — выдержка; неподдержанные коды циклов останавливают расчёт |
| Q-параметры циклов | Физические кадры-продолжения `Q...=` сохраняются в AST и используются `CYCL CALL` в порядке исполнения. `MAX`/`FMAX` для Q208/Q253 — специальная подача, а не числовое выражение: быстрый отвод Q208 в циклах 202/203, быстрое предварительное позиционирование Q253 в циклах 204/205/241/262. Обязательные Q-параметры циклов 220/221/251/252/262 задаются явно |
| Выбор начала координат, цикл 247 | Привязка приложения: `Q339=1..6` выбирает настроенные смещения G54..G59 в миллиметрах. Машинное положение инструмента сохраняется; другие номера не поддержаны. Таблица preset реальной стойки не импортируется |
| Циклы 7/10 | Смещение начала координат адресами осей и плоский поворот XY (`ROT`) действуют сразу без перемещения инструмента; нулевые значения отменяют преобразование. Координаты и центры дуг преобразуются в машинную траекторию; таблицы начал координат и наклонные плоскости не поддержаны |
| `M140 MB расстояние`, `M140 MB MAX` | Отвод идёт по физической машинной +Z до позиционирования, с отдельной подачей. Настроенная кинематика стола преобразует этот отвод через ориентацию стола, в том числе при наклонной системе координат программы. MAX требует включённую эмуляцию Home и использует Z из Home (G28) в WCS только в положительном направлении, с предупреждением. Физические пределы ходов станка не моделируются; приближение MAX блокирует экспорт NC-траектории |
| `F0`, повторные адреса подачи | Геометрия сохраняется; F0 выдаётся предупреждением вместо придумывания подачи; при повторении учитывается последнее значение |
| Необязательные кадры `/` и номера строк | Сохраняются физические исходные строки и признаки пропуска; номера кадров не считаются метками подпрограмм `LBL` |
| `RND R… [F…]`, `CHF … [F…]` | Реальные касательные дуги/фаски с обрезкой соседей до существующей RL/RR-коррекции; временная подача, плоские углы и явная диагностика ограничений. |
| Поворотные `A/B/C`, PLANE SPATIAL/RESET, M128/M129 | Индексирование с настроенной кинематикой, наклонные плоскости и TCP столов AC/BC, как описано выше; неподдержанные сочетания останавливают расчёт |
| `M120`, вспомогательные `U/V/W`, корректировки инструмента DL/DR/DR2 | Не исполняются; расчёт останавливается на кадре |
| FULL-форматирование | Для Klartext отклоняется; EXPANDED и сохранение исходника остаются доступны |

### Какие циклы карманов и резьбофрезерования поддерживаются?

Входной исполнитель выполняет документированные подмножества **251 «Прямоугольный карман»**, **252 «Круглый карман»** и **262 «Резьбофрезерование»**. При исполнении они разворачиваются в геометрию траектории; это не означает сохранение определений этих циклов выходным постом.

| Цикл | Поддерживаемая геометрия и параметры |
| --- | --- |
| 251 | Прямоугольный карман: размеры Q218/Q219, радиус углов Q220, поворот Q224 и положение опорной точки Q367 |
| 252 | Круглый карман диаметром Q223 |
| 262 | Внутренняя резьба: номинальный диаметр Q335, шаг со знаком Q239, глубина Q201, стратегия Q355 и направление фрезерования Q351 |

В циклах 251/252 Q215=0 задаёт черновую и чистовую обработку, Q215=1 — только черновую, Q215=2 — только чистовую. Q202 задаёт шаг по глубине при черновой обработке, Q338 — при чистовой обработке стенок. Q368/Q369 — припуски на стенки/дно; Q370 задаёт поперечный шаг в долях радиуса фрезы. Q206, Q207 и Q385 задают подачи врезания, фрезерования и чистовой обработки. Q351 выбирает попутное/встречное фрезерование с учётом M3/M4.

Q366=0 выбирает вертикальное врезание, Q366=1 — винтовое; цикл 251 также принимает Q366=2 для маятникового врезания при достаточном свободном месте. Для винтового/маятникового чернового врезания необходимо явно задать инструменту `ANGLE` (или `plunge_angle`) в градусах между 0 и 90. Угол по умолчанию не подставляется. Вертикальное врезание и режим только чистовой обработки этого угла не требуют.

В цикле 262 Q355=0 строит один полный винтовой оборот для многорядной фрезы; Q355=1 — непрерывную винтовую траекторию на всю глубину; большие целые значения — отдельные полные обороты со смещением по оси на Q355 шагов резьбы. Знак Q239 выбирает правую/левую резьбу. Круговые подводы/отводы и многовитковые винтовые движения сохраняются аналитически. Диаметр фрезы должен быть не меньше четверти номинального диаметра резьбы и меньше него; стратегия с боковым перепозиционированием для меньшей фрезы не поддержана. Q253 принимает положительную числовую подачу предварительного позиционирования либо `MAX`/`FMAX`; Q207 требует положительную числовую рабочую подачу.

Эти три цикла требуют рабочую плоскость XY с осью шпинделя Z, R0, известное направление шпинделя M3/M4 и настроенную геометрию фрезы. Тип и диаметр инструмента в миллиметрах передаются через существующий API исполнения `milling_tools` или `tool_resolver`; один `TOOL CALL` не задаёт диаметр или угол врезания. Внешняя таблица инструмента стойки автоматически не импортируется. Размеры в УП следуют единицам MM/INCH.

Все обязательные Q-параметры должны быть заданы явно. PREDEF, зависимые от OEM значения по умолчанию и символические автоматические рабочие подачи здесь не поддержаны. Q201=0 пропускает обработку; положительная глубина диагностируется, поскольку её трактовка зависит от OEM-параметра MP7441. Неподдержанные параметры, стратегии врезания и недостаточное место для фрезы останавливают расчёт с диагностикой. Реализация ограничена указанной геометрией и не заявляет совпадения всех внутренних проходов со стойкой.

### Как исполняются циклы расположения 220 и 221?

**220 «Образец на окружности»** и **221 «Образец на линиях»** активны по определению (DEF-active): они выполняются при достижении последнего кадра-продолжения Q-параметров своего определения. Сначала задайте технологический цикл (поддерживаемый цикл сверления/растачивания/резьбы либо 251, 252, 262), затем образец расположения. Дополнительный `CYCL CALL` для запуска образца не нужен. После выполнения прежний технологический цикл остаётся активным.

- Цикл 220: Q216/Q217 — центр, Q244 — диаметр, Q245/Q246 — начальный/конечный углы, Q247 — угловой шаг, Q241 — число позиций. При Q247=0 позиции распределяются по полной окружности или неполному сектору. Q365 выбирает прямолинейный или круговой переход.
- Цикл 221: Q225/Q226 — начало, Q237/Q238 — шаги, Q242/Q243 — число столбцов/строк, Q224 — поворот. Соседние строки проходятся в противоположных направлениях.
- Q200/Q203/Q204 задают общие безопасные расстояния и координату поверхности. При Q301=0 переходы между обработками идут на первом безопасном расстоянии, при Q301=1 — на втором. Параметры образца задаются явно, требуется R0. Для вложенного технологического цикла сохраняются его ограничения по плоскости и инструменту.

### Как сохраняются исходник Klartext, параметры и диагностика?

Публичная точка разбора — [`parse_heidenhain_program(source)`](app/gcode/kernel/frontend/heidenhain.py). Каждая физическая строка, включая комментарии, пустые строки, необязательный `/` и числовые префиксы кадров, остаётся исходным `Block` с текстом и позициями. `Block.native_syntax` и неизменяемый AST содержат типизированные команды Klartext, выражения, параметры M-функций (в том числе типизированные параметры `M120 LA`/`M140 MB` и отдельную подачу отвода `M140`) и продолжения Q-параметров циклов; синтетические FANUC G-слова, ISO-перемещения и узлы Macro B не создаются. Python- и Cython-сборщики AST формируют одинаковые native-узлы.

При разборе Q-выражения превращаются в деревья **без вычисления значений**; отдельный исполнитель затем вычисляет поддерживаемую арифметику, функции и присваивания без Python `eval`. Диапазоны: `Q0–Q1999`, `QL/QR0–499`. Номера кадров и числовые/именованные `LBL` имеют отдельные карты; `LBL 0` означает возврат, дублирующиеся и неразрешённые статические метки диагностируются. Активные определения циклов устанавливаются в порядке исполнения, а не предполагаются по лексической ссылке `CYCL CALL`. Парсер не придумывает отсутствующие параметры циклов; поддерживаемые значения по умолчанию определяются только при исполнении. Неподдержанные варианты PLANE и `FN 18` останавливают исполнение вместо построения движений.

Синтаксическая ошибка содержит физическую строку, столбец, исходный текст и код диагностики. При исполнении движения и шаги сохраняют привязку к исходным кадрам; неподдержанная операция останавливает расчёт на ошибочной строке с сохранением корректной части траектории. К native Klartext применяются также лимиты ресурсов и кооперативная отмена. Общий `fanuc_mill` предоставляет геометрический контракт, а `source_dialect=heidenhain` выбирает независимый исполнитель.

### Какие инструменты редактора и варианты экспорта доступны для iTNC?

Фильтр **Открыть документ** включает `.h`/`.H`; тип **iTNC-code** включает подсветку Klartext с настроенными шрифтом, цветами и темой редактора. Калькуляторы отверстий и карманов генерируют native-фрагменты со знаковыми координатами `L`/`CR` и, где применимо, винтовым входом `CC`/`CP`, а не ISO-фрагменты через постпроцессор. **Перенумерация** записывает числовые префиксы без `N`, допускает начало с нуля, сохраняет `/` и работает с выделением; удаление номеров тоже учитывает формат Klartext.

Обычное **Сохранение** оставляет исходник. Форматирование **FULL** для Klartext отклоняется; **EXPANDED** использует отдельный выходной пост `heidenhain_itnc530` и рассчитанную траекторию. Он может выводить `BEGIN/END PGM`, `TOOL CALL`, `L/FMAX`, `CC` с `C/CP`, `CR` и `CYCL DEF 200/201/202/203/207`. Возможности этого поста **не означают**, что все его команды поддерживаются отдельным входным исполнителем. Выходной пост iTNC ограничен поддерживаемой трёхосевой геометрией; наличие пятиосевого native-ввода не означает поддержку пятиосевого вывода Klartext.

### Чем проверена реализация iTNC?

Скругления RND и фаски CHF реализованы по руководству iTNC 530 737759-23, разделам 5.3, 6.3–6.4, страницам 237–238 и 244. Сначала строится запрограммированный контур со скруглениями и фасками, затем к нему применяется существующая коррекция RL/RR. Построение подводов и отводов APPR/DEP сохраняется.

- `RND R… [F…]` обрезает два соседних элемента контура и вставляет касательную дугу скругления. Поддерживаются сочетания прямая–прямая, прямая–дуга, дуга–прямая и дуга–дуга, если локальное решение однозначно.
- `CHF … [F…]` обрезает две прямые и соединяет их фаской. Заданное число — отступ вдоль каждой соседней прямой, а не длина диагонали фаски. Например, на прямом угле `CHF 10` даёт диагональ примерно 14,142 мм в программе с единицами MM.
- Подача `F` в кадре RND/CHF действует только на вставленную дугу или фаску; соседние участки сохраняют свою подачу.
- Поддерживаются R0/RL/RR, рабочие плоскости XY/XZ/YZ и единицы программы. Для RND без коррекции предыдущий кадр контура должен содержать обе координаты рабочей плоскости.

Например, при отключённой коррекции этот контур скругляет угол X20 Y0 радиусом 5 мм в программе MM:

```text
L X0 Y0 R0 F100
L X20 Y0
RND R5 F50
L X20 Y20 F100
```

Дуга начинается в X15 Y0 и заканчивается в X20 Y5, её центр — X15 Y5. Только скругление выполняется с F50. Если заменить `RND R5 F50` на `CHF 5 F50`, точки X15 Y0 и X20 Y5 соединит прямая фаска.

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

Численные проверки контролируют точки касания, радиусы, непрерывность, коррекцию, единицы, связь движений с исходными кадрами и локальные подачи. Для эталона с шестью скруглениями `6bas154.h` явно задаётся T4 диаметром 6 мм: R3 у APPR/DEP не определяет геометрию фрезы. `manual_chf.h` воспроизводит пример LINEAR из руководства. Проверки подтверждают описанный набор возможностей, а не полное соответствие всем функциям стойки.

Циклы 252 и 262 теперь имеют описанную выше ограниченную реализацию. Их наличие в `fusion_benchmark.h` не гарантирует завершение всей CAM-программы: каждый набор параметров, настройка инструмента и остальные команды должны соответствовать поддерживаемым возможностям. При остановке сохраняется только корректная часть траектории.

Короткие примеры циклов собраны в [`heidenhain/cycles/`](tests/fixtures/milling/heidenhain/cycles/) из станочных программ и руководства по циклам. Эти примеры не являются независимо подтверждёнными эталонами траекторий стойки.

13 программ контурного фрезерования и сверления из `tests/fixtures/milling/heidenhain/` входят в регрессии исполнения и открытия/построения в Qt при включённой эмуляции Home. Для `6bas154.h` отдельно задаётся T4 Ø6: R3 у APPR/DEP не определяет радиус инструмента. Шесть RND этого примера и фаски официального `manual_chf.h` проверяются численно. Исходный `cycles_itnc530.h` без изменений доходит до M30 и выполняет восемь отверстий; `itnc530_cycl200macro.h` выполняет десять отверстий с тригонометрическими присваиваниями FN 6/7; `ellipse.h` завершает 40 шагов контура со смещением циклом 7 и плоским поворотом циклом 10. Отвод MAX берёт Z из Home (G28) в WCS, выдаёт `HEIDENHAIN_M140_HOME_EMULATION` и блокирует экспорт NC-траектории. При отключённой эмуляции Home расчёт MAX останавливается с диагностикой. Цикл 247 связывает номера 1–6 с G54–G59. Перемещения, центры дуг и операции сверления используют машинные координаты.

В [`tests/fixtures/milling/heidenhain/`](tests/fixtures/milling/heidenhain/) сохранены реальные CAM- и параметрические программы. Тесты [`test_heidenhain_frontend.py`](tests/dialects/test_heidenhain_frontend.py) и [`test_heidenhain_execution.py`](tests/dialects/test_heidenhain_execution.py) проверяют AST, физические позиции, Q-продолжения циклов, соответствие Python/Cython AST, диагностику, отмену и связи исходника с движениями. Малые примеры AST находятся прямо в тестах. Полная фикстура `sample.h` доходит до `M30`; сглаживание Cycle 32 и `F0` вызывают явные предупреждения. В корпус также входят десятичная запятая и `STOP M30` в `sample_cr.h`, повторные подачи и определение плоскости дуги по `CC` в `arcs.h`. Для подсветки GUI, калькуляторов, перенумерации и поста экспорта есть отдельные тесты. Это не подтверждает полного моделирования стойки или физического станка iTNC 530.

Руководство по циклам: [iTNC 530 34049x-06, Cycles, 670388-21](https://content.heidenhain.de/doku/tnc_guide/pdf_files/iTNC530/34049x-06/zyklen/670_388-21.pdf), в том числе 220/221, 251/252 и 262.

Справочники синтаксиса HEIDENHAIN: [Klartext programming](https://content.heidenhain.de/doku/tnc_guide/pdf_files/iTNC530/34049x-neu/en/bhb.pdf) и [iTNC 530 60642x-03](https://content.heidenhain.de/doku/tnc_guide/pdf_files/iTNC530/60642x-03/bhb/737759-22.pdf).

---

## CLI

**Открытие текущего документа в терминале:** выберите **Файл → Открыть в CLI** или нажмите **Ctrl+Alt+T**. Эта же команда доступна на панели инструментов Файл, в настройках панелей инструментов и в редакторе горячих клавиш. Несохранённый документ сначала нужно сохранить; отмена оставляет документ без изменений. Отдельный терминал открывается в папке УП и ждёт ввода: команды CLI автоматически не запускаются. Сокращение оболочки `egp` передаёт аргументы непосредственно существующему CLI. Цветная эмблема и короткие подсказки показывают `egp --help`, анализ папки через `egp batch` и пакетный экспорт DXF через `egp batch-export`. В примерах используется текущая папка (`.`) и поддерживаемые настройки документа; введите или скопируйте команду для запуска.

В **Настройки → Опции → Общие → Терминал CLI** можно указать путь к исполняемому файлу терминала. Пустое поле включает автоматический поиск. В Windows поддерживаются Windows Terminal, PowerShell и cmd; сеанс работает в PowerShell. В Linux поддерживаются распространённые терминалы, включая GNOME Terminal, Konsole, XFCE Terminal и xterm; для сеанса используется Bash. В готовой сборке расположите `easy_gcode_plot_cli.exe` (Windows) или `easy_gcode_plot_cli` (Linux) рядом с GUI либо добавьте CLI в PATH. При запуске из исходников используются консольный Python текущего окружения и `cli_main.py`.

Передаются текущий язык обработки, кодировка, система токарных G-кодов FANUC, вариант циклов SINUMERIK и профиль фрезерной кинематики. Передаются только существующие параметры CLI: настройки WCS/Home, библиотек инструментов, коррекции и отображения из GUI не копируются. Определение диалекта по файлу и ограничения экспорта CLI сохраняются. Пакетные команды обрабатывают указанную папку, а не список буферов MDI. Терминал и выполняемые команды остаются независимыми после закрытия GUI.

### Использует ли CLI то же ядро, что и GUI?

Да.

Автономный CLI — это интерфейс над теми же модулями парсера, среды выполнения Macro B, машинного выполнения, циклов, компенсации и экспорта.

### Какие команды существуют?

Текущие команды:

```text
parse
trace
analyze
batch
export
batch-export
```

### Что делает `parse`?

`parse` выполняет одну программу через обычное ядро и выводит читаемую сводку инструкций, движений и диагностики.

Пример:

```powershell
.\easy_gcode_plot_cli.exe parse program.nc --lang fanuc_turn
```

### Что делает `trace`?

Пути JSON и HTML должны отличаться от исходной УП и друг от друга, включая ссылки на один файл. Совпадения отклоняются до записи. Ошибки чтения, кодировки и записи возвращают код 2 с сообщением. JSON записывается атомарно. Экспорт программы и Tool List из GUI также запрещает использовать открытую УП как файл назначения; для сохранения изменений исходника используйте Save/Save As.

`trace` выполняет одну программу и может записать подробный JSON, включая рассчитанные движения.

```powershell
.\easy_gcode_plot_cli.exe trace program.nc --lang fanuc_turn -o trace.json
```

### Что делает `analyze`?

Экспортированный HTML-отчёт всегда светлый. Окно Statistics следует теме приложения. Экспорт отчёта и программы из GUI показывает уведомление об успехе или ошибке записи. Tail-подсветка выделяет текущий логический кадр, включая все сегменты дуги, цветом текущего движения из Options; она работает при движении ползунка назад и при проигрывании Stock Removal.

`analyze` выполняет одну программу и выводит статистику траектории и диагностику. С `-o` он записывает JSON анализа.

```powershell
.\easy_gcode_plot_cli.exe analyze program.nc --lang fanuc_mill -o analysis.json
```

### Что делает `batch`?

`batch` анализирует каждый обнаруженный файл NC в каталоге и записывает отчёты JSON/CSV.

Добавьте `--html C:\Reports\html`, чтобы сохранить отдельный отчёт статистики с выбором инструмента и статичной SVG-проекцией XY/XZ для каждого файла через тот же API, что одиночный `analyze`. Подкаталоги и полные имена сохраняются; `--inches` меняет единицы отчёта. Без `--lang` расширения `.mpf/.spf` выбирают токарный SINUMERIK при наличии нативных токарных команд, иначе фрезерование; остальные файлы сохраняют токарный режим по умолчанию. Явный `--lang` задаёт режим для всей папки.

```powershell
.\easy_gcode_plot_cli.exe batch C:\Programs --lang fanuc_mill -o C:\Reports
```

### Что делает `export`?

`export` выполняет один файл и отправляет его через общую службу экспорта NC/DXF.

```powershell
.\easy_gcode_plot_cli.exe export program.nc --lang fanuc_turn -o expanded.nc
```

### Что делает `batch-export`?

`batch-export` обнаруживает дерево каталогов и вызывает ту же службу экспорта одного файла для каждой входной программы.

Для индексированных программ A/B выберите профиль с `--kinematics PROFILE_ID`, когда все файлы используют один станок, или передайте `--kinematics-map profiles.json` для разных станков. И `batch`, и `batch-export` принимают эту карту. Это объект JSON с путями относительно входного каталога и идентификаторами профилей, например `{"a.nc":"PROFILE_ID_A","sub/b.nc":"PROFILE_ID_B"}`. Без профиля выполнение завершается с `ROTARY_KINEMATICS_REQUIRED`. Для EXPANDED с поворотными осями нужен многоосевой целевой пост; геометрия, которую нельзя реконструировать, отклоняется. FULL сохраняет исходные поворотные команды и применяет поддержанную текстовую нормализацию. DXF использует рассчитанную геометрию и выбранный профиль.

```powershell
.\easy_gcode_plot_cli.exe batch-export C:\Programs --lang fanuc_mill -o C:\Normalized
```

### Являются ли одиночный экспорт и пакетный экспорт разными экспортёрами?

Нет. Они используют один и тот же `ExportRequest`, проверку и конвейер `export_file()`.

Экспорт каталога — это оркестрация вокруг службы одного файла.

### Какие имена диалектов используются?

```text
fanuc_turn
fanuc_mill
```

Отдельного значения `sinumerik` для `--lang` нет. Контейнер MPF/SPF определяется по расширению независимо от содержимого. Геометрическую модель выбирают `--lang fanuc_mill` или `--lang fanuc_turn`; без явного выбора однозначные нативные токарные команды включают токарку, остальные MPF/SPF используют фрезерование.

### Какие коды выхода?

Нормальное успешное/приемлемое выполнение CLI возвращает ноль. Неудачное/неполное одиночное выполнение, пакетные `ERRORS`, пакетные `NO_FILES` и ошибки экспорта возвращают ненулевой код (в настоящее время 2 для ошибок уровня команды).

### Как увидеть все параметры и значения по умолчанию?

Используйте:

```powershell
.\easy_gcode_plot_cli.exe --help
```

или справку по конкретной команде, например:

```powershell
.\easy_gcode_plot_cli.exe batch-export --help
```

Справка верхнего уровня также выводит разделы справки подкоманд.

---

## Пакетный анализ

### Что проверяет пакетный анализ?

Каждый найденный файл анализируется тем же способом, что и при одиночной команде `analyze`.

Отчёты по файлам включают:

- статус;
- `ok` / `complete`;
- размер файла и количество строк;
- количество движений;
- количество выполненных блоков;
- количество диагностик;
- неподдерживаемые G-коды;
- неподдерживаемые M-коды;
- полные записи диагностики;
- прошедшее время.

Для поворотного фрезерования JSON-отчёты записывают `kinematics_definition` и `kinematics_fingerprint` (SHA-256) фактически использованного профиля, включая нормализованные оси стола/головы и их порядок. CSV содержит то же определение в формате JSON. Один ID профиля не гарантирует одинаковый расчёт при разных пользовательских переопределениях; отчёт не перечитывает каталог после выполнения.

### Какие статусы пакета существуют?

```text
CLEAN
WARNINGS
ERRORS
NO_FILES
```

`CLEAN` означает, что диагностика не выдавалась.

`WARNINGS` означает, что выполнение допустимо/полно, но диагностика остаётся.

`ERRORS` означает, что хотя бы один файл недопустим/неполон или содержит диагностику уровня ошибки.

`NO_FILES` означает, что обнаружение не нашло подходящих программ.

### Какие расширения сканируются по умолчанию?

```text
.nc
.cnc
.ptp
.mpf
.spf
.tap
.txt
```

Сканирование рекурсивное, если не указан `--top-level-only`.

### Могут ли быть обнаружены файлы без обычного расширения NC?

Да, когда используется набор расширений по умолчанию. Сканер также распознаёт вероятные текстовые программы ЧПУ, в начале которых обнаруживается заголовок O-программы или несколько блоков с G/M-кодами.

Файлы, определённые как бинарные, не рассматриваются как текст NC.

### Детерминировано ли обнаружение?

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

### Можно ли ограничить расширения?

Да:

```powershell
--extensions .nc,.tap
```

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

### Какие данные сводятся в итоговый отчёт?

Отчёт агрегирует:

- количество статусов файлов;
- общее количество диагностик;
- общие суммы ошибок и предупреждений;
- частоты кодов диагностики;
- количество вхождений/файлов неподдерживаемых G-кодов;
- количество вхождений/файлов неподдерживаемых M-кодов;
- общее прошедшее время.

### Какие файлы записываются?

Имена отчётов по умолчанию:

```text
batch_report.json
batch_report.csv
```

CSV — UTF-8 с BOM для удобного открытия в электронных таблицах.

### Останавливает ли плохой входной файл весь пакет?

Ошибка чтения/декодирования становится `FILE_PROCESSING_ERROR` для файла, и обработка продолжается.

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

### Существуют ли предустановленные пакетные скрипты?

Отдельных предустановленных скриптов для обычного `batch`-анализа больше нет. Запускайте CLI напрямую, явно задавая исходный каталог и каталог отчёта.

---

## Пакетный экспорт

### Какую проблему решает пакетный экспорт?

`batch-export` применяет один проверенный контракт экспорта ко всему дереву каталогов.

Типичные применения включают:

- раскрытие выполнения;
- нормализацию номеров последовательности;
- добавление/удаление пробелов;
- удаление комментариев;
- преобразование единиц поддерживаемых программ между мм и дюймами;
- изменение представления дуг фрезерования;
- генерацию каталога траекторий DXF.

### Изменяет ли пакетный экспорт входные файлы?

Нет. Выходной каталог должен быть отдельным каталогом.

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

### Сохраняется ли иерархия исходных каталогов?

Да.

Пример:

```text
input/
  part1.nc
  machine_a/
    part2.tap
```

Вывод NC становится:

```text
output/
  part1.nc
  machine_a/
    part2.nc
```

Вывод DXF использует `.dxf`.

### Что происходит, если два исходных имени отображаются в одно выходное имя?

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

### Останавливает ли одна ошибка экспорта все файлы?

Обычные ошибки чтения/экспорта/значения для файла становятся записью `ERRORS`, и обработка продолжается.

Успешно выполненный файл с диагностикой экспортируется и помечается `WARNINGS` в соответствии с текущей политикой.

Выполнение, которое не является `ok` или не является `complete`, не создаёт выходной файл.

### Какие файлы описывают пакетный экспорт?

Корень вывода содержит:

```text
batch_export_report.json
batch_export_report.csv
```

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

### Какие статусы batch-export?

По файлу:

```text
EXPORTED
WARNINGS
UNSUPPORTED
ERRORS
```

В целом:

```text
CLEAN
WARNINGS
UNSUPPORTED
ERRORS
NO_FILES
```

### Какие режимы экспорта доступны из CLI?

Для NC есть два режима:

```text
expanded
full
```

DXF выбирается через `--format dxf`; параметры режима/форматирования, относящиеся только к NC, отклоняются при явной передаче.

### Какие параметры намеренно отклоняются в режиме Full Program?

Full Program не принимает явные:

- преобразование единиц, отличное от `auto`;
- выбор типа дуги;
- преобразование режима координат;
- управление модальной подачей.

Это сделано, чтобы не создавать ложного впечатления, будто такие преобразования семантически эквивалентны Expanded Execution. Параметры строки безопасности, текста начала/конца программы, нумерации кадров, разделителя и ведущего нуля FULL применяет, потому что они меняют оформление текста, а не геометрию.

### Можно ли задать начальный номер последовательности/приращение без номеров последовательности?

Нет. Явное начало, приращение или интервал последовательности требуют `--sequence-numbers`.

### Существуют ли предустановленные скрипты batch-export?

Да. В дереве разработки есть четыре конкретные проверки EXPANDED-конвертации для Windows и Linux:

```text
fanuc_mill_to_sinumerik_native
fanuc_mill_to_sinumerik_iso
fanuc_lathe_a_to_b
sinumerik_native_to_fanuc_mill
```

Они запускают собранный CLI с явным JSON-постпрофилем и пишут результат в `tmp/test_export`. Приложение они не пересобирают.

В Windows запускайте `.\scripts\ps1\batch\<имя>.ps1`, в Linux — `bash scripts/sh/batch/<имя>.sh`. Семантическая регрессия `tests/export/test_batch_export_semantics.py` повторно исполняет успешно экспортированные программы и сравнивает сигнатуры траекторий с исходными.

---

## Конфигурация

### Где хранится конфигурация приложения в Windows?

```text
%LOCALAPPDATA%\easy-gcode-plot\config.ini
%LOCALAPPDATA%\easy-gcode-plot\tools.db
```

Сниппеты используют собственное хранилище SQLite в Local AppData.

### Что хранится в `config.ini`?

Настройки приложения/UI включают, например:

- язык;
- тему;
- кодировку документа;
- настройки редактора;
- Auto Update;
- максимальное количество сгенерированных движений;
- параметры компенсации;
- допуск дуги и автоопределение дуг фрезерования;
- поведение Block Skip;
- цвета графика и отображение геометрии;
- настройки заготовки;
- скорость воспроизведения;
- горячие клавиши;
- стиль комментариев.

### Можно ли заменить `tools.db` старыми значениями JSON в config.ini?

Нет. Основной источник данных об инструментах — `tools.db`. Устаревший JSON в конфигурации не используется для записи изменений в текущую базу.

### Где находится файл журнала?

Когда логирование включено:

Включите **Logging** в Опциях; по умолчанию запись выключена. Журнал содержит открытие и сохранение NC, экспорт УП (формат, постпроцессор, кодировку, завершение, отмену и ошибки), экспорт списка инструментов и операции JSON для Current Program. Для фрезерного Stock Removal записываются границы при запуске, Accuracy, инициализация OpenGL, выделение текстур, время кадров и результаты экспорта STL. Содержимое файлов не записывается.

```text
%LOCALAPPDATA%\easy-gcode-plot\main.log
```

### Что добавляет логирование DEBUG?

Логирование DEBUG включает дополнительную информацию о выполнении, рендеринге, камере, параметрах и времени Stock Removal. Медленные кадры заготовки ограничиваются по частоте, чтобы логирование не создавало ещё более серьёзную проблему производительности.

---

## Устранение неполадок

### График пуст

Проверьте:

- выбранный режим станка;
- диагностику выполнения;
- конфигурацию WCS/домашней позиции;
- содержит ли программа поддерживаемое движение;
- не оставил ли предыдущий неподдерживаемый блок, изменяющий позицию, позицию неизвестной.

### Движение Macro B отсутствует

Проверьте первую диагностику. Распространённые причины включают:

- неопределённую переменную;
- отсутствующую метку GOTO;
- отсутствующую цель O-программы;
- несогласованный WHILE/END;
- ошибку аргумента G65;
- ограничение глубины вызовов/ресурсов.

Используйте Tokens/Variables, чтобы проверить состояние при соответствующем выполнении блока.

### Мои слова G65 M/S/T не запустили шпиндель/СОЖ/смену инструмента

Это сделано намеренно. В блоке G65 эти слова служат аргументами макроса, а не командами управления станком.

### Компенсация фрезы не видна

Убедитесь, что:

- G41/G42 активен;
- выбранный инструмент обнаружен или настроен;
- его геометрия допустима;
- тип контура поддерживается.

Проверьте диагностику на состояние компенсации `UNVERIFIED`.

### G43 присутствует в исходном коде, но отображаемый Z не включает длину инструмента

G43/G49 и H отслеживаются, но смещение длины инструмента пока не применяется к рассчитанной траектории.

### G71 оставляет материал не с той стороны

Проверьте знак припуска U второй строки и является ли контур наружным или внутренним. Проект намеренно сохраняет семантику знакового U.

### G72 Type II сообщает об ошибке

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

### G76 сообщает `UNSUPPORTED_G76_TOOL_ANGLE`

Упакованный угол P в настоящее время должен быть одним из:

```text
0, 29, 30, 55, 60, 80
```

### Пакет показывает `UNSUPPORTED_M_CODE`, но геометрия выглядит правильно

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

### Преобразование единиц экспорта отклонено

EXPANDED преобразует единицы по рассчитанной геометрии/состояниям, а не масштабирует исходный текст. Если экспорт отклонён, смотрите конкретную диагностику выполнения/постпроцессора (например, неподдерживаемая TWP/CYCLE800 или иная непроверенная геометрия, либо неполное выполнение). FULL намеренно поддерживает только `--units auto`.

### Batch-export сообщает, что выходной каталог недействителен

Корень вывода должен находиться вне дерева входного каталога. Это предотвращает обнаружение и повторный экспорт экспортированных файлов во время того же запуска.

### Большая программа не обновляется во время набора

Используйте Refresh. Auto Update не перестраивает траекторию при каждой правке, если превышен заданный порог дискретизации.

### GUI сообщает, что текущее выполнение устарело

Текст редактора изменился после создания отображаемого `ExecutionResult`. Обновите перед использованием информации, зависящей от выполнения, такой как Variables или экспорт.

---

## Разработка и архитектура

### Как организовано ядро ЧПУ?

Начиная с 2.2.1, публичный API координирует подготовку запроса (`api/execution_request.py`), выбор способа задания дуг и постобработку геометрии (`api/trace_geometry.py`). Контракты фрезерных блоков, правила стоек и публикация результатов разделены по модулям. Исторические точки входа сохранены. Геометрия траектории, дискретизация и статистика находятся в `app/gcode/trace/`; HTML/SVG/текстовые отчёты и шаблоны — в `app/gcode/reports/`. Подготовка выполнения, генераторы и пакетные сценарии имеют отдельные пакеты. Воспроизведение фрезерного съёма материала отделено от контрактов снимков состояния и сериализации mesh/STL. Эти архитектурные изменения сами по себе не меняют поддерживаемую семантику ЧПУ и сценарии GUI/CLI.

Важные пакеты:

```text
app/gcode/kernel/api/
app/gcode/kernel/frontend/
app/gcode/kernel/geometry/
app/gcode/kernel/runtime/
app/gcode/kernel/turning/cycles/
app/gcode/kernel/milling/
app/gcode/kernel/milling/cycles/
app/gcode/kernel/compensation/
```

### Что относится к `frontend/`?

Frontend владеет:

- удалением комментариев;
- лексированием слов;
- выражениями с учётом Macro B;
- разбором узлов потока;
- исходными блоками;
- построением AST/модели;
- ускорением нативного парсера.

Лексер учитывает скобки, поэтому имена функций Macro B и `GOTO` не читаются ошибочно как адресные слова ЧПУ.

### Что относится к `runtime/`?

Runtime владеет общими механизмами выполнения, такими как:

- поток Macro;
- локальная область G65;
- диспетчеризация M98/M99;
- проверка модальных групп;
- сигналы и структурные события;
- контракты циклов;
- ограничения ресурсов;
- построение трассы точения;
- оркестрация раскрытия циклов.

### Почему циклы точения — отдельные файлы?

Каждый крупный цикл имеет сфокусированную реализацию в `turning/cycles/`, в то время как общие механизмы диспетчеризации/раскрытия находятся в runtime. Это позволяет тестировать геометрию G70-G76 без построения одной монолитной функции интерпретатора.

### Что относится к `milling/`?

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

### Что относится к `compensation/`?

Компенсация радиуса вершины токарного резца и радиуса фрезы рассчитывается по уже определённым движениям.

Они не относятся к рендереру OpenGL.

### Что относится к `app/gcode/export/`?

Пакет намеренно небольшой:

- `common.py` — общие параметры, форматирование движений и масштабирование единиц;
- `full.py` — FULL-нормализация исходника по исходному тексту и карте исполнения;
- `expanded.py` — единый JSON-постпроцессор рассчитанной геометрии/состояний;
- `dxf.py` — геометрический DXF;
- `posts/*.json` — пять встроенных профилей стоек.

Оркестрация одиночного CLI-экспорта находится в `app/gcode/export/service.py`; `batch/export.py` применяет тот же контракт к дереву каталогов. Второго интерпретатора G-кода в экспорте нет.

### Что делает `execution/program.py`?

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

### Что делает `batch/analysis.py`?

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

### Что делает `batch/export.py`?

Это оркестрация каталога вокруг той же службы `export_file()`, используемой одиночным экспортом CLI.

### Какие нативные компоненты существуют?

Проект собирает нативные расширения для:

- разбора frontend;
- выбранных путей выполнения фрезерования;
- обнаружения инструментов;
- пересечения полигонов и заметаемого контура с профилем токарной заготовки.

Основой остаётся контракт Python. Регрессионные тесты проверяют совпадение нативной реализации и Python. `app.native` кэширует доступность parser/discovery/executor/turning_collision и причины ошибок импорта. Source-запуск допускает fallback; frozen-релиз требует все четыре расширения и явно отказывает при отсутствии расширения или ошибке загрузки DLL. Runtime build и установка зависимостей не выполняются.

Контроль столкновений G0 пересекает с материалом только новую заметаемую геометрию; существующие отметки обрезаются повторно при изменении затронутого материала. Сечения кэшируются по интервалам материала и границам профиля. Cython ускоряет пересечение выпуклых полигонов и существующий алгоритм пересечения контура с Z-сечением, сохраняя семантику съёма. Реальная УП `basic_turning_cycles.NC` используется для проверки совпадения Python/Cython, перемотки и относительной производительности.

`parser_statistics()` показывает total/native/fallback blocks последнего успешного разбора в текущем контексте по фактическим fallback callbacks. Необычные разделители строк и слишком длинные числовые слова используют reference parser для сохранения parity. Обычные LF/CRLF-программы сохраняют native scanner.

CLI parse/trace/analyze/batch не загружают ezdxf. DXF backend импортируется только при DXF export; его отсутствие даёт контролируемую ошибку экспорта.

### Как публично представлены результаты выполнения?

Ядро не импортирует Qt: пути пользовательских профилей определяет `app.paths`, а GUI-настройки остаются в `app.settings`. Парсер и выполнение не меняют глобальные настройки сборщика мусора; бюджеты выполнения привязаны к контексту вызова.

Источником данных являются разобранные объекты `Block`. Cython-конструктор строит `ProgramAst` и таблицы первых меток N/O за один проход; Python-путь соблюдает тот же контракт. Повторяющиеся неизменяемые слова используют ограниченный кэш в пределах построения. Native-парсер устанавливает полученный AST через внутренний конструктор без повторного построения; публичный `Program(blocks, ast)` проверяет его соответствие блокам. Узлы AST и слова неизменяемы, таблицы меток хранятся как неизменяемые защитные копии. Относительные проверки сравнивают построение AST и полный разбор через Cython и Python: `pytest tests/core/test_ast_acceleration.py -m performance` после сборки native-расширения. Приложение использует канонические модули frontend/API/runtime; исторические псевдонимы сохранены для внешней совместимости.

Основные неизменяемые публичные типы включают:

- `Diagnostic`;
- `SemanticInstruction`;
- `TraceMotion`;
- `ArcGeometry`;
- `MachineSignal`;
- `ExecutionEvent`;
- `ExecutionStep`;
- `ExecutionResult`.

### Что такое `ExecutionStep`?

Он записывает одно выполненное появление исходного блока и включает информацию, такую как:

- индекс исходного блока;
- количество выданных движений;
- масштаб единиц;
- режим диаметра/радиуса;
- состояние абсолютного/инкрементального;
- вычисленные слова;
- сигналы;
- позиция;
- активный WCS;
- состояние подачи/шпинделя;
- снимок переменных Macro B;
- события выполнения.

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

### Что такое `ExecutionEvent`?

События описывают структурные факты, которые не являются обычной геометрией, включая границы программы/подпрограммы, смены инструмента и возвраты в референсную точку.

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

### Как организованы тесты?

Тесты сгруппированы по доменам, включая:

```text
tests/core/
tests/dialects/
tests/stock/
tests/tooling/
tests/export/
tests/gui/
tests/render/
tests/meta/
```

Корпус фикстур содержит репрезентативные программы точения, фрезерования, Macro B, циклов, компенсации, WCS и экспорта.

### Как запустить основные проверки?

```bash
uv sync --group dev
uv run pytest
uv run ruff check .
uv run ruff format --check .
```

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

В Windows полный набор тестов и проверки проекта запускаются из корня репозитория:

```powershell
.\scripts\ps1\test.ps1
.\scripts\ps1\lint.ps1
```

| Задача | Windows PowerShell | Linux shell |
| --- | --- | --- |
| Тесты | `.\scripts\ps1\test.ps1` | `bash scripts/sh/test.sh` |
| Линтер | `.\scripts\ps1\lint.ps1` | `bash scripts/sh/lint.sh` |
| Нативные расширения | `.\scripts\ps1\build-native.ps1` | `bash scripts/sh/build-native.sh` |
| Упаковка PyInstaller | `.\scripts\ps1\build.ps1` | `bash scripts/sh/build.sh` |

Текст рабочего дерева использует CRLF, Bash-скрипты — LF. Правила задаются атрибутами Git и настройками VS Code. `.\scripts\ps1\lint.ps1 -Fix -CheckResources` нормализует текст и сгенерированные Qt-модули. Без `-Fix` линтер сообщает о неверных или смешанных окончаниях строк. Нормализация сохраняет кодировку и пропускает бинарные файлы и игнорируемые результаты сборки/временные файлы. В Git текст хранится с LF.

Новая семантика ЧПУ относится к `app/gcode/kernel/` и требует детерминированных регрессий. Экспортёры используют авторитетный результат исполнения. Разработка сайта описана в [руководстве по публикации](docs/PUBLISHING.md).

### Как запустить ежедневный GUI smoke-тест с видимым окном?

Готовые скрипты настраивают окружение автоматически: `scripts\ps1\start-sandbox.ps1` для Windows или `bash scripts/sh/start-sandbox.sh` для Linux/macOS. По умолчанию запускается визуальное demo. Для режима offscreen используйте `-Automated` / `--automated`, для темпа демонстрации — `-DelayMs 1500` / `--delay-ms 1500`. PowerShell-скрипт восстанавливает прежние переменные окружения; Bash-скрипт задаёт их только дочернему процессу.

Обычный автоматический sandbox запускается из корня репозитория в PowerShell:

```powershell
.\scripts\ps1\test.ps1 tests/gui/test_daily_workflow_smoke.py -q -s
```

Для визуального demo с паузами включите платформу Windows и режим демонстрации:

```powershell
$env:QT_QPA_PLATFORM = "windows"
$env:EASY_GCODE_SMOKE_DEMO = "1"
try {
    .\scripts\ps1\test.ps1 tests/gui/test_daily_workflow_smoke.py -q -s
}
finally {
    Remove-Item Env:QT_QPA_PLATFORM -ErrorAction SilentlyContinue
    Remove-Item Env:EASY_GCODE_SMOKE_DEMO -ErrorAction SilentlyContinue
}
```

Одна переменная `QT_QPA_PLATFORM=windows` показывает окно, но не включает паузы и итоговый demo-диалог. По умолчанию `EASY_GCODE_SMOKE_DELAY_MS` равен 1000 мс: действия показываются 1 секунду, основные этапы и диалоги — 2 секунды, итог — 4 секунды. Темп можно изменить:

```powershell
$env:EASY_GCODE_SMOKE_DELAY_MS = "1500"
```

В обоих режимах выполняются одинаковые проверки. Используются существующие файлы без переноса или изменения:

- FANUC milling: `tests/fixtures/milling/fanuc/flange_plate_benchmark.nc`, без STL; тёмная тема, сетка/цвета и сохранение настроек, Statistics с выбором инструмента и HTML с SVG, экспорт Expanded FANUC с повторным исполнением ядром. Толщина линии сохраняется.
- FANUC turning: `tests/fixtures/turning/lathe_cycles_example.nc`; G71/G76 и настоящий Stock Removal с детерминированной перемоткой. Геометрия из библиотеки по совпадающему номеру приоритетнее автоматического распознавания.
- SINUMERIK 3+2: `tests/fixtures/milling/test_5ax/5ax_test.mpf`, `stl/test6.stl`, профиль AC. В STL Objects: Base Point Origin, Position Z=-100, Move Here.
- SINUMERIK impeller: `tests/fixtures/milling/test_5ax/impeller.mpf`, `stl/test7.stl`, профиль **5Ax Table BC Angled**. В STL Objects: Transform, поворот Z на +90°, затем Section Y на нуле, Apply, Undo, затем STL edges only. В редакторе sandbox выбирается сохранённая геометрия конической сферической фрезы T60 с D1. Короткий Play, затем переходы ползунка с шагом 10% до конца. Токарный Stock Removal и flange сохраняют полное непрерывное воспроизведение.

Pytest изолирует настройки, библиотеку инструментов и выходные файлы во временных каталогах. Фиксированный T0303 P2 находится во временной библиотеке sandbox, а не в пользовательской SQLite. Диалоги выбора файлов получают заданные пути; диалоги и действия приложения остаются настоящими. Неожиданные окна сообщений приводят к ошибке этапа вместо зависания. Проверяется состояние виджетов, модели и сцены, а не пиксели OpenGL. Оба режима печатают результаты этапов; demo также показывает итоговый диалог с таймером и указывает неуспешный этап при ошибке проверки.

Подробности этапов и платформ — в [инструкции GUI sandbox](docs/GUI_SANDBOX.md).

### Редактируются ли сгенерированные файлы Qt Python вручную?

Нет. Исходными файлами служат `.ui` и `.qrc`. Генерируемые файлы обновляйте через скрипты проекта.

Windows:

```powershell
.\scripts\ps1\generate-qt.ps1
```

Сгенерированные модули являются артефактами сборки.

---

## Сборка и выпуск

### Как собрать в Windows?

```powershell
.\scripts\ps1\build.ps1
```

Сборка создаёт отдельные исполняемые файлы GUI и CLI плюс файлы контрольных сумм SHA-256.

### Как собрать в Linux?

```bash
bash scripts/sh/build.sh
```

Для консольной упаковки после того, как тесты уже пройдены:

```bash
bash scripts/sh/build.sh --console --skip-tests
./dist/easy_gcode_plot_cli --help
(cd dist && sha256sum -c easy_gcode_plot_cli.sha256)
```

### Использует ли проект отдельную среду сборки?

Да. Нативный/релизный инструментарий использует постоянный `.venv-build`, а не заменяет или очищает `.venv` разработчика.

Нативная сборка проверяет отслеживаемые `.pyx` и состояние зависимостей и может переиспользовать среду сборки, когда ничего relevant не изменилось.

### Как проверяются релизы в CI?

Рабочий процесс релиза запускает полный набор тестов и статические проверки в Linux и Windows до упаковки. Оба упакованных CLI проходят smoke-проверку через `--help`; Linux-архив получает SHA-256 sidecar, Windows публикует контрольные суммы GUI/CLI, а release-job скачивает оба артефакта перед созданием или обновлением GitHub Release по тегу.

### Запускается ли исполняемый файл Linux как Windows `.exe`?

Нет. Артефакты Windows и Linux — платформенно-зависимые сборки, хотя они используют одну и ту же реализацию Python/ядра и контракт CLI.

---

## Лицензия

Easy G-Code Plot распространяется под лицензией MIT. См. `LICENSE.md` для полного текста.