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¶
| 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¶
| 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
Auto-generated from platform schema. Worker id: lsdyna_parameterize_k_file. Schema hash: 7443e7dad8e2. Hand-curated docs in workerexamples/ override this page when present.