MATERIAL SPECIMEN GENERATOR¶
Generates a parameterized LS-DYNA keyword deck for a KSII-type sheet-metal weld/coupon specimen with configurable thicknesses, element formulations, and material IDs. Use this worker to rapidly author specimen input decks for material characterization or coupon-level crash simulations.
When to use¶
Classification: data.
Tagged: coupon, deck_authoring, elform, haz, ksii, ls-dyna, mat_24, material_id.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Type | type | string | ksii_specimen_4mm_mesh | Specimen template to instantiate; currently only ‘ksii_specimen_4mm_mesh’ (KSII coupon with 4 mm shell mesh) is available — leave as default unless new templates are registered. | |
| Sheet Metal-1 Thickness | sheetmetal-1thickness | scalar | 1 | Nominal thickness of sheet-metal blank 1 (mm, scalar); default 1 mm — set to the actual gauge of the first sheet in the welded coupon. | |
| Sheet Metal-2 Thickness | sheetmetal-2thickness | scalar | 1 | Nominal thickness of sheet-metal blank 2 (mm, scalar); default 1 mm — set to the actual gauge of the second sheet when the two blanks differ. | |
| Sheet Metal Elform | sheetmetal_elform | scalar | 16 | LS-DYNA shell element formulation (ELFORM) applied to both sheet-metal parts (integer); default 16 (fully-integrated shell) — change only if a different formulation is required by the simulation protocol. | |
| Sheet-metal 1 MID | sheet-metal1 | scalar | 1 | LS-DYNA material ID (MID) assigned to sheet-metal part 1 (integer); default 1 — must match the MID of the base-metal card already defined in the parent deck. | |
| S1HM | sheet-metal1hazmi_d | scalar | 1 | LS-DYNA material ID (MID) for the Heat-Affected Zone (HAZ) region of sheet-metal 1 (integer); default 1 — set to the HAZ material card ID when a dedicated HAZ material is used. | |
| S2MI | sheet-metal2mi_d | scalar | 1 | LS-DYNA material ID (MID) assigned to sheet-metal part 2 (integer); default 1 — must match the MID of the second blank’s material card in the parent deck. | |
| S2HMI | sheet-metal2hazmi_d | scalar | 1 | Sheet-metal 2 HAZ Material ID | |
| Spotweld Material MID | spotweld_material_mi_d | scalar | 1 | ||
| Loading Direction | loading_direction | scalar | tension | ||
| Loading Displacement | loading_displacement | scalar | 10 | ||
| End Time | end_time | scalar | 10 | CONTROL_TERMINATION | |
| Binary Output Frequency | binary_output_frequency | scalar | 1 | ||
| ASCII Output Frequency | ascii_output_frequency | scalar | 0.1 | ||
| Material Data | material_data | text | *MAT_ELASTICn1,1.0e-9,210.0,0.3n | Material Card | |
| Additional Keywords | additionalkeywords | text | *END | Addition Keywords (Optional) |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| material_specimen_generator_ksii_output_1 | material_specimen_generator_ksii_output_1 | text | LS-DYNA keyword text (plain text) containing the fully parameterized KSII specimen deck — includes shell part definitions, section cards, material ID references, and mesh keywords ready for inclusion in a simulation input file. |
Disciplines¶
- cae.preprocessing.deck_authoring
- engineering.material.specimen
Auto-generated from transformation schema. Worker id: material_specimen_generator_ksii. Schema hash: cc87f35b6769. Hand-curated docs in workerexamples/ override this page when present.