.. _auto_text_parameterize:

*PARAMETERIZE INPUT*
====================

Injects a named *PARAMETER definition into an LS-DYNA keyword file, replacing a specified field value on a given card with a parameterized reference. Use this worker to templatize keyword decks for design-exploration or DOE workflows where a numeric field must become a sweepable variable.

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

Classification: **process**.

Tagged: ``card``, ``deck``, ``doe``, ``keyword``, ``ls-dyna``, ``parameter``, ``parameterize``, ``templating``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Text
     - text
     - text
     - —
     - 
     - Full text content of an LS-DYNA keyword (.k / .key) file into which the parameter definition will be injected.
   * - Parameter Name
     - parameter_name
     - scalar
     - —
     - 
     - Name for the LS-DYNA parameter (maps to the *PARAMETER card name field, e.g. 'THICK1'); must follow LS-DYNA naming rules (≤8 chars, no spaces).
   * - Parameter Type
     - parameter_type
     - scalar
     - —
     - 
     - Data type of the parameter — 'R' (float/real) or 'I' (integer); controls the prefix written on the *PARAMETER card.
   * - Parameter Value
     - parameter_value
     - scalar
     - —
     - 
     - Numeric default value assigned to the parameter on the *PARAMETER card (e.g. 2.5 for a thickness).
   * - Parameter Width
     - parameter_width
     - scalar
     - —
     - 
     - Field width (column count) to use when writing the parameter reference into the keyword card — typically 10 for standard LS-DYNA fixed-format fields.
   * - Keyword Name
     - keywordname
     - scalar
     - —
     - 
     - LS-DYNA keyword block to target for substitution (e.g. '*MAT_024', '*SECTION_SHELL'); must match the keyword name exactly as it appears in the deck.
   * - Card Number
     - cardnumber
     - scalar
     - —
     - 
     - 1-based index of the data card within the targeted keyword block where the substitution should be made.
   * - Parameter Number
     - parameternumber
     - scalar
     - —
     - 
     - 1-based field (column) position on the specified card that will be replaced by the parameter reference.
   * - Keyword ID
     - keyword_i_d
     - scalar
     - —
     - 
     - ID for the card
   * - Use Parameter Expression
     - expression_type
     - string
     - yes
     - 
     - 

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - text_parameterize_output_1
     - text_parameterize_output_1
     - text
     - Modified LS-DYNA keyword file text with the *PARAMETER definition added at the top and the targeted field value replaced by the parameter reference (e.g. '&THICK1').

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>transformation</code> schema. Worker id: <code>text_parameterize</code>. Schema hash: <code>acb4f91ccf4b</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>