.. _auto_template_create_shear_specimen:

*CREATES A SHEAR RESPONSE TEMPLATE FOR DATA EXTRACTION*
=======================================================

Creates a reusable Shear Response extraction template that captures force, displacement, and width node references for a shear specimen simulation. Use this worker to register a named response template that can subsequently drive curve-match comparisons between physical test data and LS-DYNA shear coupon results.

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

Tagged: ``curve_match``, ``extraction``, ``mat_calibration``, ``response_template``, ``shear``, ``specimen``, ``template``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - UIFTDS
     - import_from_file
     - file
     - —
     - 
     - Optional file (UIFTDS format) from which sensor/node definitions are pre-populated into the template; leave empty to configure sensors manually.
   * - Template Name
     - template_name
     - text
     - Generic Shear Tensile Template
     - ✓
     - Human-readable name assigned to the new response template (default: 'Generic Shear Tensile Template'); must be unique unless delete_existing is set to 'yes'.
   * - Reference Curve
     - ref_curve
     - vector
     - —
     - ✓
     - Reference experimental curve (force-displacement, engineering stress-strain, true stress-strain, or DIC strain vs. displacement) used as the physical-test baseline for curve-match error computation.
   * - Reference Type
     - ref_curve_type
     - select
     - fd
     - ✓
     - Declares the axis convention of the reference curve: 'fd' = Force vs. Displacement, 'eng_ss' = Engineering Stress vs. Strain, 'true_ss' = True Stress vs. Strain, 'dic_strain' = DIC Strain vs. Displacement; must match the units and axes of ref_curve.
   * - Elastic Modulus
     - emod
     - text
     - 10
     - ✓
     - Elastic (Young's) modulus of the shear specimen material used in stress-strain conversion; typical units are GPa or MPa — must be consistent with the simulation deck (default: 10).
   * - Poisson Ratio
     - pr
     - text
     - 0.3
     - ✓
     - Poisson's ratio of the specimen material used for lateral strain calculations; dimensionless, typical range 0.0–0.5 (default: 0.3).
   * - Specimen PID
     - specimen_pid
     - text
     - 1
     - ✓
     - LS-DYNA Part ID of the shear specimen element set from which stress and strain responses are extracted (default: 1).
   * - Section Force Id
     - force_cross_section_id
     - text
     - 1
     - ✓
     - LS-DYNA cross-section (SECTION_FORCE) ID used to extract the resultant shear force time-history (default: 1).
   * - N1IOL
     - disp_node1_id
     - text
     - 1
     - ✓
     - Node 1 ID or label (N1IOL) defining the first point of the displacement gauge length along the loading axis (default: 1).
   * - N2IOL
     - disp_node2_id
     - text
     - 2
     - ✓
     - Node 2 ID or label (N2IOL) defining the second point of the displacement gauge length along the loading axis (default: 2).
   * - WN1IOL
     - width_node1_id
     - text
     - 1
     - ✓
     - Width Node 1 ID or label (WN1IOL) defining the first point of the transverse width measurement used for engineering strain computation (default: 1).
   * - WN2IOL
     - width_node2_id
     - text
     - 2
     - ✓
     - Width Node 2 ID or label (WN2IOL) defining the second point of the transverse width measurement (default: 2).
   * - Delete Existing
     - delete_existing
     - select
     - no
     - ✓
     - Controls collision handling: 'no' (default) raises an error if a template with the same name already exists; 'yes' silently removes the existing template before creating the new one.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Template Id
     - template_id
     - integer
     - Integer primary key of the newly created shear response template object (dataType: responsetemplate) in the d3VIEW platform, used to reference this template in downstream extraction or calibration workers.

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

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