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), при условии, что задача активно циклирует — execute_code вставляется в промежутки между циклами. Используйте его как живую REPL-консоль для просмотра состояния симуляции в реальном времени — не нужно заранее прописывать print-инструкции, а прогоны параметров или управление на основе сторожевых переменных не обязаны быть встроены в скрипт задачи заранее. Среда: встроенный интерпретатор Python движка Itasca. Версия поставляется вместе с движком (Itasca 6/7 → Python 3.6, Itasca 9 → 3.10); продукт+версия закодированы в sys.executable (например PFC900, FLAC900). Если сомневаетесь, пишите код, совместимый с Python 3.6+. Типовые сценарии: - Запрос состояния модели: количество шаров/стенок/контактов, текущий цикл - Отправка команд Itasca и чтение их консольного вывода: itasca.command('ball list'), itasca.command('model list information'). Дампы таблиц, вывод списков и сводки команд захватываются и перемежаются с python-выводами в порядке выполнения — не нужно перереализовывать запросы через SDK только ради того, чтобы увидеть, что напечатала бы команда. - Просмотр в реальном времени во время выполнения задачи: проверка сил, энергии, координационного числа, статистики контактов - Настройка на лету во время выполнения задачи: изменение параметров, подмена колбэков, установка сторожевых переменных, которые задача читает каждый цикл (например, сменить цель сервопривода, изменить демпфирование, сигнализировать о досрочном завершении). - Создание и экспорт графиков: itasca.command('plot ...') - Разработка и тестирование в стиле REPL `program call '<file>.p3dat'` (или .p2dat / .dat) через этот инструмент ограничен версией движка. На версиях 6/7 интерпретатор командных скриптов блокирует мост на всё время выполнения скрипта без промежутков между циклами…

Отправляет файл Python-скрипта на асинхронное выполнение в движке Itasca. Сразу возвращает task_id; скрипт выполняется в фоне. Используйте вспомогательные инструменты для управления жизненным циклом задачи: - itasca_check_task_status: опрашивает вывод, прогресс и финальный статус - itasca_interrupt_task: отменяет выполняющуюся задачу - itasca_list_tasks: просматривает историю задач Пока задача выполняется, вы можете в любой момент вызвать itasca_execute_code, чтобы проверить или изменить состояние симуляции — включая переменные, от которых зависит задача. Это стандартный способ следить за прогрессом, подкручивать параметры на ходу, заменять колбэки или запускать досрочное завершение через сигнальную переменную. Оба инструмента работают в одном пространстве имён __main__ в главном потоке движка. Консольный вывод от itasca.command() внутри скрипта — дампы таблиц, вывод списков, сводки команд — захватывается и перемежается с выводами Python в журнале задачи, доступном через itasca_check_task_status. Вызов `program call '<file>.p3dat'` (или .p2dat / .dat) из скрипта зависит от версии движка. На версиях 6/7 интерпретатор командных скриптов блокирует мост на всё время выполнения скрипта без перемежения циклов, и мост становится недоступен, пока движок не будет остановлен вручную. Никогда не используйте его там, и относитесь к неизвестным или непроверенным версиям (включая 9.0–9.6) так же. На версии 9.7+ мост остаётся полностью отзывчивым во время `program call` (проверено на 9.7: опрос статуса, перемежение циклов и прерывание работают во время вызова). Даже там, где это безопасно, предпочитайте читать файл и переводить его команды в последовательность вызовов `itasca.command(...)` в Python-скрипте — это даёт вывод по каждой команде, локализацию ошибок и управление внутри скрипта, которое не может обеспечить один непрозрачный `program call`. Это путь асинхронного / фонового выполнения: опрашивается через itasca_check_task_status, отменяется через itasca_interrupt_task. Отправка не фиксирует параметры — начинайте с разумных значений и уточняйте в реальном времени через itasca_execute_code, пока задача выполняется. Для…

Запрашивает вежливое прерывание выполняемой задачи 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 по ключевым словам