.. _auto_curve_effective_extrapolate_from_dataset:

*GENERATE EXTRAPOLATE FROM DATASET*
===================================

Extrapolates an effective (true) stress–strain curve beyond its measured range using a dataset-driven hardening law (Swift, Hockett-Sherby, Voce, or Stoughton-Yoon). Pre-fitted model parameters and a parameter map are supplied as datasets, allowing the worker to reconstruct and extend the curve to a user-defined terminal strain. Use this worker when material test data stops at necking and a full hardening curve is required for LS-DYNA MAT_24 or similar cards.

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

Classification: **process**.

Tagged: ``"``, ``-``, ``2``, ``4``, ``]``, ``_``, ``a``, ``b``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Effective Curve
     - effective_curve
     - vector
     - —
     - ✓
     - The measured effective (true) stress vs. true plastic strain curve (x = strain, y = stress in model units) that will be extended; supply as a d3VIEW vector/curve object.
   * - Method
     - method
     - list
     - swift
     - 
     - Hardening law used for the extrapolation: 'swift' (default), 'hocket-sherby', 'voce', or 'stoughton-hoon'; must match the law whose parameters are provided in the Parameters dataset.
   * - Parameters
     - parameters
     - dataset
     - —
     - ✓
     - Dataset containing the fitted hardening-law coefficients (e.g., K, ε₀, n for Swift) as a tabular dataset; rows correspond to parameter sets indexed by the Parameters Map.
   * - Parameters Map
     - parameters_map
     - dataset
     - —
     - ✓
     - Dataset that maps each parameter set in the Parameters dataset to a specific condition or load case; used to select the correct row of coefficients for the extrapolation.
   * - Last Strain
     - last_strain
     - scalar
     - —
     - ✓
     - Terminal true plastic strain value (dimensionless) up to which the curve is extrapolated; must be greater than the last measured strain point in the Effective Curve.
   * - Increment
     - increment
     - scalar
     - —
     - ✓
     - True plastic strain step size (dimensionless) used when generating the extrapolated portion of the curve; smaller values yield a smoother output curve.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_effective_extrapolate_from_dataset_output_1
     - curve_effective_extrapolate_from_dataset_output_1
     - vector
     - Extended effective true stress–strain curve (x = true plastic strain, y = true stress in model units) combining the original measured data with the extrapolated hardening tail up to Last Strain.

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

- 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=curve_effective_extrapolate_from_dataset <https://www.d3view.com/api/workflow/example?id=curve_effective_extrapolate_from_dataset>`_

.. raw:: html

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