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¶
| 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¶
| 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
Auto-generated from platform schema. Worker id: lsdyna_fastener_failure_analysis. Schema hash: 8a23ecb9d687. Hand-curated docs in workerexamples/ override this page when present.