ADD LS-DYNA MATERIAL TO EXISTING DATABASE¶
Parses an LS-DYNA keyword input file and ingests its material definitions (including optional MAT_ADD_EROSION cards) into an existing d3VIEW material database. Use this worker to bulk-add or replace material records in a library from a raw LS-DYNA deck, with optional Excel metadata enrichment and a dry-run preview mode.
When to use¶
Tagged: add, database, ingest, keyword, library, lsdyna, mat_add_erosion, material.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Choose Database | database_id | remote_lookup | — | ✓ | Target material database to receive the imported records; select from the remote lookup of available d3VIEW datarecord databases (required). |
| LS-DYNA Input File | lsdyna_file | file | — | ✓ | LS-DYNA keyword (.k / .key / .dyn) input file containing the material cards (MAT_) to be parsed and ingested. |
| Add Or Replace | add_or_replace | select | add | ✓ | Controls conflict resolution: ‘add’ appends new records without touching existing ones; ‘replace’ overwrites any existing record whose material ID already exists in the database. Defaults to ‘add’. |
| Preview Data | preview | select | no | ✓ | When set to ‘yes’, performs a dry-run parse and returns the records that would be written without committing them to the database; default ‘no’ commits immediately. |
| Include MAT ADD EROSION Information | include_mat_add_erosion | select | no | Set to ‘yes’ to also parse and store *MAT_ADD_EROSION cards associated with each material; defaults to ‘no’ (erosion data ignored). | |
| Meta-data Excel File | meta_file | file | — | Optional Excel (.xlsx) metadata file; rows matched on the <Material ID> column enrich the imported records with additional metadata fields not present in the keyword file. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| Database Id | database_id | integer | Integer identifier of the target d3VIEW database that was written to, useful for chaining downstream workers. |
| Records | records | dataset | Dataset of all material records that were added or replaced during the import, one row per material card. |
| Num Records | num_records | integer | Total count of material records successfully written (or previewed) in this run. |
Disciplines¶
- data.dataset.ingest
- data.io.excel
- data.io.file
- engineering.material.library
Auto-generated from platform schema. Worker id: lsdyna_add_material_to_existing_database. Schema hash: 7b9ff7242376. Hand-curated docs in workerexamples/ override this page when present.