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¶
| 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¶
| 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
Auto-generated from platform schema. Worker id: query_material_database. Schema hash: b83c05741c94. Hand-curated docs in workerexamples/ override this page when present.