.. _auto_curve_engstressstrain_forcedeflection:

*CONVERT A FORCE-DEFLECTION CURVE TO A ENGINEERING STRESS VS STRAIN CURVE BASED*
================================================================================

Converts an engineering stress-strain curve to a force-deflection curve (or vice versa) using specimen gauge geometry. Provide the cross-section type and dimensions to scale between stress/strain and force/deflection domains. Use this worker when preparing material coupon data for LS-DYNA material card input or for comparing test-machine outputs with stress-strain characterisation results.

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

Classification: **process**.

Tagged: ``circular``, ``conversion``, ``coupon``, ``cross-section``, ``curve``, ``engineering-strain``, ``engineering-stress``, ``force-deflection``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Eng Stress Strain
     - eng_stress_strain
     - vector
     - —
     - 
     - Input engineering stress-strain curve (vector of stress vs. strain pairs) to be converted to force-deflection; leave empty if the conversion direction is reversed.
   * - Section Type
     - sectiontype
     - scalar
     - rectangle
     - 
     - Cross-section shape at the gauge region — 'rectangle' (requires width and thickness) or 'circular' (requires radius); defaults to 'rectangle'.
   * - Length
     - length
     - float
     - 1.0
     - 
     - Gauge length of the specimen in consistent model units (e.g. mm); used to convert strain to deflection — defaults to 1.0.
   * - Width Or Radius
     - widthorradius
     - float
     - 1.0
     - 
     - Width of a rectangular cross-section or radius of a circular cross-section at the gauge, in consistent model units (e.g. mm) — defaults to 1.0.
   * - Thickness
     - thickness
     - float
     - 1.0
     - 
     - Thickness of a rectangular cross-section at the gauge in consistent model units (e.g. mm); ignored for circular sections — defaults to 1.0.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_engstressstrain_forcedeflection_output_1
     - curve_engstressstrain_forcedeflection_output_1
     - vector
     - Resulting force-deflection curve (vector of force vs. displacement pairs) derived from the input engineering stress-strain curve and the supplied specimen geometry.

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

- data.curve.transform
- engineering.material.characterization
- engineering.material.specimen

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

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

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