.. _auto_material_specimen_generator_cylinder:

*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
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - 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
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - 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

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>transformation</code> schema. Worker id: <code>material_specimen_generator_cylinder</code>. Schema hash: <code>41b3940bd9ff</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>