.. _auto_lsdyna_material_curve_validation:

*PERFORMS LS-DYNA MATERIAL CURVES VALIDATION*
=============================================

Validates material curve definitions within an LS-DYNA keyword file, checking for issues such as non-monotonicity and negative slopes, and optionally digitizes or corrects curves. Use this worker to perform quality-control on MAT keyword curves and tables before solver submission.

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

Tagged: ``curve_qc``, ``curve_validation``, ``digitize``, ``keyword``, ``lsdyna``, ``mat_24``, ``material_curves``, ``monotonicity``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - LS-DYNA Input File
     - lsdyna_file
     - file
     - —
     - ✓
     - LS-DYNA keyword (.k / .key) file containing material card definitions and their associated load curves or tables; required unless lsdyna_input_as_text is provided.
   * - LITI
     - lsdyna_input_as_text
     - textarea
     - —
     - 
     - Raw LS-DYNA keyword text pasted directly as a string (alternative to uploading a file); leave blank when lsdyna_file is supplied.
   * - IDIO
     - include_derivatives
     - select
     - no
     - 
     - Controls whether first-derivative curves are included in the output dataset; default is 'no' — set to 'yes' to expose slope data for further analysis.
   * - Curve Options
     - curve_options
     - form-input-table
     - —
     - 
     - Composite options table governing curve post-processing: select the digitization target point count (or auto), whether monotonicity is enforced, and whether negative slopes are removed; leave all at defaults ('no digitize', enforce monotonicity, remove negative slopes) for standard QC.
   * - Table Options
     - table_options
     - form-input-table
     - —
     - 
     - Table options
   * - TOMTV
     - material_types
     - select
     - (PIECEWISE/MAT_024)
     - 
     - Types of materials to validate

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Orig Keyword
     - orig_keyword
     - text
     - Full LS-DYNA keyword text as parsed from the input file, prior to any curve corrections, for diff/audit purposes.
   * - Updated Keyword
     - updated_keyword
     - text
     - Modified LS-DYNA keyword text with validated and optionally corrected/digitized curves applied, ready for downstream solver use.
   * - Logs
     - logs
     - dataset
     - Dataset of per-curve validation log messages, including warnings for detected monotonicity violations, negative slopes, or digitization actions taken.
   * - Compare Data
     - compare_data
     - dataset
     - Dataset containing side-by-side comparison of original versus corrected curve point data, suitable for plotting or correlation review.
   * - Materials
     - materials
     - dataset
     - Dataset listing all material cards extracted from the keyword file, including material ID, name, and type.
   * - Material Types
     - material_types
     - dataset
     - Dataset enumerating the distinct LS-DYNA material type codes (e.g., MAT_024) present in the input keyword file.
   * - Material Curve Ids
     - material_curve_ids
     - dataset
     - Dataset mapping each material card to its referenced load-curve and table IDs, enabling traceability between material parameters and curve definitions.

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

- cae.preprocessing.deck_authoring
- data.curve.transform
- engineering.material.calibration
- engineering.material.characterization

.. 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_material_curve_validation</code>. Schema hash: <code>eb783f0feed0</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>