LSDYNA CONVERT MATERIAL CARD UNITS¶
Wraps an LS-DYNA keyword material card in a generated main.k that uses *INCLUDE_TRANSFORM with mass, length, time, and temperature scale factors so LS-DYNA re-scales every dimensioned parameter at solve time. Works for every MAT type because the conversion is done natively by the solver, not by inspecting the card. Select a source and target unit system to pull the scale factors from the d3VIEW unit-system catalog (kg-mm-ms, tonne-mm-s, kg-mm-s, g-mm-ms, and the other consistent systems), or leave the dropdowns empty and enter custom scale factors directly.
When to use¶
Tagged: lsdyna, material_card, unit_conversion, include_transform, keyword, calibration.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Material Card | material_card | file | — | ✓ | LS-DYNA keyword material card (.k or .key) whose unit system you want to convert. The file is preserved unchanged; a wrapper main.k is generated alongside it that pulls it in via *INCLUDE_TRANSFORM. |
| Conversion Method | method | list | include_transform | How the conversion should be applied. include_transform (default) generates a main.k wrapper that uses LS-DYNA’s native *INCLUDE_TRANSFORM mechanism to re-scale parameters at solve time, works for every MAT type. inline_convert rewrites the card’s numeric values in place using a per-MAT manifest (Phase 1: MAT_PIECEWISE_LINEAR_PLASTICITY, MAT_RIGID, MAT_SPOTWELD_DAIMLERCHRYSLER) and re-scales any referenced DEFINE_CURVE / DEFINE_TABLE rows; output is a flat converted card with real numeric values. llm_assisted asks the platform LLM to convert the card and validates the result against the inline_convert reference shape before returning. | |
| Source Unit System | source_unit_system | remote_lookup | — | The unit system the supplied material card is currently written in (e.g. kg-mm-ms, tonne-mm-s). Combined with Target Unit System, populates the four scale factors automatically from the d3VIEW unit-system catalog. Leave empty and supply the scale factors directly if your unit system is not in the catalog. | |
| Target Unit System | target_unit_system | remote_lookup | — | The unit system you want LS-DYNA to interpret the card in when solving. Combined with Source Unit System, populates the four scale factors automatically. | |
| Mass Scale Factor (FCTMAS) | mass_scale_factor | float | 1.0 | Ratio of the included file’s mass unit to the main file’s mass unit (LS-DYNA FCTMAS). Defaults to 1.0; auto-populated from the source/target dropdowns when both are set. Set explicitly to override the auto-derived value. | |
| Length Scale Factor (FCTLEN) | length_scale_factor | float | 1.0 | Ratio of the included file’s length unit to the main file’s length unit (LS-DYNA FCTLEN). Defaults to 1.0; auto-populated from the source/target dropdowns when both are set. | |
| Time Scale Factor (FCTTIM) | time_scale_factor | float | 1.0 | Ratio of the included file’s time unit to the main file’s time unit (LS-DYNA FCTTIM). Defaults to 1.0; auto-populated from the source/target dropdowns when both are set. | |
| Temperature Scale Factor (FCTTEM) | temperature_scale_factor | float | 1.0 | Ratio of the included file’s temperature unit to the main file’s temperature unit (LS-DYNA FCTTEM). Defaults to 1.0. Note: temperature offsets (e.g. degrees C to K) are not yet supported in Phase 1; factor only. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| Generated main.k | main_card_file | file | Path to the generated main.k wrapper that pulls the original material card in via *INCLUDE_TRANSFORM with the resolved scale factors. |
| Bundle Zip | bundle_zip | file | Zip containing both the generated main.k and the original material card, ready to extract into a single directory and run with LS-DYNA. |
| Resolved Scale Factors | scale_factors | json | Object with the four scale factors actually written into the wrapper card (mass, length, time, temperature), regardless of whether they were auto-derived or custom. |
| Summary | summary | text | Human-readable summary of the source/target unit systems and the four scale factors that ended up in the wrapper. |
Disciplines¶
- lsdyna.material_card
- lsdyna.units
Auto-generated from platform schema. Worker id: lsdyna_convert_material_units. Schema hash: 25edf7b64ade. Hand-curated docs in workerexamples/ override this page when present.