.. _auto_fem_bom:

*FEM BILL OF MATERIALS*
=======================

Builds a bill of materials from an LS-DYNA model. For every part it reports material class, section thickness, area, volume, mass and density; connection count, area and types (weld, rigid, adhesive, tied); detected features (holes, slots, slits); a geometric part class (panel, rail, wheel, tire, bracket, casting...); and the assembly it belongs to (body-in-white, front/rear suspension, bumper system, wheels & tires, powertrain, closures...). Optionally renders a per-part thumbnail in LS-PrePost.

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

Tagged: ``bom``, ``bill_of_materials``, ``lsdyna``, ``parts``, ``mass``, ``connections``, ``assembly``, ``classification``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Model files
     - input_files
     - file
     - —
     - ✓
     - The LS-DYNA model: the master deck plus its include files. Can be fed from a simulation's files or an uploaded set.
   * - Master file pattern
     - main_file_pattern
     - text
     - —
     - 
     - Optional substring to pick the master deck among the inputs (e.g. 'main' or 'master'). Defaults to the first file.
   * - Solver
     - solver
     - select
     - lsdyna
     - 
     - Solver format of the model. LS-DYNA is currently supported.
   * - Generate part thumbnails
     - generate_thumbnails
     - select
     - no
     - 
     - When Yes, renders a per-part image in LS-PrePost and includes it as a thumbnail column (requires LS-PrePost on the server).
   * - Include connections dataset
     - include_connections
     - select
     - no
     - 
     - When Yes, also returns a Connections dataset: one row per connection found in the model (weld / bolt / clip / insert / rigid / adhesive) with the parts joined, centroid, footprint area, mass, volume and stiffness.
   * - Include loads & boundary dataset
     - include_loads
     - select
     - no
     - 
     - When Yes, returns a Loads & Boundary dataset listing each *LOAD_, *BOUNDARY_ and *INITIAL_ card with its target id.
   * - Include parameters dataset
     - include_parameters
     - select
     - no
     - 
     - When Yes, returns a Parameters dataset with every *PARAMETER name, value and how many times it is referenced.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Bill of Materials
     - bom
     - dataset
     - One row per part with material, thickness, area, volume, mass, connections, features, geometric part class and assembly.
   * - Connections
     - connections
     - dataset
     - One row per connection (opt-in): type, joined parts, centroid, footprint area, mass, volume and stiffness.
   * - Loads & Boundary
     - loads
     - dataset
     - Opt-in: each load, boundary condition and initial condition with its target id.
   * - Parameters
     - parameters
     - dataset
     - Opt-in: every *PARAMETER name, value and reference count.
   * - BOM Summary
     - summary
     - keyvalue
     - Part count, total mass, and counts by assembly and material.
   * - Part Count
     - part_count
     - scalar
     - Number of parts in the model.

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

- engineering.cae.preprocessing
- platform.post_processing

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>fem_bom</code>. Schema hash: <code>158cfa090b91</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>