.. _auto_simulation_files:

*GET FILES FROM SIMULATION*
===========================

Retrieves files from a simulation matching the given name patterns. Returns matching file attachment IDs, names, and a files dataset. Use to find and surface specific file IDs (e.g. LS-DYNA K files) stored within a simulation record.

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

Tagged: ``attachments``, ``file_lookup``, ``files``, ``k_file``, ``simulation``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - input_sim_id
     - remote_lookup
     - —
     - ✓
     - Simulation record(s) to query; select one or more simulations from the remote lookup — this is the source from which attached files will be retrieved.
   * - File Names
     - input_file_names
     - text
     - —
     - 
     - Comma-separated glob or exact name patterns (e.g. '*.k, result.binout') used to filter the simulation's attached files; leave blank to return all files.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Files Dataset
     - output_files_dataset
     - dataset
     - Tabular dataset listing every matched file attachment, with columns for attachment ID, file name, and associated metadata; consumed by downstream workers that require file IDs or paths.

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

- data.io.file
- platform.workflow

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