.. _auto_lsdyna_joint_map_batch_analysis:

*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
------

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

   * - 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
-------

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

   * - 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

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