LSDYNA JOINT MAP BATCH ANALYSIS¶
End-to-end customer-facing workflow for fastener / joint analysis review. Two input modes: (a) with a simulation — user uploads an Excel ‘joint map’ (id, label, binout_source, type [bolt|spotweld|rivet|pin|adhesive], grade, size, allowables) and the worker reads each joint’s forces from secforc/rbdout/elout/deforc per its binout_source, applies the right evaluation standard per type (Shigley / AISC J2 / AISC J3 / Benzeggagh-Kenane), and returns FOS for every joint; (b) without a simulation — user supplies a pre-extracted force/moment dataset keyed by joint id, and the worker runs the same FOS calc on that. Output: master FOS table (one row per joint with min FOS per criterion + pass/warn/fail status) + per-joint time-history curves + run summary + parsed joint map.
When to use¶
Tagged: adhesive, batch, bolt, bonded_joint, csv, excel, fastener, fos.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Simulation | simulation_id | remote_lookup | — | Optional LS-DYNA simulation with binout output. If provided, the worker extracts forces per joint’s binout_source. If omitted, force_dataset must be provided. | |
| Joint Map (Excel) | joint_map_file | file | — | Excel (.xlsx) or CSV with columns: id, label, binout_source (secforc/rbdout/elout/deforc/swforc), type (bolt/spotweld/rivet/pin/adhesive), grade, size, system (inch/metric), optional axial_axis, friction_coefficient, preload_force, preload_torque, electrode, weld_leg, weld_length, temperature_C, substrate_pair, overlap_area_mm2, peel_width_mm, evaluation_standard, location, notes. | |
| Force Dataset (alt to simulation) | force_dataset | dataset | — | Pre-extracted force/moment time-histories keyed by joint id. Each row carries: id, time[], x_force[], y_force[], z_force[], x_moment[], y_moment[], z_moment[]. Use when no LS-DYNA binout is available (e.g., test data, Abaqus/Nastran imports). | |
| Design Method | design_method | string | asd | Weld design method: ASD (allowable stress, Ω=2.00) or LRFD (load + resistance factor, φ=0.75). Applies to AISC weld FOS only. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| Master FOS Table | master_table | dataset | One row per joint: id, label, type, grade, size, location, standard_applied, fos_tension, fos_shear, fos_combined, fos_lap_shear, fos_peel, fos_bk_mixed_mode, fos_min, status (pass/warn/fail/error), note. |
| Per-Joint Curves | per_joint_curves | dataset | Time-history FOS curves indexed by joint id — feed into Newton charts or downstream visualization. |
| Summary | summary | dataset | Run stats: total joints, pass / marginal / fail counts, lowest_fos in dataset, standards used, design method, simulation id. |
| Joint Map Parsed | joint_map_parsed | dataset | Normalized joint-map rows (after column name resolution + type-coercion) — useful for debugging the user’s spreadsheet. |
Disciplines¶
- engineering.fastener.analysis
- engineering.structural.bolted_joint
- engineering.structural.bonded_joint
- cae.postprocessing.batch
Auto-generated from platform schema. Worker id: lsdyna_joint_map_batch_analysis. Schema hash: 9428f4005ffa. Hand-curated docs in workerexamples/ override this page when present.