.. _auto_simulation_parameterize_file:

*PARAMETERIZE AND INPUT FOR SIMULATION FILE*
============================================

Injects a parameter dataset into a nominated input file belonging to an existing simulation, substituting keyword cards in-place and returning both the original and updated card text. Use this worker when a workflow needs to programmatically parameterize an LS-DYNA or similar deck file before solver submission.

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

Tagged: ``cards``, ``deck``, ``files``, ``input_file``, ``keyword``, ``parameter_substitution``, ``parameterize``, ``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 ID of the parent simulation whose input file will be parameterized; must reference an existing simulation record (remote lookup, required).
   * - Input File
     - input_file_id
     - remote_lookup
     - —
     - ✓
     - Platform file ID of the specific input/deck file attached to the selected simulation that will receive parameter substitutions (remote lookup filtered by simulation_id, required).
   * - Parameter Dataset
     - parameter_dataset
     - scalar
     - —
     - 
     - Scalar value or serialized key-value dataset carrying the parameter names and their replacement values to be injected into the deck file; leave blank if only inspecting existing cards.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulation Id
     - simulation_id
     - scalar
     - Platform ID of the simulation that was processed, passed through for downstream chaining.
   * - Attachment
     - input_file_id
     - scalar
     - Platform file ID of the parameterized (updated) attachment as stored on the platform after substitution.
   * - Old Parameters
     - old_cards
     - textarea
     - Full text of the original keyword cards extracted from the deck file before any parameter substitution was applied, useful for audit and diff.
   * - New Parameters
     - new_cards
     - textarea
     - Full text of the updated keyword cards after parameter substitution has been applied, confirming the values that were written into the deck.

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

- cae.preprocessing.deck_authoring
- 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_parameterize_file</code>. Schema hash: <code>c94617dfacc1</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>