.. _auto_template_create_uniaxial_tension:

*CREATES A UNI-AXIAL RESPONSE TEMPLATE FOR DATA EXTRACTION*
===========================================================

Creates a reusable uniaxial-tension response template that maps simulation sensor IDs (nodes, cross-sections, part IDs) to standard KPI channels (force-displacement, engineering/true stress-strain, DIC strain). Use this worker to configure and register the extraction template before running post-processing or curve-matching workflows on uniaxial coupon simulations.

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

Tagged: ``coupon``, ``dic``, ``extraction``, ``force_displacement``, ``kpi``, ``response_template``, ``specimen``, ``stress_strain``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - IFTES(
     - import_from_file
     - file
     - —
     - 
     - Optional helper file (e.g. a binout or d3plot) used to auto-populate sensor IDs such as node labels and section IDs; leave empty if entering sensor IDs manually.
   * - Template Name
     - template_name
     - text
     - Generic Uniaxial Tensile Template
     - ✓
     - Human-readable name assigned to the new response template; defaults to 'Generic Uniaxial Tensile Template' and must be unique unless Delete Existing is set to Yes.
   * - Reference Curve
     - ref_curve
     - vector
     - —
     - ✓
     - Physical test reference curve (XY vector) used to compute curve-match error against the simulation; supply as a force-displacement or stress-strain pair matching the selected Reference Type.
   * - Reference Type
     - ref_curve_type
     - select
     - fd
     - ✓
     - Type of the reference curve supplied above — one of Force-Displacement (fd), Engineering Stress-Strain (eng_ss), True Stress-Strain (true_ss), or DIC Strain vs Displacement (dic_strain); must match the physical units of ref_curve.
   * - Elastic Modulus
     - emod
     - text
     - 210
     - ✓
     - Elastic modulus of the material in GPa (default 210 GPa for steel); used to compute derived stress-strain KPIs and elastic-regime identification.
   * - Poisson Ratio
     - pr
     - text
     - 0.3
     - ✓
     - Poisson's ratio of the material (dimensionless, default 0.3); used together with the elastic modulus for volumetric and lateral strain calculations.
   * - Specimen PID
     - specimen_pid
     - text
     - 1
     - ✓
     - LS-DYNA Part ID (PID) of the uniaxial coupon mesh; default is 1 — update to match the actual part ID in the simulation deck.
   * - Section Id
     - force_cross_section_id
     - text
     - 1
     - ✓
     - LS-DYNA cross-section (DATABASE_CROSS_SECTION) ID used to extract the reaction force time-history; default is 1.
   * - N1IOL
     - disp_node1_id
     - text
     - 1
     - ✓
     - Node ID or label for the first gauge-length reference node (N1) used to compute axial displacement/strain; default is 1.
   * - N2IOL
     - disp_node2_id
     - text
     - 2
     - ✓
     - Node ID or label for the second gauge-length reference node (N2) used to compute axial displacement/strain; default is 2.
   * - WN1IOL
     - width_node1_id
     - text
     - 3
     - ✓
     - Node ID or label for the first width-direction reference node (WN1) used to compute lateral strain and Poisson-ratio checks; default is 3.
   * - WN2IOL
     - width_node2_id
     - text
     - 4
     - ✓
     - Node ID or label for the second width-direction reference node (WN2) used to compute lateral strain; default is 4.
   * - Delete Existing
     - delete_existing
     - select
     - no
     - ✓
     - Controls whether a pre-existing template with the same name is overwritten (Yes) or left in place causing the worker to abort (No, default); set to Yes when iterating on template definitions.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Template Id
     - template_id
     - integer
     - Integer ID of the newly created (or replaced) uniaxial-tension response template in the d3VIEW platform, passable directly to downstream post-processing or curve-matching workers.

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

- cae.postprocessing.extraction
- cae.postprocessing.response
- engineering.material.characterization
- engineering.material.specimen

.. raw:: html

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