.. _auto_file_parse_parameters:

*PARSE PARAMETERS IN A FILE*
============================

Parses a solver input file (LS-DYNA, Madymo, or Nastran) and extracts its named parameters together with their current values into a tabular dataset. Use this worker to inspect or inventory all parameters defined in a deck before substituting new values in a downstream authoring step.

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

Tagged: ``deck_parsing``, ``file_parse``, ``keyword``, ``lsdyna``, ``madymo``, ``nastran``, ``parameter_extraction``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - File
     - file
     - file
     - —
     - ✓
     - The solver input deck file to parse (e.g. a .k / .key LS-DYNA keyword file, a Madymo .xml/.mmf file, or a Nastran .bdf/.dat file); must be a valid text-based solver input format.
   * - Solver Type
     - solver_type
     - select
     - lsdyna
     - ✓
     - Solver dialect used to interpret parameter syntax: 'lsdyna' for LS-DYNA *PARAMETER keywords, 'Madymo' for Madymo parameter blocks, or 'nastran' for Nastran PARAM/DMAP entries; defaults to 'lsdyna'.
   * - Format
     - format
     - select
     - short
     - ✓
     - Field-width format of the solver deck — 'short' (8-character fields, LS-DYNA default) or 'long' (16-character fields); leave at default 'short' unless the deck was authored in long format.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Parameters
     - parameters
     - dataset
     - Tabular dataset (rows = parameters) containing each parameter name and its parsed value as found in the input deck; suitable for direct inspection or as feed-in to a parameter-substitution worker.

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

- cae.preprocessing.deck_authoring
- data.dataset.ingest
- data.io.file

.. raw:: html

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