.. _auto_simulation_parameterize_input_by_dataset:

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

Parameterizes a simulation input file by substituting keyword/card values from a supplied parameter dataset. Use this worker to programmatically update LS-DYNA (or similar) deck parameters before job submission, replacing manual edits with dataset-driven card injection.

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

Tagged: ``cards``, ``dataset``, ``deck_authoring``, ``files``, ``input_file``, ``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
     - —
     - ✓
     - The simulation record to target; drives the dependent input-file lookup — must be selected first.
   * - Input File
     - input_file_id
     - remote_lookup
     - —
     - ✓
     - The specific input deck file (e.g. a LS-DYNA .k / .key file) attached to the chosen simulation whose cards will be parameterized.
   * - Parameter Dataset
     - parameter_dataset
     - scalar
     - —
     - 
     - Dataset (e.g. a JSON/CSV-style scalar payload) containing the parameter names and replacement values to inject into the input deck.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulation Id
     - simulation_id
     - scalar
     - Pass-through ID of the simulation record, forwarded for downstream job-submission or chaining workers.
   * - Input File Id
     - input_file_id
     - scalar
     - Pass-through ID of the (now parameterized) input file, ready for downstream solver or archiving workers.
   * - Old Cards
     - old_cards
     - textarea
     - Full text snapshot of the original keyword cards as they existed before parameterization — useful for auditing and diff comparisons.
   * - New Cards
     - new_cards
     - textarea
     - Full text of the updated keyword cards after parameter substitution has been applied — injected into the simulation deck.

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

- cae.preprocessing.deck_authoring
- cae.preprocessing.setup
- data.dataset.transform

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