.. _auto_material_specimen_generator_ksii:

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

Generates a parameterized LS-DYNA keyword deck for a KSII-type sheet-metal weld/coupon specimen with configurable thicknesses, element formulations, and material IDs. Use this worker to rapidly author specimen input decks for material characterization or coupon-level crash simulations.

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

Classification: **data**.

Tagged: ``coupon``, ``deck_authoring``, ``elform``, ``haz``, ``ksii``, ``ls-dyna``, ``mat_24``, ``material_id``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Type
     - type
     - string
     - ksii_specimen_4mm_mesh
     - 
     - Specimen template to instantiate; currently only 'ksii_specimen_4mm_mesh' (KSII coupon with 4 mm shell mesh) is available — leave as default unless new templates are registered.
   * - Sheet Metal-1 Thickness
     - sheetmetal-1thickness
     - scalar
     - 1
     - 
     - Nominal thickness of sheet-metal blank 1 (mm, scalar); default 1 mm — set to the actual gauge of the first sheet in the welded coupon.
   * - Sheet Metal-2 Thickness
     - sheetmetal-2thickness
     - scalar
     - 1
     - 
     - Nominal thickness of sheet-metal blank 2 (mm, scalar); default 1 mm — set to the actual gauge of the second sheet when the two blanks differ.
   * - Sheet Metal Elform
     - sheetmetal_elform
     - scalar
     - 16
     - 
     - LS-DYNA shell element formulation (ELFORM) applied to both sheet-metal parts (integer); default 16 (fully-integrated shell) — change only if a different formulation is required by the simulation protocol.
   * - Sheet-metal 1 MID
     - sheet-metal1
     - scalar
     - 1
     - 
     - LS-DYNA material ID (MID) assigned to sheet-metal part 1 (integer); default 1 — must match the MID of the base-metal card already defined in the parent deck.
   * - S1HM
     - sheet-metal1hazmi_d
     - scalar
     - 1
     - 
     - LS-DYNA material ID (MID) for the Heat-Affected Zone (HAZ) region of sheet-metal 1 (integer); default 1 — set to the HAZ material card ID when a dedicated HAZ material is used.
   * - S2MI
     - sheet-metal2mi_d
     - scalar
     - 1
     - 
     - LS-DYNA material ID (MID) assigned to sheet-metal part 2 (integer); default 1 — must match the MID of the second blank's material card in the parent deck.
   * - S2HMI
     - sheet-metal2hazmi_d
     - scalar
     - 1
     - 
     - Sheet-metal 2 HAZ Material ID
   * - Spotweld Material MID
     - spotweld_material_mi_d
     - scalar
     - 1
     - 
     - 
   * - Loading Direction
     - loading_direction
     - scalar
     - tension
     - 
     - 
   * - Loading Displacement
     - loading_displacement
     - scalar
     - 10
     - 
     - 
   * - End Time
     - end_time
     - scalar
     - 10
     - 
     - CONTROL_TERMINATION
   * - Binary Output Frequency
     - binary_output_frequency
     - scalar
     - 1
     - 
     - 
   * - ASCII Output Frequency
     - ascii_output_frequency
     - scalar
     - 0.1
     - 
     - 
   * - Material Data
     - material_data
     - text
     - *MAT_ELASTICn1,1.0e-9,210.0,0.3n
     - 
     - Material Card
   * - Additional Keywords
     - additionalkeywords
     - text
     - *END
     - 
     - Addition Keywords (Optional)

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - material_specimen_generator_ksii_output_1
     - material_specimen_generator_ksii_output_1
     - text
     - LS-DYNA keyword text (plain text) containing the fully parameterized KSII specimen deck — includes shell part definitions, section cards, material ID references, and mesh keywords ready for inclusion in a simulation input file.

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

- cae.preprocessing.deck_authoring
- 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_ksii</code>. Schema hash: <code>cc87f35b6769</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>