.. _auto_lsdyna_parameterize_k_file:

*LS-DYNA PARAMETERIZE K FILE*
=============================

Automatically parameterizes an LS-DYNA keyword (.k) file by injecting *PARAMETER cards for selected keywords and replacing hardcoded numeric values with named parameter references. Use this worker to prepare a baseline deck for design exploration, DOE, or optimization studies where material, section, or initial-velocity properties need to vary.

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

Tagged: ``INITIAL_VELOCITY``, ``MAT``, ``SECTION_SHELL``, ``deck-authoring``, ``design-exploration``, ``doe-prep``, ``k-file``, ``keyword``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - LS-DYNA Keyword File
     - file
     - file
     - —
     - ✓
     - The LS-DYNA keyword (.k / .key) file to be parameterized; must be a valid text-format deck containing the keywords targeted for substitution.
   * - Keywords to Parameterize
     - target_keywords
     - text
     - SECTION_SHELL,MAT
     - 
     - Comma-separated list of LS-DYNA keyword block types whose fields should be parameterized (e.g., 'SECTION_SHELL,MAT,INITIAL_VELOCITY'); defaults to 'SECTION_SHELL,MAT' when left unchanged.
   * - Properties to Parameterize
     - target_properties
     - text
     - —
     - 
     - Comma-separated field names within the targeted keyword blocks to replace with parameter references (e.g., 'T1,SIGY,E,PR'); leave empty to let the worker auto-detect parameterizable numeric fields.
   * - Part IDs (filter)
     - part_ids
     - text
     - —
     - 
     - Comma-separated part IDs used to restrict parameterization to specific parts; leave empty to apply parameterization across all parts in the deck.
   * - Parameter Naming Convention
     - naming_convention
     - select
     - keyword_id
     - 
     - Controls how generated *PARAMETER names are formed: 'keyword_id' produces names like S1_T1 or M3_SIGY (keyword prefix + ID), while 'short' produces names like T1_1 or SIGY_3 (property + ID).
   * - Min Range %
     - min_percentage
     - scalar
     - 50
     - 
     - Lower bound of each parameter's variation range expressed as a percentage offset from the nominal value (e.g., 50 means the minimum is set to 50 % below nominal); default is 50.
   * - Max Range %
     - max_percentage
     - scalar
     - 50
     - 
     - Upper bound of each parameter's variation range expressed as a percentage offset above the nominal value (e.g., 50 means the maximum is set to 50 % above nominal); default is 50.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Parameterized File
     - parameterized_file
     - file
     - Modified LS-DYNA keyword file with *PARAMETER cards inserted at the top and all targeted hardcoded field values replaced by their corresponding parameter references.
   * - Parameters
     - parameters
     - dataset
     - Dataset (tabular) listing every generated parameter — name, nominal value, min bound, and max bound — ready for downstream DOE or optimization workers.
   * - Status
     - status
     - string
     - String status message reporting success or describing any warnings/errors encountered during parameterization (e.g., unrecognized keywords or fields).

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

- cae.preprocessing.deck_authoring
- 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_parameterize_k_file</code>. Schema hash: <code>7443e7dad8e2</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>