.. _auto_simulation_parameterize_input:

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

Parameterizes a named keyword/card field inside a simulation input deck by locating the target card and substituting the specified value. Use this worker to programmatically inject or update a single parameter in an LS-DYNA (or similar) input file without manual deck editing.

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

Tagged: ``card``, ``deck_edit``, ``files``, ``input_deck``, ``keyword``, ``ls-dyna``, ``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
     - —
     - ✓
     - Remote reference to the target simulation whose input file will be parameterized; must be selected first as other inputs depend on it.
   * - Input File
     - input_file_id
     - remote_lookup
     - —
     - ✓
     - Remote reference to the specific input deck file (e.g., a .k or .key LS-DYNA file) attached to the selected simulation that will be modified.
   * - Parameter Name
     - parameter_name
     - scalar
     - —
     - 
     - Human-readable label or token name for the parameter being substituted (e.g., 'THICKNESS' or 'YOUNG_MODULUS'); used for identification and logging.
   * - Parameter Type
     - parameter_type
     - scalar
     - —
     - 
     - Data type of the parameter value (e.g., 'float', 'int', 'string'); controls how the substituted value is formatted in the card field.
   * - Parameter Value
     - parameter_value
     - scalar
     - —
     - 
     - The new scalar value to write into the target card field; should match the units and type expected by the solver.
   * - Parameter Width
     - parameter_width
     - scalar
     - —
     - 
     - Field width (number of characters) to use when writing the value into the fixed-format card; leave default if the deck uses standard 10-character LS-DYNA column widths.
   * - Keyword Name
     - keyword_name
     - scalar
     - —
     - 
     - Name of the LS-DYNA keyword block to target (e.g., '*MAT_PIECEWISE_LINEAR_PLASTICITY'); identifies which section of the deck contains the card to edit.
   * - Card Name
     - card_num
     - scalar
     - —
     - 
     - Card number (1-based row index) within the keyword block where the parameter resides; corresponds to the card label in the keyword manual.
   * - Parameter Name
     - param_num
     - scalar
     - —
     - 
     - Column/field position (1-based) on the target card that holds the parameter to be replaced.
   * - Card ID
     - card_id
     - scalar
     - —
     - 
     - Unique identifier (e.g., part/section/material ID) used to locate the specific keyword instance within the deck when multiple entries of the same keyword exist.

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 simulation whose input file was modified; can be wired directly into downstream solver or job-submission workers.
   * - Input File Id
     - input_file_id
     - scalar
     - Identifier of the updated input deck file stored on the platform after the parameter substitution has been applied.
   * - Old Cards
     - old_cards
     - textarea
     - Full text of the affected card block as it appeared before the substitution; useful for diffing, auditing, or rollback.
   * - New Cards
     - new_cards
     - textarea
     - Full text of the affected card block after the parameter substitution has been applied; confirms the exact lines written to the deck.

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

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