.. _auto_dynakeyword_prepare_quasistatic_specimen:

*PREPARE A QUASI-STATIC FRACTURE-SPECIMEN DECK*
===============================================

Make a generated LS-DYNA fracture-specimen deck run-ready for quasi-static characterization: de-collide duplicate *SET_NODE ids (a preset defect that error-terminates LS-DYNA), inject a *DATABASE_HISTORY_*_SET so elout captures the gauge, and optionally inject *CONTROL_IMPLICIT_AUTO to cap the time step so the loading path is resolved across many states.

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

Classification: **data**.

Tagged: ``LS-DYNA``, ``deck_authoring``, ``keyword``, ``fracture``, ``specimen``, ``quasi_static``, ``implicit``, ``elout``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Specimen Deck
     - deck
     - text
     - —
     - ✓
     - Raw LS-DYNA specimen deck (the generator preset output) to make run-ready for quasi-static fracture characterization.
   * - History Kind
     - history_kind
     - scalar
     - solid
     - 
     - 'solid' or 'shell' -- selects *SET_SOLID_GENERAL/ALL vs *SET_SHELL_GENERAL/PART for the injected *DATABASE_HISTORY card so elout captures the gauge.
   * - Set ID
     - set_id
     - scalar
     - 991
     - 
     - Set id used for the injected *SET_*_GENERAL + *DATABASE_HISTORY_*_SET pair.
   * - Part ID
     - part_id
     - scalar
     - 1
     - 
     - Part id for the shell gauge selector (*SET_SHELL_GENERAL PART). Ignored for solids (which use ALL).
   * - Inject Implicit Auto
     - inject_implicit
     - scalar
     - yes
     - 
     - 'yes' injects *CONTROL_IMPLICIT_AUTO capping the time step so the quasi-static solve writes many states; 'no' leaves stepping to the deck.
   * - Implicit DT Max
     - implicit_dt_max
     - scalar
     - 1.0
     - 
     - DTMAX cap for *CONTROL_IMPLICIT_AUTO (= duration / target states). Only used when inject_implicit='yes'.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - dynakeyword_prepare_quasistatic_specimen_output_1
     - dynakeyword_prepare_quasistatic_specimen_output_1
     - text
     - The run-ready deck: duplicate *SET_NODE ids de-collided, a *DATABASE_HISTORY_*_SET injected so elout captures the gauge, and (optionally) *CONTROL_IMPLICIT_AUTO injected to resolve the stress-triaxiality path.

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

- cae.preprocessing.deck_authoring
- engineering.crash.dynamics
- engineering.material.calibration

.. raw:: html

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