.. _auto_lsdyna_keyword_summary:

*LS-DYNA KEYWORD FILE SUMMARY*
==============================

Opens an LS-DYNA keyword file in LS-PrePost headlessly and returns a model summary: card counts by type (PART, MAT, ELEMENT, NODE, SECTION, CONTACT, etc.), file size, and read time. Use to inspect a model before or after editing.

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

Tagged: ``card-counts``, ``headless``, ``keyword``, ``ls-prepost``, ``lsdyna``, ``model-summary``, ``refcheck``, ``simulation``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - simulation_id
     - text
     - —
     - 
     - d3VIEW Simulation ID whose registered main keyword file will be summarised; mutually exclusive with `file` — at least one must be provided.
   * - File
     - file
     - file
     - —
     - 
     - Direct file path, attachment ID, or uploaded file pointing to the LS-DYNA keyword (.k / .key) to summarise; used when no simulation_id is available.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Summary Report
     - report
     - text
     - Human-readable plain-text summary including read time, file size in bytes, and a formatted list of card-type counts (PART, MAT, NODE, ELEMENT, etc.).
   * - Card Counts
     - card_counts
     - text
     - JSON object mapping each detected keyword card type to its integer count (e.g. {"PART":12,"MAT":2,"NODE":15220}); suitable for downstream programmatic consumption.
   * - Read Time
     - read_time
     - text
     - Wall-clock time LS-PrePost took to parse the keyword file, expressed as a string in seconds (e.g. "1.42s"); empty string if not reported by LS-PrePost.
   * - File Size
     - file_size
     - number
     - Raw size of the keyword file in bytes as reported by the filesystem; useful for tracking model growth across revisions.
   * - STDOUT
     - stdout
     - textarea
     - Full raw standard-output text captured from the LS-PrePost headless process; use for debugging parse errors or unexpected card-count results.

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

- cae.postprocessing.extraction
- cae.preprocessing.setup

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