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, чтобы оставить только совпадающие строки.

Execute Python code synchronously in the running Itasca engine process. Returns stdout and an optional result variable immediately. Code runs in the engine's main thread, sharing the same main namespace as any running task — side effects persist and are immediately visible to the task on its next cycle. The tool stays responsive while a task submitted via itasca_execute_task is cycling (calls interleave at cycle gaps), so use it as a live REPL — nothing has to be pre-scripted into the task up front. Typical uses: - Query model state and read Itasca command output: itasca.command('ball list') etc. — table dumps, list output, and command summaries are captured and interleaved with Python prints in execution order - Live inspection and tuning during a running task: check forces or contact statistics, modify parameters, swap callbacks, set sentinel variables the task reads each cycle - Create and export plots: itasca.command('plot ...') Environment: the engine's embedded Python interpreter (Itasca 9+ → Python 3.10, pre-9 → Python 3.6 or older; the product+version is encoded in sys.executable, e.g. PFC900). When unsure, check sys.version_info before relying on newer syntax. Code-writing rules (shared with itasca_execute_task): - Multi-line itasca.command("""...""") batches are normalized to one engine call per command, keeping the bridge reachable mid-batch. Normalization recognizes itasca.command through its import name; call it through that name directly — rebinding via intermediate variables (_it = itasca) bypasses it and the output carries a bridge warning. - Pass each FISH definition block (fish define / fish operator / legacy bare define, through its terminating standalone end) whole, in ONE itasca.command() string; feeding one line-by-line leaves the engine blocked in interactive FISH mode until completed manually in the GUI console. Per-line loops are fine for ordinary commands. - program call '<file>' (.p3dat / .p2dat / .dat / ...) is supported: the bridge runs the file inline, one command per engine call, so the bridge stays reachable, the run stays interruptible, and the file's output arrives command by command. Synchronous semantics: the request blocks until the code finishes or hits the timeout (default 10s, max 600s), and output is returned in full. The call is not tracked by itasca_list_tasks and cannot be interrupted mid-execution. For cancellable, pollable, or background work, submit via itasca_execute_task instead.

Submit a Python script file for asynchronous execution in the Itasca engine. Returns a task_id immediately; the script runs in the background. Companion tools manage the lifecycle: - itasca_check_task_status: poll output, progress, and final status - itasca_interrupt_task: cancel a running task - itasca_list_tasks: browse task history For synchronous, inline execution, use itasca_execute_code instead. While the task is cycling, itasca_execute_code shares the same main namespace in the engine's main thread, so you can inspect or modify simulation state live — probe progress, tune parameters mid-run, swap callbacks, or trigger early termination via a sentinel variable. Submit with reasonable starting values and refine as the task runs. Console output from itasca.command() inside the script (table dumps, list output, command summaries) is captured into the task log alongside Python prints, visible through itasca_check_task_status. Script-writing rules: - Multi-line itasca.command("""...""") batches are normalized to one engine call per command, keeping the task interruptible mid-batch. Normalization recognizes itasca.command through its import name; call it through that name directly — rebinding via intermediate variables (_it = itasca) bypasses it and logs a bridge warning. - Pass each FISH definition block (fish define / fish operator / legacy bare define, through its terminating standalone end) whole, in ONE itasca.command() string; feeding one line-by-line leaves the engine blocked in interactive FISH mode until completed manually in the GUI console. Per-line loops are fine for ordinary commands. - program call '<file>' (.p3dat / .p2dat / .dat / ...) is supported: the bridge runs the file inline, one command per engine call, so the bridge stays reachable, the task stays interruptible, and the file's output lands in the task log command by command.

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