.. _auto_query_material_database:

*QUERY MATERIAL DATABASE*
=========================

Queries the LS-DYNA material reference database for material family identification, valid parameter ranges, grade-specific properties, material model parameter classifications, card validation, and property-based material search. Used by the Material Calibration Agent to ground recommendations in physical data backed by the d3VIEW Material Grades and MAT Model Parameters databases.

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

Tagged: ``calibration_agent``, ``card_validation``, ``grade_properties``, ``ls-dyna``, ``mat_036``, ``mat_24``, ``material_database``, ``material_identification``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Query Type
     - query_type
     - select
     - —
     - ✓
     - Selects the database operation to perform; must be one of: identify_material (family detection from card values), get_property_ranges (valid min/max for a family), get_grade_properties (data for a specific grade), get_model_parameters (parameter classifications for an LS-DYNA MAT keyword), validate_card (check card values against known ranges), or search_by_property (find grades by a target property value).
   * - Material Family
     - material_family
     - text
     - —
     - 
     - Name of the material family to query (e.g., 'steel', 'aluminum', 'titanium'); required when query_type is get_property_ranges, optional context for other query types.
   * - Material Grade
     - material_grade
     - text
     - —
     - 
     - Specific material grade designator (e.g., 'DP980', '6061-T6'); required when query_type is get_grade_properties.
   * - Material Model
     - material_model
     - text
     - —
     - 
     - LS-DYNA material model keyword (e.g., 'MAT_024', 'MAT_036'); required when query_type is get_model_parameters.
   * - Card Values (JSON)
     - card_values
     - textarea
     - —
     - 
     - JSON object of LS-DYNA material card parameter key-value pairs (e.g., {"E": 210000, "RO": 7.85e-9, "PR": 0.3, "SIGY": 600}); required when query_type is identify_material or validate_card.
   * - Property Name
     - property_name
     - text
     - —
     - 
     - Name of the material property to search on (e.g., 'yield_stress', 'sigy', 'uts', 'elongation', 'failure_strain'); required when query_type is search_by_property.
   * - Property Value
     - property_value
     - text
     - —
     - 
     - Target numeric value for the property search (e.g., '600' for yield stress in MPa); required when query_type is search_by_property.
   * - Tolerance %
     - property_tolerance
     - text
     - 10
     - 
     - Percentage tolerance band around the target property_value when performing search_by_property (default: 10, meaning ±10%); leave at default for most searches.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Query Result
     - result
     - textarea
     - Structured JSON string whose schema varies by query_type: family identification with confidence and candidate grades, property range tables, grade-specific parameter sets, MAT model parameter classifications, card validation diagnostics, or ranked property-search hits.
   * - Status
     - status
     - text
     - Execution status string; returns 'OK' on success or a human-readable error message describing the failure (e.g., missing required input, unknown query_type).
   * - Records
     - records
     - dataset
     - Raw tabular dataset of matching records retrieved directly from the Material Grades or MAT Model Parameters d3VIEW Datarecord databases, before any post-processing; empty when no records match or on error.

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

- ai_ml.agents
- ai_ml.domain_reasoning
- engineering.material.calibration
- engineering.material.characterization
- engineering.material.library

.. raw:: html

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