.. _auto_lsdyna_convert_material_units:

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

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

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

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

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

.. raw:: html

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