.. _auto_curves_add_strain_rate_curves:

*ADD CURVES BASED ON NEW STRAIN RATE VALUES BY INTERPOLATING OR EXTRAPOLATING*
==============================================================================

Generates new strain-rate curves by interpolating or extrapolating from an existing set of rate-dependent material curves. Given the current strain rates associated with input curves and a list of target strain rates, the worker computes the missing curves using configurable scaling strategies and interpolation methods. Use this worker to enrich a rate-dependent material dataset before feeding it into a material card (e.g., MAT_24).

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

Classification: **process**.

Tagged: ``dynamic``, ``extrapolation``, ``interpolation``, ``logarithmic``, ``mat_24``, ``material_curves``, ``rate_dependent``, ``scale_factor``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curves
     - curves
     - vector
     - —
     - ✓
     - Collection of existing rate-dependent stress-strain (or force-displacement) curves, one per known strain rate; must be provided as a multi-curve vector and count must match `currentstrainrates`.
   * - Current Strain Rates
     - currentstrainrates
     - text
     - —
     - ✓
     - Space- or comma-separated list of strain-rate values (s⁻¹) corresponding to each input curve in the same order; count must equal the number of curves supplied.
   * - New Strain Rates
     - new_strainrates
     - text
     - —
     - ✓
     - Space- or comma-separated list of target strain-rate values (s⁻¹) for which new curves are to be generated by interpolation or extrapolation.
   * - Type Of Scaling Used
     - sf_type
     - string
     - max
     - 
     - Strategy used to compute scale factors between curves: 'max' uses the y-maximum of each curve, 'yfirst' uses the first y-value, and 'dynamic' uses the instantaneous y-value at a specified x position; default is 'max'.
   * - Lower Bound Scale Factor
     - lower_bound_sf
     - scalar
     - 1
     - ✓
     - Multiplicative scale factor applied to any extrapolated curve whose target strain rate falls below the lowest known strain rate; default is 1.0 (no additional scaling).
   * - Upper Bound Scale Factor
     - upper_bound_sf
     - scalar
     - 1
     - ✓
     - Multiplicative scale factor applied to any extrapolated curve whose target strain rate exceeds the highest known strain rate; default is 1.0 (no additional scaling).
   * - Interpolation Type
     - interpolation_type
     - string
     - linear
     - 
     - Mathematical method used to interpolate/extrapolate between known curves (e.g., 'linear'); default is 'linear'.
   * - Compute Viscosity every point defined by this value
     - dynamic_every
     - scalar
     - 1
     - ✓
     - When sf_type is 'dynamic', specifies the x-step interval at which instantaneous scale factors are sampled; default is 1.
   * - Type of Value for Dynamic Scaling
     - dynamic_type
     - string
     - average
     - 
     - Aggregation method for dynamic scale factors between sample points (e.g., 'average'); default is 'average'.
   * - Yield Stress SF vs Strain-rate
     - sr_sf
     - vector
     - —
     - 
     - Optional user-supplied scale-factor values to override computed scale factors between strain rates; leave null to use automatically computed factors.
   * - Strain Rate Interpolation Space
     - strain_rate_space
     - string
     - logarithmic
     - 
     - Controls whether scale factor interpolation is performed in logarithmic or linear strain rate space. Logarithmic (default) is recommended by material physics for strain rate-dependent materials, especially at extreme strain rates.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_add_strain_rate_curves
     - curves_add_strain_rate_curves
     - vector
     - Augmented multi-curve vector containing the original input curves plus all newly generated curves at the requested strain rates, ordered by ascending strain-rate value.

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

- data.curve.pair
- data.curve.transform
- engineering.material.calibration
- engineering.material.characterization

Runnable example
----------------

A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: `/api/workflow/example?id=curves_add_strain_rate_curves <https://www.d3view.com/api/workflow/example?id=curves_add_strain_rate_curves>`_

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>transformation</code> schema. Worker id: <code>curves_add_strain_rate_curves</code>. Schema hash: <code>624b85a60a7e</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>