.. _auto_file_replace_parameters:

*REPLACE PARAMETERS IN A FILE*
==============================

Performs token/parameter substitution in a solver input file (LS-DYNA, Madymo, or Nastran), replacing named placeholders with values supplied via a dataset. Use this worker to programmatically inject design variables or study parameters into a deck before submission.

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

Tagged: ``deck_authoring``, ``file_replace``, ``keyword``, ``lsdyna``, ``madymo``, ``nastran``, ``parameter_substitution``, ``template``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - File
     - file
     - file
     - —
     - ✓
     - Solver input file (e.g. LS-DYNA .k/.key, Madymo .xml, or Nastran .bdf) containing named parameter placeholders to be replaced.
   * - Parameters
     - parameters
     - dataset
     - —
     - ✓
     - Dataset of name–value pairs mapping each placeholder token in the input file to its replacement value; see d3VIEW dataset input format.
   * - Solver Type
     - solver_type
     - select
     - lsdyna
     - ✓
     - Solver format of the input file — 'lsdyna' (default), 'Madymo', or 'nastran'; controls how parameter tokens are parsed and written.
   * - Format
     - format
     - select
     - short
     - ✓
     - Field-width format for the output deck — 'short' (default, 10-character columns) or 'long' (20-character columns); applies primarily to LS-DYNA keyword formatting.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Replaced File
     - replaced_file
     - file
     - Modified solver input file with all parameter placeholders substituted by the values provided in the parameters dataset, ready for job submission.
   * - New Parameters
     - new_parameters
     - dataset
     - Dataset echoing the final name–value pairs that were applied, including any defaults for tokens that were not explicitly overridden; useful for traceability and downstream reporting.

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

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