.. _auto_simulation_replace_parameters:

*REPLACE PARAMETERS*
====================

Replaces one or more named parameters on an existing simulation with new values, recording both the old and new parameter states. Use this worker within a workflow to programmatically update simulation configuration (e.g. LS-DYNA keyword parameters) before re-running or branching a design study.

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

Tagged: ``deck_parameters``, ``keyword``, ``lsdyna``, ``parameters``, ``replace``, ``simulation``, ``update``.

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 lookup handle that identifies the target simulation whose parameters will be replaced; select from the available simulations registered in d3VIEW.
   * - Parameters
     - parameters
     - dataset
     - —
     - ✓
     - Dataset table defining the parameters to replace, with columns 'type', 'name', and 'default' (new value); each row overrides one named parameter on the selected simulation.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulation Id
     - simulation_id
     - integer
     - Integer ID of the simulation that was updated, forwarded for use by downstream workers.
   * - Old Parameters
     - old_parameters
     - dataset
     - Dataset containing the parameter values that existed on the simulation before the replacement was applied, useful for auditing or rollback.
   * - New Parameters
     - new_parameters
     - dataset
     - Dataset containing the parameter values that were written to the simulation after the replacement, confirming the applied changes.

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