.. _auto_material_specimen_generator_tdcb:

*MATERIAL SPECIMEN GENERATOR — TDCB MODE I FRACTURE COUPON*
===========================================================

Generates an LS-DYNA TDCB (Tapered Double Cantilever Beam) Mode I fracture coupon for adhesive Mode I calibration (industry-standard ASTM D3433-style geometry). The two material parameters TENMAX and GCTEN are exposed as inputs so calibration sweeps can vary them without re-shipping the keyword deck. The rest of the deck (mesh, elements, contacts, controls, boundary conditions) is fixed.

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

Classification: **data**.

Tagged: ``adhesive``, ``calibration``, ``fracture``, ``keyword``, ``ls-dyna``, ``mat_169``, ``mat_arup_adhesive``, ``mode_i``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Element Formulation
     - elform
     - scalar
     - 1
     - 
     - Solid element formulation for the primary adherend section (*SECTION_SOLID secid=1). Exposed as IELFORM in *PARAMETER (referenced as &ELFORM). Default 1 (constant-stress). The cohesive adhesive section is left unchanged.
   * - Duration
     - duration
     - scalar
     - 800.0
     - 
     - Termination time (*CONTROL_TERMINATION endtim). Exposed as RETERM in *PARAMETER (referenced as &ETERM).
   * - Force Multiplier
     - force_multiplier
     - scalar
     - 1.0
     - 
     - Scale factor for force output / load curve referencing (exposed as RFMULT in *PARAMETER, referenceable as &FMULT). Use for unit conversion (e.g. 0.001 to report kN instead of N) or to combine with per-specimen-count assemblies. Default 1.0.
   * - Material Data (Full *MAT Card Override)
     - material_data
     - textarea
     - —
     - 
     - Optional. When set, the entire *MAT_ARUP_ADHESIVE block is replaced verbatim with this text — use to swap in a fully custom MAT card (e.g. *MAT_COHESIVE_MIXED_MODE_ELASTOPLASTIC_RATE) without editing the template. When empty (default), the templated *MAT_ARUP_ADHESIVE block built from rtenmax / rgcten / shrmax / gcshr is rendered.
   * - Additional Keywords
     - additional_keywords
     - textarea
     - —
     - 
     - Optional free-text LS-DYNA keywords (e.g. *COMMENT, extra *DEFINE_CURVE blocks, custom *SET_NODE definitions) appended after the standard deck and before the terminating *END card.
   * - Title
     - title
     - scalar
     - Sample TDCB Mode I coupon
     - 
     - Text that appears in the *TITLE block at the top of the generated keyword deck.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - material_specimen_generator_tdcb_output_1
     - material_specimen_generator_tdcb_output_1
     - text
     - Generated LS-DYNA keyword text for a TDCB Mode I fracture coupon with the supplied tensile-strength + Mode I fracture-energy parameters baked into the *PARAMETER block. Drop into the simulation deck as-is.

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

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