.. _auto_lsdyna_fastener_failure_analysis:

*LSDYNA FASTENER FAILURE ANALYSIS*
==================================

Computes time-history Factor of Safety curves for bolted-joint sections from an LS-DYNA secforc (binout) output. Implements the five Shigley/AISC failure criteria used by InDepth FastenerPro: tension, shear (von Mises 0.577 factor), slip, combined tension+shear (quadratic interaction), and combined tension+slip (Kulak preload reduction). Bolt is identified by SAE inch grade + size (e.g. SAE Grade 8, 1/2-13) or ISO metric class + size (e.g. ISO Class 10.9, M12); preload comes from a direct force input or is derived from a tightening torque using F = T / (K * D). Returns per-section FOS curves and minimum-FOS summary suitable for downstream charting or report generation.

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

Tagged: ``binout``, ``bolt``, ``combined_loading``, ``factor_of_safety``, ``fastener``, ``fos``, ``iso``, ``joint``.

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 record whose binout secforc data will be read; select from the remote simulation lookup.
   * - Bolt Section IDs
     - section_ids
     - string
     - —
     - 
     - Comma-separated list of LS-DYNA section IDs (DATABASE_SECFORC) representing bolt cross-sections to analyze (e.g. "101,102,103").
   * - Units System
     - units_system
     - string
     - inch
     - 
     - Unit system for the bolt grade and size database lookup. "inch" uses SAE/ASTM grades with diameters in inches and stresses in psi; "metric" uses ISO classes with diameters in mm and stresses in MPa.
   * - Bolt Grade
     - bolt_grade
     - string
     - SAE Grade 8
     - 
     - Bolt grade from the FastenerPro built-in database. Inch options: SAE Grade 1/2/5/5.2/7/8/8.2, ASTM A325, ASTM A354 Gr BC, ASTM A354 Gr BD, ASTM A490. Metric options: ISO Class 4.6/4.8/5.8/8.8/9.8/10.9/12.9.
   * - Bolt Size
     - bolt_size
     - string
     - 1/2-13
     - 
     - Bolt size designator. Inch options: 1/4-20 ... 1-1/2-6 (UNC and UNF). Metric options: M3, M4, M5, M6, M8, M10, M12, M14, M16, M18, M20, M22, M24, M27, M30, M33, M36, M39, M42, M45, M48.
   * - Axial Force Axis
     - axial_axis
     - string
     - x
     - 
     - Which secforc force component represents the bolt axial direction. Shear is computed as the resultant of the other two components.
   * - Slip Friction Coefficient (mu)
     - friction_coefficient
     - float
     - 0.33
     - 
     - Slip-critical-joint friction coefficient (Class A clean steel surface ~ 0.33 per AISC). Used in slip and combined tension+slip criteria.
   * - Preload Axial Force
     - preload_force
     - float
     - —
     - 
     - Optional bolt preload (clamping force) in lbf (inch) or N (metric). If left blank, preload is derived from preload_torque using F = T / (K * D) with K = 0.2.
   * - Preload Torque
     - preload_torque
     - float
     - —
     - 
     - Optional installation torque in lbf-in (inch) or N-mm (metric). Used only when preload_force is blank; converted to force via F = T / (K * D) with K = 0.2.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - FOS Results
     - fos_results
     - dataset
     - Per-section FOS time-history curves (tension, shear, slip, combined T+shear, combined T+slip) plus the minimum FOS summary per criterion. Indexed by section ID.
   * - Summary
     - summary
     - dataset
     - Bolt configuration (grade, size, Sp/Sy/Su, A_t, A_s, units), preload, friction, axial axis, and per-section minimum FOS rows. Suitable for tabular reporting.
   * - Bolt Data
     - bolt_data
     - dataset
     - Looked-up bolt properties (diameter, tensile area, shank area, proof / yield / ultimate strengths, units) for the selected grade and size.

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

- cae.postprocessing.extraction
- cae.postprocessing.response
- engineering.fastener.analysis
- engineering.structural.bolted_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_fastener_failure_analysis</code>. Schema hash: <code>8a23ecb9d687</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>