.. _auto_text_get_keyword_parameter:

*GET KEYWORD PARAMETER VALUE*
=============================

Parses a raw LS-DYNA keyword text block and extracts the value of a specific parameter by locating the target keyword, card, and positional field. Use this worker to pull individual scalar field values out of a keyword deck snippet without writing custom parsing logic.

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

Classification: **process**.

Tagged: ``deck``, ``field-extraction``, ``keyword``, ``ls-dyna``, ``parser``, ``scalar``, ``text-parsing``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Text
     - text
     - text
     - —
     - 
     - Raw LS-DYNA keyword deck text (or any keyword-formatted string) to be parsed; supply the full or partial deck content containing the target keyword.
   * - Keyword Name
     - keywordname
     - scalar
     - —
     - 
     - Name of the LS-DYNA keyword to locate within the text (e.g. *MAT_024 or *SECTION_SHELL); must match the keyword header exactly (case-insensitive).
   * - Card Id
     - cardid
     - scalar
     - 1
     - 
     - Identifier of the specific card within the keyword block to read from; defaults to 1 (first card).
   * - Card Number
     - cardnumber
     - scalar
     - 1
     - 
     - Occurrence index (1-based) of the card to select when the keyword contains multiple repeated cards; defaults to 1.
   * - Parameter Width
     - parameterwidth
     - scalar
     - 10
     - 
     - Fixed-field column width (in characters) used to divide each card line into parameter slots; defaults to 10, matching the standard LS-DYNA 10-character field width.
   * - Parameter Number
     - parameternumber
     - scalar
     - 10
     - 
     - 1-based positional index of the parameter field to extract from the selected card line; defaults to 10.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - text_get_keyword_parameter_output_1
     - text_get_keyword_parameter_output_1
     - text
     - Extracted parameter value as a text string taken from the specified keyword, card, and field position within the input deck.

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

- cae.postprocessing.extraction
- cae.preprocessing.deck_authoring
- data.io.file

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