.. _auto_simulation_list_components:

*LIST SIMULATION COMPONENTS*
============================

Lists all components (parts, materials, contacts, input curves) in an LS-DYNA simulation, returning their IDs, names, types, and key attributes. Use this worker to understand a model's structure before drilling into specific component details. Designed as an LLM-callable tool within agent workflows.

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

Tagged: ``agent-tool``, ``contacts``, ``curves``, ``llm-tool``, ``lsdyna``, ``materials``, ``model-structure``, ``parts``.

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 inspect; resolved via remote lookup against the simulations registry — required, no default.
   * - Component Type
     - component_type
     - select
     - all
     - 
     - Filter controlling which component category is returned: 'all' (default), 'parts', 'materials', 'contacts', or 'curves'; leave as default to retrieve the full model inventory.
   * - Output Format
     - format
     - select
     - markdown
     - 
     - Output serialization format: 'markdown' (default, human-readable tables) or 'json' (structured data suitable for downstream programmatic consumption).

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Component List
     - components
     - text
     - Formatted inventory of simulation components organized by type — parts (ID, name, material reference, mass), materials (ID, type, density), contacts (ID, name, type, slave/master part IDs), and input curves (ID, point count) — rendered as Markdown tables or a JSON object depending on the selected format.

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

- ai_ml.agents
- ai_ml.llm
- cae.postprocessing.extraction
- cae.preprocessing.setup

.. 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_list_components</code>. Schema hash: <code>72fbb9ce9cce</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>