.. _auto_dynamodel_get_foam_compression:

*PROVIDES THE LS-DYNA RUNNABLE MODEL FOR FOAM COMPRESSION MODEL WORKER*
=======================================================================

Generates a ready-to-run LS-DYNA foam compression deck by rendering a Smarty template with user-supplied material and solver parameters. Use this worker to produce the keyword input file and companion JSON template for a foam coupon compression test (sphere or plate impactor).

When to use
-----------

Tagged: ``compression``, ``coupon``, ``dt2ms``, ``dynamodel``, ``elform``, ``foam``, ``foam_compression``, ``impactor``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Title
     - title
     - textarea
     - Foam Compression Test
     - 
     - Free-text title written into the LS-DYNA keyword header; defaults to 'Foam Compression Test' and can be left as-is for batch runs.
   * - Material ID
     - material_id
     - textarea
     - 12
     - 
     - Integer material ID (*MAT card MID) assigned to the foam part in the generated deck; defaults to 12 — change only when the ID must match an existing model numbering scheme.
   * - Material data
     - material_data
     - textarea
     - —
     - 
     - Raw LS-DYNA material keyword block (e.g., *MAT_LOW_DENSITY_FOAM card content) to be injected verbatim into the template; must be provided for a valid runnable model.
   * - Displacement Sf
     - disp_sf
     - textarea
     - -20
     - 
     - Scale factor (mm, negative = compression) applied to the impactor prescribed displacement curve; default -20 mm gives ~20 mm of compression travel — adjust for thicker/thinner foam specimens.
   * - ELFORM
     - elform
     - textarea
     - -1
     - 
     - LS-DYNA element formulation (ELFORM) for the foam solid elements; default -1 (mean-stress fully integrated) is recommended for foam to avoid hourglassing.
   * - Termination Time
     - term
     - textarea
     - 0.2
     - 
     - Simulation termination time in seconds; default 0.2 s — reduce for faster quasi-static sweeps or increase if the prescribed displacement is slow.
   * - DT2MS
     - dt2ms
     - textarea
     - -1e-07
     - 
     - Mass-scaling target timestep (DT2MS, seconds, negative = minimum timestep floor); default -1e-7 s — tighten toward 0 to reduce added mass, loosen to shorten wall-clock time.
   * - Impactor Type
     - impactor_type
     - select
     - sphere
     - 
     - Geometry of the compression impactor: 'sphere' (rigid spherical indenter contacting the foam surface) or 'plate' (rigid flat plate / prescribed motion on the top foam surface); select based on test fixture.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Model
     - model
     - textarea
     - 
   * - Foam Model Template
     - foam_model_template
     - textarea
     - JSON template file that describes the parameter schema for the foam compression model, used by downstream workers for parameterised re-runs or DOE studies.

Disciplines
-----------

- cae.preprocessing.deck_authoring
- engineering.crash.dynamics
- engineering.material.calibration
- engineering.material.specimen

.. raw:: html

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