.. _auto_template_create_hole_expansion_specimen:

*CREATES A HOLE EXPANSION RESPONSE TEMPLATE FOR DATA EXTRACTION*
================================================================

Creates a Hole Expansion Response template that defines the sensors and reference curves needed to extract punch-force, displacement, and blank-node data from a hole-expansion specimen simulation. Use this worker to register a named response template before running post-processing or curve-matching workflows.

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

Tagged: ``blank_nodes``, ``curve_match``, ``hole_expansion``, ``material_testing``, ``punch``, ``response_template``, ``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 UIFTDS file used to pre-populate sensor definitions; leave empty to define sensors manually via the other inputs.
   * - Template Name
     - template_name
     - text
     - Generic Shear Tensile Template
     - ✓
     - Human-readable name assigned to the new response template; defaults to 'Generic Shear Tensile Template' but should be set to a project-specific name to avoid collisions.
   * - Reference Curve
     - ref_curve
     - vector
     - —
     - ✓
     - Reference (experimental) curve used to compute curve-match error against the simulation result; provide as an XY vector in the units matching the selected ref_curve_type.
   * - Reference Type
     - ref_curve_type
     - select
     - no
     - ✓
     - Declares the axis convention of the reference curve — choose 'fd' (Force vs Displacement), 'eng_ss' (Engineering Stress vs Strain), 'true_ss' (True Stress vs Strain), or 'dic_strain' (DIC Strain vs Displacement) — must match the physical units of ref_curve.
   * - Specimen PID
     - specimen_pid
     - text
     - 1
     - ✓
     - LS-DYNA part ID (PID) of the hole-expansion specimen blank whose elements are monitored for stress/strain extraction; defaults to 1.
   * - Punch Node Id
     - punch_node
     - text
     - 1
     - ✓
     - Node ID of the single punch reference node used to track punch displacement and force; defaults to 1.
   * - PNFPDC
     - punch_nodes
     - text
     - 10,20,30
     - ✓
     - Comma-separated list of exactly three punch node IDs (e.g. '10,20,30') used to compute punch-force/displacement in the planar cross-section.
   * - BNFBIDC
     - blank_nodes_inner
     - text
     - 40,50,60
     - ✓
     - Comma-separated list of exactly three node IDs located on the inner boundary of the blank hole (e.g. '40,50,60') used to measure hole-edge displacement.
   * - BNFBODC
     - blank_nodes_outer
     - text
     - 70,80,90
     - ✓
     - Comma-separated list of exactly three node IDs located on the outer boundary of the blank (e.g. '70,80,90') used as the outer reference for displacement and strain calculations.
   * - Delete Existing
     - delete_existing
     - select
     - no
     - 
     - Controls whether a pre-existing template with the same name is deleted before creation; set to 'yes' to overwrite, default 'no' will raise an error if the name already exists.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Template Id
     - template_id
     - integer
     - Integer database ID of the newly created Hole Expansion response template object (dataType: responsetemplate), used as input to downstream post-processing or curve-matching 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_hole_expansion_specimen</code>. Schema hash: <code>63546b995275</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>