.. _auto_simulation_get_main_input_file:

*GET MAIN INPUT FILE FOR A GIVEN SIMULATION*
============================================

Retrieves the main input file associated with a given simulation record on the d3VIEW platform. Use this worker to obtain the file attachment ID and resolved file path of the primary deck/input file before passing it downstream to preprocessing or solver workers.

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

Tagged: ``attachment``, ``deck``, ``file_path``, ``files``, ``input_file``, ``simulation``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - simulation_id
     - remote_lookup
     - —
     - ✓
     - Platform simulation record to query; select the target simulation from the remote lookup — required, no default.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulation Id
     - simulation_id
     - scalar
     - Pass-through identifier of the queried simulation record (d3VIEW simulations dataType scalar), useful for chaining downstream workers.
   * - Attachment
     - att_id
     - scalar
     - Platform attachment ID (files dataType scalar) of the main input file; use this to retrieve or stream the file via other file-handling workers.
   * - Main Input File Path
     - file_path
     - string
     - Absolute or relative server-side path (string) to the main input file, e.g. a LS-DYNA keyword deck; use directly as a file argument in solver or preprocessing workers.

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

- data.io.file
- platform.integration

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