.. _auto_doe_study_curve_extrapolation:

*CREATES STUDY FOR CURVE EXTRAPOLATION EXPERIMENTS*
===================================================

Creates a DOE study for curve extrapolation experiments by launching a set of simulation runs from a source simulation, applying a chosen hardening-law extrapolation model (Swift, Voce, Hockett-Sherby, etc.) to extend a flow-stress curve beyond the measured strain range. Use this worker to systematically explore extrapolation parameter space or to generate a single baseline extrapolated curve for downstream material calibration workflows.

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

Tagged: ``curve_extrapolation``, ``doe``, ``flow_stress``, ``hardening_law``, ``hockett-sherby``, ``mat_24``, ``material_calibration``, ``optimization``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - NOTS
     - study_name
     - scalar
     - —
     - ✓
     - Unique name for the new DOE study as it will appear in the d3VIEW studies registry; must be a non-empty string.
   * - DOTS
     - study_description
     - text
     - —
     - ✓
     - Human-readable description of the study's purpose and scope; stored as free-text metadata on the study record.
   * - Simulation
     - source_simulation_id
     - remote_lookup
     - —
     - ✓
     - Reference to the baseline simulation whose setup is cloned for each DOE experiment; selected via remote simulation lookup.
   * - Effective Curve
     - effective_curve
     - vector
     - —
     - ✓
     - Input flow-stress (effective stress vs. effective plastic strain) curve to be extrapolated, supplied as an X-Y vector pair.
   * - Experiments
     - experiments
     - dataset
     - —
     - ✓
     - Dataset table defining the DOE experiment matrix — each row specifies one set of extrapolation parameter values to be evaluated.
   * - Map Parameters
     - map_parameters
     - dataset
     - —
     - ✓
     - Dataset mapping extrapolation model parameter names to their corresponding simulation/keyword variables so the worker can inject values into each run.
   * - Extrapolation Type
     - extrapolation_type
     - select
     - swift
     - ✓
     - Hardening-law model used for curve extrapolation; choose from Swift (default), Voce, Hockett-Sherby, Modified Hockett-Sherby, or Stoughton-Hoon.
   * - Last Strain
     - last_strain
     - text
     - —
     - 
     - Maximum effective plastic strain value to which the curve is extrapolated; leave blank to use the model's natural termination point.
   * - Increment
     - increment
     - text
     - —
     - 
     - Strain increment (step size) used when generating the extrapolated curve points; leave blank to inherit the source curve's spacing.
   * - Curve Id
     - curve_id
     - text
     - —
     - 
     - Identifier of the specific curve within the source simulation to extrapolate; leave blank if the simulation contains only one effective curve.
   * - Run Baseline Only
     - baseline_only
     - select
     - yes
     - ✓
     - When set to 'Yes' (default), only the baseline experiment is executed and the full DOE matrix is skipped; set to 'No' to run all experiments defined in the experiments dataset.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - study
     - study_id
     - integer
     - Integer primary key of the newly created DOE study record in the d3VIEW database; used by downstream workers to reference this study.
   * - simulations
     - simulations
     - dataset
     - Dataset listing all simulation runs launched under the study, including their IDs, status, and parameter assignments for each experiment.
   * - curves
     - curves
     - vector
     - Collection of extrapolated flow-stress curves (one per experiment) returned as X-Y vectors, ready for plotting or material card authoring.

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

- data.curve.transform
- design_exploration.doe
- engineering.material.calibration
- engineering.material.characterization
- 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>doe_study_curve_extrapolation</code>. Schema hash: <code>0303db815416</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>