.. _auto_lsdyna_spotweld_daimler_generator:

*CONVERTS LS-DYNA SPOTWELD TO FAILURE INFORMATION*
==================================================

Reads spotweld failure-stress data for metal pairs and generates Daimler-format LS-DYNA spotweld material definitions, including normal, bending, and shear failure stresses together with optional yield stress and tangent modulus parameters. Use this worker to automate MAT_SPOTWELD (or equivalent) keyword authoring from tabular test or characterisation data.

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

Tagged: ``daimler``, ``failure_stress``, ``files``, ``keyword_generation``, ``lsdyna``, ``mat_spotweld``, ``spotweld``, ``weld_material``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - SDTITFSFPOM
     - spotweld_data
     - dataset
     - —
     - ✓
     - Tabular dataset (repeatable) containing spotweld failure stresses for metal-pair combinations; each row represents one unique pair and must include at minimum the normal, bending, and shear stress columns.
   * - Starting MID
     - starting_mid
     - text
     - 1
     - ✓
     - Integer LS-DYNA Material ID from which the sequential numbering of generated spotweld materials begins; defaults to 1.
   * - Connection Offset
     - connection_offset
     - text
     - 1
     - ✓
     - Integer offset added to the starting MID to derive the connection (weld entity) ID, allowing separation of material IDs from connection IDs in the deck; defaults to 1.
   * - Yield Stress Column
     - yield_stress_column
     - text
     - yield_stress_column
     - 
     - Name of the column in spotweld_data that holds the yield stress (stress units match the model unit system); leave at default 'yield_stress_column' if yield stress is not available or not required.
   * - Tangent Modulus Column
     - tangent_modulus_column
     - text
     - tangent_modulus
     - 
     - Name of the column in spotweld_data that holds the tangent (plastic) modulus; leave at default 'tangent_modulus' if tangent modulus is not required in the output material card.
   * - Normal Stress Column
     - normal_stress_col
     - text
     - normal_stress
     - ✓
     - Name of the column in spotweld_data containing the peak normal (axial) failure stress; required — default 'normal_stress' must be overridden if the column is named differently.
   * - Bending Stress Column
     - bending_stress_col
     - text
     - bending_stress
     - ✓
     - Name of the column in spotweld_data containing the bending failure stress; required — default 'bending_stress' must be overridden if the column is named differently.
   * - Shear Stress Column
     - shear_stress_col
     - text
     - shear_stress
     - ✓
     - Name of the column in spotweld_data containing the shear failure stress; required — default 'shear_stress' must be overridden if the column is named differently.
   * - Normal Exponent Column
     - normal_exp_col
     - text
     - normal_exponent
     - 
     - Name of the column in spotweld_data containing the normal-stress failure exponent used in the Daimler spotweld failure criterion; required for correct failure surface definition.
   * - Bending Exponent Column
     - bending_exp_col
     - text
     - bending_exponent
     - 
     - Column that contains the bending exponent
   * - Shear Exponent Column
     - shear_exp_col
     - text
     - shear_exponent
     - 
     - Column that contains the shear exponent
   * - Spotweld Type
     - spotweld_type
     - select
     - elastic-plastic
     - 
     - 
   * - Spotweld MID Column
     - mid_col
     - text
     - null
     - 
     - Column that contains the MID. If unspecified, the Starting MID will be ignored
   * - Layer ID Column
     - layer_id_column
     - text
     - —
     - 
     - Indicates the layer type such as 2T/3T/4T weld type
   * - GFAD Column
     - gfad_col
     - text
     - gfad
     - 
     - Fading energy column
   * - SM1NC
     - sm1name_col
     - text
     - —
     - 
     - This is the name column containing the sheet-metal 1 of the weld to include in material title
   * - S2NC
     - sm2name_col
     - text
     - —
     - 
     - This is the name column containing the sheet-metal 2 of the weld to include in material title
   * - S1TC
     - smt1_col
     - text
     - gfad
     - 
     - This is the thickness column name for sheet-metal 1 to include in material title
   * - S2TC
     - smt2_col
     - text
     - gfad
     - 
     - This is the thickness column name for sheet-metal 1 to include in material title

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Spotweld test data
     - spotweld_failures
     - dataset
     - Dataset tabulating the processed spotweld failure parameters (normal, bending, shear stresses, exponents, MIDs) for each metal pair, suitable for review or downstream postprocessing.
   * - Spotweld LS-DYNA material
     - spotweld_material
     - text
     - Plain-text LS-DYNA keyword block (e.g. *MAT_SPOTWELD cards) ready to be included or appended to a simulation deck.
   * - Logs
     - logs
     - dataset
     - Execution log dataset recording any warnings, skipped rows, or ID-assignment details produced during material card generation.

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

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

.. raw:: html

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