.. _auto_template_create_punch_specimen:

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

Creates a Punch Response template that configures data-extraction sensors for punch-specimen simulations (force, displacement, diameter, and optional DIC strain). Use this worker to register a named response template before running post-processing or curve-matching workflows on punch test results.

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

Tagged: ``curve_match``, ``data_extraction``, ``diameter``, ``punch``, ``punch_contact``, ``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 file (UIFTDS format) used to pre-populate sensor definitions in the template; leave blank to define all sensors manually via the other inputs.
   * - Template Name
     - template_name
     - text
     - Generic Punch Tensile Template
     - ✓
     - Human-readable name assigned to the new response template; defaults to 'Generic Punch Tensile Template' and must be unique unless delete_existing is set to 'yes'.
   * - Reference Curve
     - ref_curve
     - vector
     - —
     - ✓
     - Reference (physical-test) curve supplied as a 2-column vector (X, Y) used to compute curve-match error against the simulation result.
   * - Reference Type
     - ref_curve_type
     - select
     - fd
     - ✓
     - Declares the physical meaning of ref_curve — choose from Force-Displacement ('fd'), Engineering Stress-Strain ('eng_ss'), True Stress-Strain ('true_ss'), or DIC Strain vs Displacement ('dic_strain') so the template applies the correct comparison metric.
   * - Specimen PID
     - specimen_pid
     - text
     - 1
     - ✓
     - LS-DYNA part ID (integer) of the punch specimen shell/solid elements used to scope strain and stress extraction.
   * - Punch Node
     - punch_node_id
     - text
     - 1
     - ✓
     - LS-DYNA node ID (integer) of the punch tool node from which displacement is tracked during the simulation.
   * - PCFI
     - punch_contact_id
     - text
     - 1
     - ✓
     - LS-DYNA contact interface ID (integer) whose contact force output is used as the punch force signal (PCFI — Punch Contact Force Id).
   * - PNFPDC
     - punch_nodes
     - text
     - 1
     - ✓
     - Comma-separated list of three LS-DYNA node IDs that define the punch geometry circle used to calculate punch diameter during deformation (PNFPDC).
   * - BNFBDC
     - blank_nodes
     - text
     - 1
     - ✓
     - Comma-separated list of three LS-DYNA node IDs that define the blank geometry circle used to calculate blank diameter during deformation (BNFBDC).
   * - 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, leave at default 'no' to abort if a name collision occurs.

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 Punch Response template (dataType: responsetemplate) in the d3VIEW platform, used as input to downstream post-processing or curve-match workers.

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

- cae.postprocessing.extraction
- cae.postprocessing.response
- 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_punch_specimen</code>. Schema hash: <code>d177c40c4ddc</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>