.. _auto_simulation_get_curve_by_id:

*SIMULATION GET CURVE BY ID*
============================

Looks up a single curve from a simulation record by its numeric curve ID and returns the curve data with any configured scale and offset applied. Use this worker when you need to extract a specific named/indexed curve from a simulation for downstream processing or plotting.

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

Tagged: ``curve``, ``curve_id``, ``files``, ``offset``, ``retrieval``, ``scale``, ``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 query; select via remote lookup against the simulations data source — required, no default.
   * - Curve Id
     - curve_id
     - text
     - 1
     - ✓
     - Integer ID of the curve to retrieve within the selected simulation (e.g. 1 for the first curve); defaults to 1 but must be set to the target curve's ID.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulation Id
     - simulation_id
     - scalar
     - Pass-through scalar reference to the source simulation record, useful for chaining subsequent simulation-scoped workers.
   * - Curve
     - curve
     - vector
     - The retrieved curve as a vector (x/y pairs) with scale and offset applied as configured on the simulation record.

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

- cae.postprocessing.extraction
- data.curve.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_get_curve_by_id</code>. Schema hash: <code>2165be467308</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>