yusong652/pfc-mcp

Просматривает документацию команд Itasca по пути (как glob + cat). Уровни навигации: - Без команды: обзор всех категорий команд - Только категория (например, "ball"): список команд в категории - Полная команда (например, "ball create"): полная документация Когда использовать: - Вы знаете категорию команды или точную команду - Вы хотите изучить доступные команды Связанные инструменты: - itasca_query_command: поиск команд по ключевым словам (когда путь неизвестен) - itasca_browse_reference: просмотр справочной документации (например, "contact-models linear")

Просматривает документацию Itasca Python SDK по пути (аналог glob + cat).

Просматривает справочную документацию ITASCA (элементы синтаксиса, свойства модели). Работает со всеми движками через обязательный селектор software (pfc/flac/3dec). Справочные элементы — это языковые конструкции, используемые внутри команд, а не отдельные команды. Уровни навигации: - Без темы: все категории справочных элементов для движка - Категория (например, "constitutive-models"): список элементов в категории - Полный путь (например, "constitutive-models mohr-coulomb"): полная документация - Путь подэлемента (например, "plot-items zone contour"): подробности подэлемента Когда использовать: - Нужны названия свойств модели материала/контакта/шва (kn, ks, fric, cohesion, friction, ...) - Нужен синтаксис фильтрации диапазона (position, cylinder, group, id) - Нужна настройка элементов графика (contour, label, color-by, cut, transparency, legend) - Настройка команд назначения модели (например, "... cmodel assign ... property ...") - Использование фильтров диапазона в любой команде - Настройка команд "plot item create" Связанные инструменты: - itasca_browse_commands: синтаксис команд (например, "zone create") - itasca_query_command: поиск команд по ключевым словам

Проверяет состояние и постраничный вывод для отправленной задачи Itasca. Вывод объединяет вывод Python и вывод консоли Itasca из вызовов itasca.command() (дампы таблиц, вывод списков, сводки команд), перемешанные в порядке выполнения. Используйте skip_newest / limit для постраничного вывода или filter, чтобы оставить только совпадающие строки.

Выполняет код Python синхронно в работающем процессе движка Itasca. Сразу возвращает stdout и необязательную переменную результата. Код выполняется в главном потоке движка, разделяя то же пространство имён main, что и любая запущенная задача: побочные эффекты сохраняются и сразу видны задаче на её следующем цикле. Инструмент остаётся отзывчивым, пока задача, отправленная через itasca_execute_task, выполняется по циклам (вызовы чередуются в промежутках между циклами), поэтому используйте его как живой REPL: ничего не нужно заранее прописывать в задаче. Типичные применения: - Запрос состояния модели и чтение вывода команд Itasca: itasca.command('ball list') и т.п. Выгрузки таблиц, вывод списков и сводки команд перехватываются и чередуются с выводами Python в порядке выполнения - Живой просмотр и настройка во время запущенной задачи: проверка сил или статистики контактов, изменение параметров, замена колбэков, установка сторожевых переменных, которые задача читает каждый цикл - Создание и экспорт графиков: itasca.command('plot ...') Окружение: встроенный интерпретатор Python движка (Itasca 9+ → Python 3.10, до 9 → Python 3.6 или старше; продукт и версия закодированы в sys.executable, например PFC900). Если не уверены, проверьте sys.version_info, прежде чем полагаться на новый синтаксис. Правила написания кода (общие с itasca_execute_task): - Многострочные пакеты itasca.command("""...""") нормализуются до одного вызова движка на команду, что сохраняет доступность моста в середине пакета. Нормализация распознаёт itasca.command по имени импорта; вызывайте её напрямую через это имя: перепривязка через промежуточные переменные (_it = itasca) обходит её, и вывод сопровождается предупреждением о мосте. - Передавайте каждый блок определения FISH (fish define / fish operator / устаревший голый define, до завершающего отдельного end) целиком, одной строкой itasca.command(); подача построчно оставляет движок заблокированным в интерактивном режиме FISH, пока его не завершат вручную в консоли GUI. Построчные циклы допустимы для обычных команд. - program call '<file>' (.p3dat /…

Отправляет файл Python-скрипта для асинхронного выполнения в движке Itasca. Сразу возвращает task_id; скрипт выполняется в фоне. Вспомогательные инструменты управляют жизненным циклом: - itasca_check_task_status: опрашивает вывод, прогресс и итоговый статус - itasca_interrupt_task: отменяет выполняющуюся задачу - itasca_list_tasks: просматривает историю задач Для синхронного инлайн-выполнения используйте вместо этого itasca_execute_code. Пока задача выполняется, itasca_execute_code использует общее пространство имён main в главном потоке движка, так что вы можете просматривать и изменять состояние симуляции в реальном времени: отслеживать прогресс, подстраивать параметры на ходу, заменять колбэки или вызывать досрочное завершение через сторожевую переменную. Запускайте с разумными начальными значениями и уточняйте их по ходу выполнения задачи. Вывод консоли из itasca.command() внутри скрипта (дампы таблиц, вывод списков, сводки команд) попадает в журнал задачи вместе с выводами Python print и виден через itasca_check_task_status. Правила написания скриптов: - Многострочные пакеты itasca.command("""...""") нормализуются до одного вызова движка на команду, так что задачу можно прервать в середине пакета. Нормализация распознаёт itasca.command по его импортированному имени; вызывайте его напрямую под этим именем. Перепривязка через промежуточные переменные (_it = itasca) обходит её и записывает предупреждение моста. - Передавайте каждый блок определения FISH (fish define / fish operator / устаревший голый define, до завершающего отдельного end) целиком, в ОДНОЙ строке itasca.command(). Если передавать его построчно, движок останется заблокированным в интерактивном режиме FISH, пока вы вручную не завершите его в консоли GUI. Для обычных команд допустимы построчные циклы. - program call '<file>' (.p3dat / .p2dat / .dat / ...) поддерживается: мост выполняет файл инлайн, по одной команде на вызов движка, поэтому мост остаётся доступным, задачу можно прервать, а вывод файла попадает в журнал задачи команда за командой.

Запрашивает вежливое прерывание выполняемой задачи Itasca.

Перечисляет отслеживаемые задачи Itasca с пагинацией.

Ищет документацию по командам Itasca по ключевым словам (как grep). Возвращает пути команд, подходящих под запрос. Для получения полной документации используйте itasca_browse_commands. Когда использовать: - У вас есть ключевые слова, но вы не знаете точный путь команды - Пример: "ball create", "contact property", "model solve" Связанные инструменты: - itasca_browse_commands: Получает полную документацию для известного пути команды - itasca_browse_reference: Ищет справочную документацию (например, "contact-models linear") - itasca_query_python_api: Ищет Python SDK по ключевым словам

Ищет в документации Itasca Python SDK по ключевым словам (как grep). Возвращает подходящие пути API с сигнатурами. Для полной документации используйте itasca_browse_python_api. Когда использовать: - У вас есть ключевые слова, но вы не знаете точный путь API - Пример: "ball velocity", "create", "contact force" Связанные инструменты: - itasca_browse_python_api: Получает полную документацию для известного пути API - itasca_query_command: Ищет команды Itasca по ключевым словам