.. _auto_dynakeyword_mat187_light:

*CREATE A MAT_SAMP_LIGHT*
=========================

Generates an LS-DYNA MAT_187 (MAT_SAMP-1 Light) keyword block from user-supplied material parameters. Use this worker to author a strain-rate-sensitive, semi-analytical material card for metals or polymers within a deck-authoring workflow.

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

Classification: **data**.

Tagged: ``MAT_SAMP_LIGHT``, ``deck_authoring``, ``keyword``, ``ls-dyna``, ``mat_187``, ``mat_samp``, ``material_card``, ``strain_rate``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Material Name
     - material_name
     - scalar
     - MAT_187
     - 
     - Alphanumeric label written into the *MAT_187 keyword header (e.g. 'MAT_187'); default 'MAT_187' is suitable for most cases.
   * - Material ID
     - material_i_d
     - scalar
     - 1
     - 
     - Integer LS-DYNA material ID (MID) referenced by *PART cards; default is 1 — change when multiple materials coexist in the same deck.
   * - Curve Id
     - curve_id
     - scalar
     - 1
     - 
     - Integer ID of the *DEFINE_CURVE (LCID) holding the uniaxial stress–strain data; default is 1 — must match the curve ID already defined in the deck.
   * - Table Id
     - table_id
     - scalar
     - —
     - 
     - Integer ID of the *DEFINE_TABLE used for strain-rate-dependent stress–strain curves (TID); leave null when no rate dependence via table is required.
   * - Strain Rates
     - strain_rates
     - scalar
     - —
     - 
     - Comma-separated list of strain-rate values (s⁻¹) corresponding to each curve in the rate-dependent table; leave blank when a single quasi-static curve is sufficient.
   * - Density
     - density
     - scalar
     - 7.89e-06
     - 
     - Mass density of the material (RO) in consistent LS-DYNA units — default 7.89e-06 kg/mm³ suits steel; override for other materials.
   * - Elastic Modulus
     - elastic_modulus
     - scalar
     - 210
     - 
     - Young's modulus (E) in GPa (or the consistent unit of the deck) — default 210 GPa suits steel; override for aluminium, polymers, etc.
   * - Elastic Poissons Ratio
     - elastic_poissons_ratio
     - scalar
     - 0.3
     - 
     - Elastic Poisson's ratio (PR, dimensionless) controlling transverse strain coupling — default 0.3 is appropriate for most metals; adjust for rubbers or composites.
   * - LCEMOD
     - lcemo_d
     - vector
     - —
     - 
     - LCDMOD Curve   <a class='btn btn-xs btn-default' target='_blank' href='https://www.d3view.com/docs/master/workflows/Glossary.html#curveinput'> <i class='fa fa-external-link'> </i> View more </a>
   * - Beta
     - beta
     - scalar
     - 0
     - 
     - 
   * - Tensile Hardening Curve
     - tensile_hardening_curve
     - vector
     - —
     - 
     - Tensile Hardening Curve   <a class='btn btn-xs btn-default' target='_blank' href='https://www.d3view.com/docs/master/workflows/Glossary.html#curveinput'> <i class='fa fa-external-link'> </i> View more </a>
   * - Compression Hardening Curve
     - compression_hardening_curve
     - vector
     - —
     - 
     - Compression Hardening Curve   <a class='btn btn-xs btn-default' target='_blank' href='https://www.d3view.com/docs/master/workflows/Glossary.html#curveinput'> <i class='fa fa-external-link'> </i> View more </a>
   * - CTFLG
     - ctfl_g
     - scalar
     - 1
     - 
     - 
   * - RATEOP
     - rateo_p
     - scalar
     - 2
     - 
     - 
   * - NUEP
     - nue_p
     - scalar
     - —
     - 
     - 
   * - Plastic Poissons Ratio
     - lcid_p
     - vector
     - —
     - 
     - LCID-P   <a class='btn btn-xs btn-default' target='_blank' href='https://www.d3view.com/docs/master/workflows/Glossary.html#curveinput'> <i class='fa fa-external-link'> </i> View more </a>
   * - RFILTF
     - rfilt_f
     - scalar
     - —
     - 
     - 
   * - Use Log Scale for Tension Table
     - t_log
     - scalar
     - no
     - 
     - When DEFINE_TABLE is used, this option allows to define the strain-rates in log scale
   * - Use Log scale for Compression Table
     - c_log
     - scalar
     - no
     - 
     - When DEFINE_TABLE is used, this option allows to define the strain-rates in log scale
   * - LCID INT for Tension and Compression
     - lcint_tc
     - scalar
     - 201
     - 
     - 
   * - LCINT for LCEMOD
     - lcemod_lcint
     - scalar
     - 201
     - 
     - 
   * - LCINT for LCID_P
     - lcpr_lcint
     - scalar
     - 201
     - 
     - 
   * - Table Curve Association
     - table_curve
     - scalar
     - no
     - 
     - Type of output for strain-rate curves

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - dynakeyword_mat187_light_1
     - dynakeyword_mat187_light_1
     - text
     - Plain-text LS-DYNA keyword block containing the fully populated *MAT_SAMP-1 (MAT_187) card, ready to be concatenated into a simulation deck.

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

- cae.preprocessing.deck_authoring
- engineering.material.calibration
- engineering.material.library

.. raw:: html

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