CREATE A MAT_187 OUT STRAIN RATES KEYWORD FOR LS-DYNA¶
Generates a complete LS-DYNA MAT_187 (Samp-1) keyword block that incorporates strain-rate-dependent stress-strain curves. Accepts material constants, a strain-rate table or single curve reference, and elastic properties, then emits the formatted keyword text ready for deck inclusion.
When to use¶
Classification: data.
Tagged: deck_authoring, keyword, ls-dyna, mat_187, material_card, plasticity, samp-1, strain_rate.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Material Name | material_name | scalar | MAT_187 | Alphanumeric label written into the MAT_187 keyword header; defaults to ‘MAT_187’ and can be left as-is for unnamed materials. | |
| Material ID | material_i_d | scalar | 1 | Integer material ID referenced by *PART cards in the LS-DYNA deck; defaults to 1 — change when multiple materials coexist in the deck. | |
| Curve Id | curve_id | scalar | 1 | LS-DYNA load-curve ID (LCID) for the single quasi-static stress-strain curve used when no strain-rate table is provided; defaults to 1. | |
| Table Id | table_id | scalar | — | LS-DYNA table ID (TBID) referencing a *DEFINE_TABLE of strain-rate-indexed curves; supply this instead of curve_id when strain-rate dependence is required — leave null to use a single curve. | |
| Strain Rates | strain_rates | scalar | — | Comma- or space-separated list of strain-rate values (s⁻¹) that correspond to the curves in the referenced table; leave blank when using a single quasi-static curve. | |
| Density | density | scalar | 7.89e-06 | Mass density of the material in consistent LS-DYNA units (default 7.89e-06 kg/mm³ for steel); adjust for the unit system used in the deck. | |
| Bulk Modulus | bulk | scalar | 0 | Bulk modulus (stress units consistent with the deck, e.g. GPa or MPa); set to 0 to let LS-DYNA derive it from the elastic modulus and Poisson’s ratio. | |
| Shear Modulus | shear_modulus | scalar | 0 | Shear modulus (stress units consistent with the deck); set to 0 to let LS-DYNA derive it from the elastic modulus and Poisson’s ratio. | |
| Elastic Modulus | elastic_modulus | scalar | 210 | Young’s modulus of the material (default 210 GPa for steel in GPa-consistent units); required for the elastic response portion of MAT_187. | |
| Elastic Poissons Ratio | elastic_poissons_ratio | scalar | 0.3 | ||
| RBCFAC | rbcfa_c | scalar | 0 | ||
| NUMINT | numin_t | 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> | |
| Shear Hardening Curve | shear_hardening_curve | vector | — | Shear 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> | |
| Bi-axial Hardening Curve | bi-axial_hardening_curve | vector | — | Bi-axial 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> | |
| Plastic Poissons Ratio | plastic_poissons_ratio | scalar | 0.3 | ||
| Poissons Ratio Vs Strain Rate | poissons_ratiovs_strainrate | vector | — | Poissons Ratio vs Strain rate <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> | |
| INCDAM | incda_m | scalar | — | ||
| Damage Curve | lcid_d | vector | — | Damage 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> | |
| Failure Strain | failure_strain | scalar | — | ||
| DEPRPT | deprp_t | vector | — | DEPRPT <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> | |
| LCID TRI | lci_d_tr_i | vector | — | LCID_TRI <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> | |
| LCID LC | lci_d_l_c | vector | — | LCID_LC <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> | |
| MITER | mite_r | scalar | — | ||
| MPIDS | mpid_s | scalar | — | ||
| INCFAIL | incfai_l | scalar | — | ||
| ICONV | icon_v | scalar | — | ||
| ASAF | asa_f | scalar | — | ||
| LCEMOD | lcemo_d | vector | — | LCEMOD <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 | bet_a | scalar | 0 | ||
| FILT | fil_t | scalar | 0 | ||
| Use Log Scale for Tension | use_log_scale_for_tension | string | no | Use LOG scale for tension | |
| Use Log Scale for compression | use_log_scale_for_compression | string | no | Use log scale for compression |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| dynakeyword_mat187_with_strain_rates_output_1 | dynakeyword_mat187_with_strain_rates_output_1 | text | Plain-text LS-DYNA keyword block containing the fully populated *MAT_187 card (and, if applicable, *DEFINE_TABLE entries), ready to be inserted or appended into a simulation deck. |
Disciplines¶
- cae.preprocessing.deck_authoring
- engineering.material.calibration
- engineering.material.library
Auto-generated from transformation schema. Worker id: dynakeyword_mat187_with_strain_rates. Schema hash: d3bc2133a4fd. Hand-curated docs in workerexamples/ override this page when present.