.. _auto_simulation_replace_curve_by_id:

*SIMULATION CURVE REPLACEMENT*
==============================

Locates a specific curve by its ID within a simulation record and replaces its X/Y data with the provided new curve. Use this worker when you need to update or override a single stored curve in a simulation without re-running the full analysis.

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

Tagged: ``curve_id``, ``curve_replacement``, ``files``, ``simulation``, ``xy_data``.

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; select from the remote simulations lookup — this is the parent container in which the curve will be searched and replaced.
   * - Curve Id
     - curve_id
     - text
     - 1
     - ✓
     - Integer or string identifier of the curve to be replaced (e.g. 1); must match an existing curve ID stored within the selected simulation.
   * - New Curve
     - new_curve
     - vector
     - —
     - 
     - Replacement X/Y vector data that will overwrite the original curve values; provide as a paired numeric vector in the platform's curve format.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulation Id
     - simulation_id
     - scalar
     - The ID of the simulation record that was modified, passed through for chaining to downstream workers.
   * - Replaced File Name
     - replaced_file_name
     - text
     - Name of the file within the simulation that was updated to store the new curve data, useful for audit or downstream file-reference steps.

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

- cae.postprocessing.extraction
- data.curve.transform
- data.io.file

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