MATERIAL SPECIMEN GENERATOR¶
Generates a cylindrical material test specimen deck (LS-DYNA keyword file) for coupon-level compression or tension simulations. Select the cylinder geometry variant, element formulation, and loading definition to produce a ready-to-run input file. Use this worker when you need a parameterised cylindrical specimen for material characterisation or calibration workflows.
When to use¶
Classification: data.
Tagged: LS-DYNA, VAD, compression, coupon, cylinder, deck_authoring, elform, keyword.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Type | type | string | cylinder_h6mmd6mm_1mm | Cylindrical specimen geometry variant to generate; ‘cylinder_h6mmd6mm_1mm’ (1 mm element size) or ‘cylinder_h6mmd6mm_p3mm’ (0.3 mm element size) — defaults to the 1 mm variant when left unchanged. | |
| Elform | elform | scalar | -1 | LS-DYNA element formulation ID applied to all solid elements in the specimen deck (e.g. -1 = fully-integrated, 1 = under-integrated); defaults to -1. | |
| Mass-Scaled Time Step | mass-scaled_time_step | scalar | 0 | Target minimum time step (seconds) for mass scaling via *CONTROL_TIMESTEP; set to 0 (default) to disable mass scaling. | |
| V-A-D | velocity-acceleration-displacement | scalar | 2 | VAD flag that controls how the load curve is interpreted: 0 = displacement, 1 = acceleration, 2 = velocity (default); maps directly to the VAD field in *BOUNDARY_PRESCRIBED_MOTION. | |
| Loading Input | loading_input_type | scalar | constant | Defines whether the applied loading magnitude is a single constant value (‘constant’, default) or a user-supplied time–history curve (‘curve’). | |
| Displacement Or Velocity Or Acceleration Value | displacementor_velocityor_acceleration_value | scalar | 25 | Magnitude of the prescribed displacement (mm), velocity (mm/ms), or acceleration (mm/ms²) applied to the specimen, depending on the VAD setting; active only when Loading Input Type is ‘constant’ (default 25). | |
| Duration | duration | scalar | 100 | CONTROL_TERMINATION | |
| Binary Output Frequency | binary_output_frequency | scalar | 1 | ||
| ASCII Output Frequency | ascii_output_frequency | scalar | 0.1 | ||
| Material Data | material_data | text | — | Material Card | |
| 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 | — | Add additional keywords (Optional) |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| material_specimen_generator_cylinder_output_1 | material_specimen_generator_cylinder_output_1 | text | LS-DYNA keyword (.k) deck for the configured cylindrical specimen, including mesh, boundary conditions, and prescribed loading, ready for solver submission or further material-card insertion. |
Disciplines¶
- cae.preprocessing.deck_authoring
- engineering.material.specimen
Auto-generated from transformation schema. Worker id: material_specimen_generator_cylinder. Schema hash: 41b3940bd9ff. Hand-curated docs in workerexamples/ override this page when present.