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.