.. _auto_material_specimen_generator_uniaxial:

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

Generates a ready-to-run LS-DYNA uniaxial tensile specimen keyword deck (.k) for a selected ASTM E8 coupon geometry and mesh size. Choose from standard, large, or custom-dimension shell configurations spanning element sizes from 0.25 mm to 6 mm. Use this worker to produce the simulation input file before running a material characterization or calibration workflow.

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

Classification: **data**.

Tagged: ``ASTM_E8``, ``E8``, ``LS-DYNA``, ``coupon``, ``keyword``, ``mat_24``, ``material_testing``, ``mesh``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Choose Specimen Type
     - type
     - string
     - E8_shell_standard_1mm
     - 
     - Select Specimen from the list
   * - Thickness
     - thickness
     - scalar
     - 1
     - 
     - Shell Thickness
   * - Elform
     - elform
     - scalar
     - 16
     - 
     - Element Formulation
   * - 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
   * - Loading Type
     - vad
     - scalar
     - 2
     - 
     - Velocity, Acceleration, Displacement or Strain-rate loading type
   * - Loading Input
     - loading_input_type
     - scalar
     - constant
     - 
     - Load Curve is constant or varying based on Curve
   * - Loading value based on type
     - loading_value
     - scalar
     - 25
     - 
     - Loading input based on type
   * - Total Simulation Duration
     - duration
     - scalar
     - 100
     - 
     - When strain-rate loading is chosen, the duration will be updated based on elongation desired
   * - 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
     - 
     - DTO
   * - ILIMIT
     - ilimi_t
     - scalar
     - 10
     - 
     - 
   * - MAXREF
     - maxre_f
     - scalar
     - 15
     - 
     - 
   * - IACC
     - iac_c
     - list
     - 0
     - 
     - 
   * - GS0TE
     - grip_size0-endto_end
     - scalar
     - 0
     - 
     - Grip to grip distance
   * - Additional Keywords
     - additionalkeywords
     - text
     - *COMMENT
     - 
     - Add additional keywords (Optional)
   * - Gage Width
     - gagewidth
     - scalar
     - 0
     - 
     - If zero, default will be used based on the specimen type
   * - Gage Length
     - gagelength
     - scalar
     - 0
     - 
     - If zero, default will be used based on the specimen type
   * - Extensometer Length
     - extensometerlength
     - scalar
     - 0
     - 
     - If Zero, default value will be used based on the specimen type
   * - Lcint
     - lcint
     - scalar
     - 100
     - 
     - Number of points to use for curve digitization
   * - Custom Specimen
     - custom
     - textarea
     - —
     - 
     - Custom specimen using a PHP-Smarty Template
   * - Strain-rate Base Length
     - strain_rate_base_length
     - list
     - extensometer
     - 
     - 
   * - Elongation to enforce when strain-rate is provided
     - sr_elongation
     - text
     - 0.0
     - 
     - When this is zero, simulation is run until the gage length elongation is achieved
   * - QS Strain-rate Upper Limit
     - qs_sr
     - text
     - 0.0
     - 
     - When the specified strain-rate is lower than this, a scale factor can be specified below to scale the velocity
   * - QS Velocity Scale factor
     - qs_vel_sf
     - text
     - 1.0
     - 
     - Velocity scale factor to use when the specified strain-rate is equal to or lower than the quasi-static strain-rate

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - material_specimen_generator_uniaxial_output_1
     - material_specimen_generator_uniaxial_output_1
     - text
     - LS-DYNA keyword file (.k) defining the full uniaxial tensile specimen mesh, boundary conditions, and control cards, ready for direct solver submission or downstream material calibration.

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_uniaxial</code>. Schema hash: <code>53ef073ae817</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>