.. _auto_simulation_search_issues:

*SEARCH SIMULATION ISSUES*
==========================

Searches and categorizes warnings and errors found in LS-DYNA simulation results, grouping issues by category (contact, element, mass, energy, material, timestep) with severity levels, source file references, and suggested remediation actions. Use this worker to rapidly triage a simulation run or to feed structured issue data into an LLM agent for automated debugging guidance.

When to use
-----------

Tagged: ``categorization``, ``debugging``, ``errors``, ``json``, ``llm_tool``, ``ls-dyna``, ``markdown``, ``simulation_issues``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation Id
     - simulation_id
     - remote_lookup
     - —
     - ✓
     - Unique identifier of the LS-DYNA simulation to analyze; resolved via remote lookup against the simulations data source — required, no default.
   * - Search Query
     - query
     - text
     - —
     - 
     - Optional free-text filter applied against issue messages, categories, and source file names (e.g. 'contact', 'negative volume', 'penetration'); leave blank to return all issues.
   * - Severity Filter
     - severity
     - select
     - all
     - 
     - Restricts returned issues by severity: 'all' (default) returns both errors and warnings, 'critical' returns errors only, 'warning' returns warnings only.
   * - Output Format
     - format
     - select
     - markdown
     - 
     - Controls the shape of the output: 'markdown' (default) produces a human-readable categorized report; 'json' produces raw structured data suitable for programmatic consumption.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - Simulation Issues
     - issues
     - text
     - Formatted simulation issues report containing a summary table (total errors, total warnings, filtered count), issues grouped by category (contact, element, mass, energy, material, timestep, other) each with severity badge, message text, source file, line number when available, and a suggested remediation action; delivered as Markdown text or a JSON string depending on the selected format.

Disciplines
-----------

- ai_ml.agents
- ai_ml.llm
- cae.postprocessing.extraction
- cae.postprocessing.response

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>simulation_search_issues</code>. Schema hash: <code>62707228b557</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>