.. _auto_lsdyna_parse_parameters_from_file:

*LS-DYNA PARSE PARAMETERS FROM FILE*
====================================

Parses *PARAMETER definitions from an LS-DYNA keyword file and returns them as a structured dataset. Use this worker to extract named parameters (e.g., design variables) for downstream DOE, optimisation, or deck-authoring workflows, including optional percentage-range metadata for each parameter.

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

Tagged: ``deck``, ``design_variables``, ``keyword``, ``lsdyna``, ``parameter_extraction``, ``parameters``, ``parse``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - LS-DYNA Keyword File
     - file_input_file
     - file
     - —
     - ✓
     - LS-DYNA keyword (.k / .key / .inc) file from which *PARAMETER cards will be parsed; must be a valid LS-DYNA input deck.
   * - Solver Type
     - solver_type
     - select
     - lsdyna
     - ✓
     - Solver dialect used to interpret the keyword file; currently only 'lsdyna' is supported — leave at the default value.
   * - Constants
     - constants
     - scalar
     - —
     - 
     - Comma-separated list of parameter names that should be treated as constants and excluded from the variable range output; leave blank to treat all parsed parameters as free variables.
   * - Min Percentage
     - min_percentage
     - scalar
     - 50
     - 
     - Lower bound expressed as a percentage offset from each parameter's nominal value (e.g., 50 means −50 %); used to populate the min-range column of the output dataset. Default is 50.
   * - Max Percentage
     - max_percentage
     - scalar
     - 50
     - 
     - Upper bound expressed as a percentage offset from each parameter's nominal value (e.g., 50 means +50 %); used to populate the max-range column of the output dataset. Default is 50.
   * - Step Percentage
     - step_percentage
     - scalar
     - 20
     - 
     - Increment between discrete levels expressed as a percentage of the nominal value; used to populate the step column of the output dataset. Default is 20.
   * - Format
     - format
     - select
     - no
     - 
     - LS-DYNA field-width format of the source keyword file: 'short' (10-character), 'long' (20-character), or 'auto' for automatic detection; leave at 'no' (default) to let the parser decide automatically.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Parameters
     - parameters
     - dataset
     - Dataset table where each row represents one parsed *PARAMETER entry, containing columns for parameter name, nominal value, min bound, max bound, and step size derived from the configured percentage inputs.

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

- cae.preprocessing.deck_authoring
- cae.preprocessing.scenario
- design_exploration.doe

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