.. _auto_material_specimen_generator_punch:

*MATERIAL SPECIMEN GENERATOR*
=============================

Generates LS-DYNA keyword decks for biaxial punch (Nakazima-style) material specimens by parameterising geometry, mesh size, shell formulation, and boundary conditions. Use this worker to produce ready-to-run simulation input files for punch specimen coupon tests that feed material characterisation and failure-surface calibration workflows.

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

Classification: **data**.

Tagged: ``biaxial``, ``coupon``, ``deck``, ``elform``, ``gissmo``, ``keyword``, ``ls-dyna``, ``mat_24``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Specimen Type
     - type
     - string
     - punch_20mmdia_specimen28mmdia
     - 
     - Punch/specimen geometry template to use (e.g. 'punch_20mmdia_specimen28mmdia'); selects the pre-built LS-DYNA template file that defines punch diameter, specimen diameter, and mesh topology — default is 'punch_20mmdia_specimen28mmdia'.
   * - Specimen Thickness
     - specimen_thickness
     - scalar
     - 1
     - 
     - Shell element thickness of the specimen coupon in mm (scalar); controls the *SECTION_SHELL THICKNESS keyword entry — default is 1 mm.
   * - Elform
     - elform
     - scalar
     - 16
     - 
     - LS-DYNA shell element formulation integer (e.g. 16 = fully-integrated shell); maps directly to the ELFORM field in *SECTION_SHELL — default is 16.
   * - NIP
     - ni_p
     - scalar
     - 3
     - 
     - Number of Integration Points
   * - Mass-Scaled Time Step
     - mass-scaled_time_step
     - scalar
     - 0
     - 
     - Mass scaling time step
   * - Membrane Thinning
     - membrane_thinning
     - scalar
     - 0
     - 
     - *CONTROL_SHELL ISTUPD parameter
   * - V-A-D
     - velocity-acceleration-displacement
     - scalar
     - 2
     - 
     - VAD Load Curve Type
   * - Loading Input
     - loading_input_type
     - scalar
     - constant
     - 
     - Load Curve is constant or varying based on Curve
   * - Displacement Or Velocity Or Acceleration Value
     - displacementor_velocityor_acceleration_value
     - scalar
     - 25
     - 
     - Displacement Final value
   * - Duration
     - duration
     - scalar
     - 100
     - 
     - CONTROL_TERMINATION
   * - Binary Output Frequency
     - binary_output_frequency
     - scalar
     - 1
     - 
     - 
   * - ASCII Output Frequency
     - ascii_output_frequency
     - scalar
     - 0.1
     - 
     - 
   * - Material ID
     - material_i_d
     - scalar
     - —
     - 
     - 
   * - Material Data
     - material_data
     - text
     - —
     - 
     - Material Card
   * - IMFLAG
     - imfla_g
     - scalar
     - 0
     - 
     - 
   * - IMASS
     - imas_s
     - scalar
     - 0
     - 
     - 
   * - DT0
     - d_t0
     - scalar
     - 0.1
     - 
     - 
   * - ILIMIT
     - ilimi_t
     - scalar
     - 10
     - 
     - 
   * - MAXREF
     - maxre_f
     - scalar
     - 15
     - 
     - 
   * - IACC
     - iac_c
     - list
     - 0
     - 
     - 
   * - FS
     - f_s
     - scalar
     - 0
     - 
     - Static Friction
   * - FD
     - f_d
     - scalar
     - 0
     - 
     - Dynamic Friction
   * - Additional Keywords
     - additionalkeywords
     - text
     - —
     - 
     - Addition Keywords (Optional)
   * - Punch Diameter
     - punch_diameter
     - scalar
     - 0
     - 
     - Punch diameter
   * - Specimen Diameter
     - specimen_diameter
     - scalar
     - 0
     - 
     - Specimen diameter
   * - Lcint
     - lcint
     - scalar
     - 0
     - 
     - Number of points to discretize the curves in *CONTROL_OUTPUT

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - material_specimen_generator_punch_output_1
     - material_specimen_generator_punch_output_1
     - text
     - Generated LS-DYNA keyword input deck (plain text / .k file) for the selected punch specimen geometry, ready for solver submission or downstream material calibration workflows.

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

- cae.preprocessing.deck_authoring
- engineering.material.calibration
- engineering.material.characterization
- engineering.material.specimen

.. raw:: html

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