PARAMETERIZE AND INPUT FOR SIMULATION¶
Parameterizes a named keyword/card field inside a simulation input deck by locating the target card and substituting the specified value. Use this worker to programmatically inject or update a single parameter in an LS-DYNA (or similar) input file without manual deck editing.
When to use¶
Tagged: card, deck_edit, files, input_deck, keyword, ls-dyna, parameterize, simulation.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Simulation | simulation_id | remote_lookup | — | ✓ | Remote reference to the target simulation whose input file will be parameterized; must be selected first as other inputs depend on it. |
| Input File | input_file_id | remote_lookup | — | ✓ | Remote reference to the specific input deck file (e.g., a .k or .key LS-DYNA file) attached to the selected simulation that will be modified. |
| Parameter Name | parameter_name | scalar | — | Human-readable label or token name for the parameter being substituted (e.g., ‘THICKNESS’ or ‘YOUNG_MODULUS’); used for identification and logging. | |
| Parameter Type | parameter_type | scalar | — | Data type of the parameter value (e.g., ‘float’, ‘int’, ‘string’); controls how the substituted value is formatted in the card field. | |
| Parameter Value | parameter_value | scalar | — | The new scalar value to write into the target card field; should match the units and type expected by the solver. | |
| Parameter Width | parameter_width | scalar | — | Field width (number of characters) to use when writing the value into the fixed-format card; leave default if the deck uses standard 10-character LS-DYNA column widths. | |
| Keyword Name | keyword_name | scalar | — | Name of the LS-DYNA keyword block to target (e.g., ‘*MAT_PIECEWISE_LINEAR_PLASTICITY’); identifies which section of the deck contains the card to edit. | |
| Card Name | card_num | scalar | — | Card number (1-based row index) within the keyword block where the parameter resides; corresponds to the card label in the keyword manual. | |
| Parameter Name | param_num | scalar | — | Column/field position (1-based) on the target card that holds the parameter to be replaced. | |
| Card ID | card_id | scalar | — | Unique identifier (e.g., part/section/material ID) used to locate the specific keyword instance within the deck when multiple entries of the same keyword exist. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| Simulation Id | simulation_id | scalar | Pass-through identifier of the simulation whose input file was modified; can be wired directly into downstream solver or job-submission workers. |
| Input File Id | input_file_id | scalar | Identifier of the updated input deck file stored on the platform after the parameter substitution has been applied. |
| Old Cards | old_cards | textarea | Full text of the affected card block as it appeared before the substitution; useful for diffing, auditing, or rollback. |
| New Cards | new_cards | textarea | Full text of the affected card block after the parameter substitution has been applied; confirms the exact lines written to the deck. |
Disciplines¶
- cae.preprocessing.deck_authoring
- cae.preprocessing.setup
- platform.workflow
Auto-generated from platform schema. Worker id: simulation_parameterize_input. Schema hash: 30a8916dae09. Hand-curated docs in workerexamples/ override this page when present.