MATERIAL SPECIMEN GENERATOR FOR SINGLE SOLID¶
Generates a single solid element (SSE) uniaxial specimen LS-DYNA deck for material characterization. Configures element formulation, mass scaling, and loading type (constant or curve-driven displacement/velocity/acceleration) to produce a ready-to-run keyword file. Use this worker to create the simulation input for single-element material validation tests.
When to use¶
Classification: data.
Tagged: LS-DYNA, SSE, VAD, elform, keyword, load_curve, mass_scaling, material_testing.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Type | type | string | uniaxial | Specimen type to generate; currently only ‘uniaxial’ is supported — leave at default unless additional specimen types are introduced. | |
| Elform | elform | scalar | -1 | LS-DYNA solid element formulation (ELFORM keyword); default -1 selects the fully-integrated selective-reduced (S/R) solid — change only if a specific element formulation is required by the material model. | |
| Mass-Scaled Time Step | mass-scaled_time_step | scalar | 0 | Target time-step size (seconds) for LS-DYNA mass scaling (*CONTROL_TIMESTEP DT2MS); set to 0 (default) to disable mass scaling. | |
| V-A-D | velocity-acceleration-displacement | scalar | 2 | VAD flag controlling whether the prescribed boundary motion is interpreted as velocity (0), acceleration (1), or displacement (2); default 2 (displacement) is typical for quasi-static coupon tests. | |
| Loading Input | loading_input_type | scalar | constant | Determines how the loading magnitude is specified: ‘constant’ applies a fixed scalar value, ‘curve’ reads a time–value load curve — choose ‘curve’ for strain-rate-dependent or multi-stage loading. | |
| Displacement Or Velocity Or Acceleration Value | displacementor_velocityor_acceleration_value | scalar | 25 | Scalar magnitude of the applied displacement (mm), velocity (mm/s), or acceleration (mm/s²) when ‘loading_input_type’ is ‘constant’; active only for constant loading and ignored when a curve is supplied. | |
| Element Length | element_length | scalar | 10.0 | Element Length | |
| 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 | 1 | ||
| Material Data | material_data | text | *MAT_ELASTIC 1,7.89e-9,210.0,0.3 | 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 | ||
| Additional Keywords | additionalkeywords | text | *END | Add additional keywords |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| material_specimen_generator_single_solid_element_output_1 | material_specimen_generator_single_solid_element_output_1 | text | LS-DYNA keyword (.k) deck text for the configured single solid element specimen, ready for submission to the solver or further preprocessing. |
Disciplines¶
- cae.preprocessing.deck_authoring
- engineering.material.characterization
- engineering.material.specimen
Auto-generated from transformation schema. Worker id: material_specimen_generator_single_solid_element. Schema hash: 642611dc4ccf. Hand-curated docs in workerexamples/ override this page when present.