.. _auto_material_specimen_generator_shear:

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

Generates LS-DYNA shear specimen decks for material coupon simulations. Select from a library of shear specimen geometries (0-degree orientations, Waterloo variants, mesh sizes from 0.1 mm to 4 mm) and configure shell element properties before submitting a calibration or characterization job.

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

Classification: **data**.

Tagged: ``coupon``, ``deck_generation``, ``dt2ms``, ``elform``, ``ls-dyna``, ``mass_scaling``, ``material_testing``, ``nip``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Specimen Type
     - type
     - string
     - E8_shell_regular_3mm
     - 
     - Shear specimen geometry variant to generate; choose from 0-degree shear geometries at various mesh sizes (0.1 mm, 0.5 mm, 1 mm, 2 mm, 4 mm) and Waterloo-variant options — defaults to 'E8_shell_regular_3mm' if left unchanged, but should be set to the desired shear geometry ID.
   * - Specimen Thickness
     - thickness
     - scalar
     - 1
     - 
     - Shell element through-thickness value (mm); set to match the physical coupon thickness being simulated — defaults to 1 mm.
   * - Element Formulation Type
     - elform
     - scalar
     - 16
     - 
     - LS-DYNA shell element formulation type (ELFORM keyword integer, e.g. 16 = fully-integrated shell); defaults to 16 and should match the solver element technology used in the parent model.
   * - NIP
     - ni_p
     - scalar
     - 3
     - 
     - Number of through-thickness integration points (NIP) for the shell section; defaults to 3 — increase for higher bending accuracy or when using thick-shell formulations.
   * - DT2MS
     - mass-scaled_time_step
     - scalar
     - 0
     - 
     - Mass-scaling target time step (DT2MS, seconds); set to a negative value to enable mass scaling and accelerate explicit runs — defaults to 0 (mass scaling disabled).
   * - Membrane Thinning
     - membrane_thinning
     - scalar
     - 0
     - 
     - Controls the *CONTROL_SHELL MEMBRANE THINNING flag; governs whether membrane thinning effects are active in the shell formulation — defaults to 0 (disabled).
   * - Velocity - Acceleration - Displacement
     - 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
   * - IRATE
     - irat_e
     - scalar
     - 0
     - 
     - 
   * - 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
     - 92.5
     - 
     - Grip to grip distance
   * - Additional Keywords
     - additionalkeywords
     - text
     - —
     - 
     - Add additional keywords (Optional)
   * - Gage Width
     - gagewidth
     - scalar
     - 1.614
     - 
     - 
   * - Gage Length
     - gagelength
     - scalar
     - 4.76
     - 
     - 
   * - Lcint
     - lcint
     - scalar
     - 0
     - 
     - 

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - material_specimen_generator_shear_output_1
     - material_specimen_generator_shear_output_1
     - text
     - Generated LS-DYNA keyword deck (text/string) for the selected shear specimen configuration, ready for direct inclusion in a material calibration or coupon simulation workflow.

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

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