.. _auto_lsdyna_spotweld_failure_analysis:

*LSDYNA SPOTWELD FAILURE ANALYSIS (DAIMLER-CHRYSLER)*
=====================================================

Computes Daimler-Chrysler spotweld damage-ratio time-history from an LS-DYNA swforc (binout) output. Implements the MAT_SPOTWELD_DAIMLERCHRYSLER failure surface DR(t) = (max(0,Fn)/Fnf)^EXSN + (Fs/Fsf)^EXSS + (Fb/Fbf)^EXSB, where Fn/Fs/Fb are the axial / shear / bending histories from the binout and Fnf/Fsf/Fbf are the user-supplied capacities. DR(t) >= 1 marks failure. Returns per-spotweld DR + FOS curves, the time of peak DR, and a per-spotweld minimum-FOS summary suitable for downstream charting or report generation.

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

Tagged: ``binout``, ``daimler_chrysler``, ``damage_ratio``, ``dc``, ``factor_of_safety``, ``failure``, ``fos``, ``lsdyna``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - simulation_id
     - remote_lookup
     - —
     - 
     - Reference to the LS-DYNA simulation whose binout swforc data will be read.
   * - Spotweld IDs
     - spotweld_ids
     - string
     - —
     - 
     - Comma-separated list of swforc spotweld IDs to analyze. Leave empty to analyze every spotweld in swforc.
   * - Normal Capacity (Fnf)
     - sn_capacity
     - float
     - 0
     - 
     - Normal (tension) failure capacity Fnf in force units consistent with the binout (lbf or N). Compression is ignored (tension-only). Set to 0 to skip the normal term.
   * - Shear Capacity (Fsf)
     - ss_capacity
     - float
     - 0
     - 
     - Shear failure capacity Fsf in force units consistent with the binout. Set to 0 to skip the shear term.
   * - Bending Capacity (Fbf)
     - sb_capacity
     - float
     - 0
     - 
     - Bending failure capacity Fbf in moment units consistent with the binout. Set to 0 (or leave at 0) when swforc does not provide a moment channel.
   * - Normal Exponent (EXSN)
     - exsn
     - float
     - 2.0
     - 
     - Daimler-Chrysler normal-term exponent (LS-DYNA EXSN). Default 2.0.
   * - Shear Exponent (EXSS)
     - exss
     - float
     - 2.0
     - 
     - Daimler-Chrysler shear-term exponent (LS-DYNA EXSS). Default 2.0.
   * - Bending Exponent (EXSB)
     - exsb
     - float
     - 2.0
     - 
     - Daimler-Chrysler bending-term exponent (LS-DYNA EXSB). Default 2.0.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - DR Results
     - dr_results
     - dataset
     - Per-spotweld DR + FOS time-history plus min-FOS / peak-DR summary. Indexed by spotweld ID.
   * - Summary
     - summary
     - dataset
     - Capacities, exponents, total spotweld count, failed-spotweld count, and per-spotweld peak-DR rows (sorted by peak DR descending). Suitable for tabular reporting.

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

- cae.postprocessing.extraction
- cae.postprocessing.response
- engineering.spotweld.analysis
- engineering.structural.welded_joint

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