.. _auto_material_specimen_generator_notch:

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

Generates parametric notch specimen LS-DYNA decks for material characterization testing, supporting 3D-tetra and shell element formulations across a range of notch radii, gauge widths, and mesh sizes. Select the desired specimen geometry and mesh parameters to produce a ready-to-run keyword file. Use this worker when setting up notch-tension coupon simulations for GISSMO or failure-surface calibration workflows.

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

Classification: **data**.

Tagged: ``coupon``, ``gissmo``, ``keyword``, ``lsdyna``, ``material_calibration``, ``mesh``, ``notch``, ``notch_tension``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Type
     - type
     - string
     - E8_shell_regular_3mm
     - 
     - Notch specimen geometry to generate; choose from the dropdown of 3D-tetra (solid) and shell variants parameterised by notch radius (R), gauge half-width (a), and element size (mm) — default 'E8_shell_regular_3mm' is a standard uniaxial shell coupon.
   * - Thickness
     - thickness
     - scalar
     - 1
     - 
     - Shell element thickness in mm applied to shell-based specimens; ignored for 3D-tetra variants — default is 1 mm.
   * - Elform
     - elform
     - scalar
     - 16
     - 
     - LS-DYNA element formulation ID (ELFORM keyword field) for the generated elements, e.g. 16 for fully-integrated 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
     - 
     - 
   * - Grip Size 0-Default
     - grip_size0-default
     - scalar
     - 0
     - 
     - Grip to grip distance
   * - Additional Keywords
     - additionalkeywords
     - text
     - —
     - 
     - Add additional keywords (Optional)
   * - Gage Width
     - gagewidth
     - scalar
     - 7.82
     - 
     - Gage width

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - material_specimen_generator_notch_output_1
     - material_specimen_generator_notch_output_1
     - text
     - LS-DYNA keyword (.k) deck text defining the notch specimen mesh, section, and boundary conditions, ready for solver submission or downstream material-calibration workflows.

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

- cae.preprocessing.deck_authoring
- engineering.material.calibration
- engineering.material.failure
- 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_notch</code>. Schema hash: <code>cce1d1095fbd</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>