.. _auto_lsdyna_section_force_analyzer:

*LSDYNA SECTION FORCE ANALYZER (AUTO BOLT-VS-STRUCTURE)*
========================================================

Reads SECFORC for an LS-DYNA simulation, computes peak axial / shear / moment per section, and auto-classifies each section as a bolt (when the section's area falls within ±tolerance of a known SAE inch or ISO metric tensile-stress area from FastenerData) or as a structural section. Bolt rows include the matched grade/size hint and a recommendation to pipe through lsdyna_fastener_failure_analysis. Structure rows surface peak forces, peak moment magnitude and a first-order axial / shear stress estimate using the reported area.

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

Tagged: ``auto_classify``, ``binout``, ``bolt``, ``fastener``, ``lsdyna``, ``peak_force``, ``secforc``, ``section_analysis``.

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 SECFORC will be read.
   * - Units System
     - units_system
     - string
     - metric
     - 
     - Unit system for the section area lookup. "metric" expects mm^2; "inch" expects in^2.
   * - Area match tolerance (%)
     - area_tolerance_pct
     - float
     - 10
     - 
     - ± tolerance for bolt-area match. A section whose area lies within ±this percent of a tabulated tensile-stress area is classified as a bolt of that grade/size.
   * - Top-N sections
     - top_n_sections
     - integer
     - 1000
     - 
     - Hard cap on the number of sections analyzed, keeping the extractor bounded on large models.
   * - Section ID → area overrides (CSV)
     - section_id_to_area_csv
     - text
     - —
     - 
     - Optional CSV (id,area per line) overriding the binout's reported area for these section IDs. Used when SECFORC does not export the area channel or when the user has more accurate values from the model card.
   * - Force source
     - source
     - string
     - secforc
     - 
     - Which binout force branch to analyze. secforc = cross-section forces with bolt/structure classification by area. rcforc = contact interface resultant forces classified tied vs sliding/penalty. nodfor = nodal force-group resultant forces ranked by peak.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Bolt-Classified Sections
     - bolts
     - dataset
     - SECFORC only. Per-section rows with id, label, area, peak axial/shear/moment, classified_size, classified_system (inch/metric), classified_A_t, area_match_pct and a recommended_workflow pointer.
   * - Structural Sections
     - structures
     - dataset
     - SECFORC only. Per-section rows with id, label, area, peak axial/shear/moment plus first-order axial / shear stress estimate (peak force / area).
   * - Rows
     - rows
     - dataset
     - RCFORC / NODFOR. Per-id rows ranked by peak resultant force. RCFORC: id, label, kind (tied/contact), peak_force, peak_force_t, peak_moment, tie_area, series. NODFOR: id, label, peak_force, peak_force_t, energy_peak, series.
   * - Columns
     - columns
     - dataset
     - RCFORC / NODFOR. Ordered column descriptors {key, label, fmt} the frontend renders the table from.
   * - Summary
     - summary
     - dataset
     - {source, total, ...} plus source-specific counts (bolt_count/structure_count for secforc, tied_count/contact_count for rcforc).

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

- cae.postprocessing.extraction
- cae.postprocessing.response
- engineering.fastener.analysis
- engineering.structural.section_analysis

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