MATERIAL SPECIMEN GENERATOR¶
Generates LS-DYNA shear specimen decks for material coupon simulations. Select from a library of shear specimen geometries (0-degree orientations, Waterloo variants, mesh sizes from 0.1 mm to 4 mm) and configure shell element properties before submitting a calibration or characterization job.
When to use¶
Classification: data.
Tagged: coupon, deck_generation, dt2ms, elform, ls-dyna, mass_scaling, material_testing, nip.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Specimen Type | type | string | E8_shell_regular_3mm | Shear specimen geometry variant to generate; choose from 0-degree shear geometries at various mesh sizes (0.1 mm, 0.5 mm, 1 mm, 2 mm, 4 mm) and Waterloo-variant options — defaults to ‘E8_shell_regular_3mm’ if left unchanged, but should be set to the desired shear geometry ID. | |
| Specimen Thickness | thickness | scalar | 1 | Shell element through-thickness value (mm); set to match the physical coupon thickness being simulated — defaults to 1 mm. | |
| Element Formulation Type | elform | scalar | 16 | LS-DYNA shell element formulation type (ELFORM keyword integer, e.g. 16 = fully-integrated shell); defaults to 16 and should match the solver element technology used in the parent model. | |
| NIP | ni_p | scalar | 3 | Number of through-thickness integration points (NIP) for the shell section; defaults to 3 — increase for higher bending accuracy or when using thick-shell formulations. | |
| DT2MS | mass-scaled_time_step | scalar | 0 | Mass-scaling target time step (DT2MS, seconds); set to a negative value to enable mass scaling and accelerate explicit runs — defaults to 0 (mass scaling disabled). | |
| Membrane Thinning | membrane_thinning | scalar | 0 | Controls the *CONTROL_SHELL MEMBRANE THINNING flag; governs whether membrane thinning effects are active in the shell formulation — defaults to 0 (disabled). | |
| Velocity - Acceleration - Displacement | velocity-acceleration-displacement | scalar | 2 | VAD Load Curve Type | |
| Loading Input | loading_input_type | scalar | constant | Load Curve is constant or varying based on Curve | |
| Displacement Or Velocity Or Acceleration Value | displacementor_velocityor_acceleration_value | scalar | 25 | Displacement Final value | |
| Duration | duration | scalar | 100 | CONTROL_TERMINATION | |
| Binary Output Frequency | binary_output_frequency | scalar | 1 | ||
| ASCII Output Frequency | ascii_output_frequency | scalar | 0.1 | ||
| Material ID | material_i_d | scalar | — | ||
| Material Data | material_data | text | — | Material Card | |
| IRATE | irat_e | scalar | 0 | ||
| IMFLAG | imfla_g | scalar | 0 | ||
| IMASS | imas_s | scalar | 0 | ||
| DT0 | d_t0 | scalar | 0.1 | ||
| ILIMIT | ilimi_t | scalar | 10 | ||
| MAXREF | maxre_f | scalar | 15 | ||
| IACC | iac_c | list | 0 | ||
| Grip Size 0-Default | grip_size0-default | scalar | 92.5 | Grip to grip distance | |
| Additional Keywords | additionalkeywords | text | — | Add additional keywords (Optional) | |
| Gage Width | gagewidth | scalar | 1.614 | ||
| Gage Length | gagelength | scalar | 4.76 | ||
| Lcint | lcint | scalar | 0 |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| material_specimen_generator_shear_output_1 | material_specimen_generator_shear_output_1 | text | Generated LS-DYNA keyword deck (text/string) for the selected shear specimen configuration, ready for direct inclusion in a material calibration or coupon simulation workflow. |
Disciplines¶
- cae.preprocessing.deck_authoring
- engineering.material.calibration
- engineering.material.specimen
Auto-generated from transformation schema. Worker id: material_specimen_generator_shear. Schema hash: ec0aa86e94ec. Hand-curated docs in workerexamples/ override this page when present.