DATASET COMPUTE FAILURE STRAIN ERROR¶
Computes the failure-strain error between a reference (physical test) dataset and a simulation dataset by detecting the failure point in each using either eroded-energy onset or stress-drop criteria. The signed or absolute error between the reference and simulated failure strains is appended as a new column in the output dataset. Use this worker to quantify how accurately a material model predicts the strain at failure.
When to use¶
Classification: process.
Tagged: dataset_transform, eroded_energy, error_metric, failure_strain, material_calibration, sim_vs_test, stress_drop.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Reference Dataset | ref_dataset | dataset | — | ✓ | Tabular dataset containing physical test results (e.g., coupon force-displacement or stress-strain data); must include the reference strain column and, if using eroded-energy detection, the reference eroded-energy column. |
| Sim Dataset | sim_dataset | dataset | — | ✓ | Tabular dataset containing LS-DYNA or equivalent simulation results; must include the simulated strain column and, if using eroded-energy detection, the simulated eroded-energy column. |
| Reference Strain Col | ref_strain_col | scalar | — | ✓ | Name of the column in ref_dataset that holds the reference (test) strain values (dimensionless); selected from the columns available in ref_dataset. |
| Simulation Strain Col | sim_strain_col | scalar | Sim Strain | ✓ | Name of the column in sim_dataset that holds the simulated strain values (dimensionless); defaults to ‘Sim Strain’. |
| Reference Failure Type | ref_failure_type | select | eroded | Method used to detect the failure point in the reference dataset: ‘eroded’ = onset of eroded energy (requires ref_eroded_energy_col), ‘drop’ = first significant stress reduction; defaults to ‘eroded’. | |
| Simulation Failure Type | sim_failure_type | select | eroded | Method used to detect the failure point in the simulation dataset: ‘eroded’ = onset of eroded energy (requires sim_eroded_energy_col), ‘drop’ = first significant stress reduction; defaults to ‘eroded’. | |
| Reference Eroded-Energy Col | ref_eroded_energy_col | scalar | Reference Eroded Energy | ✓ | Name of the column in ref_dataset containing eroded internal energy values; required only when ref_failure_type is ‘eroded’, otherwise leave blank. |
| Simulation Eroded-Energy Col | sim_eroded_energy_col | scalar | Simulation Eroded Energy | ✓ | Name of the column in sim_dataset containing eroded internal energy values; required only when sim_failure_type is ‘eroded’, otherwise leave blank. |
| Reference Strain Type | ref_strain_type | select | engss | ||
| Simulation Strain Type | sim_strain_type | select | engss | ||
| New Error Column Prefix | error_col | scalar | Error | ✓ | Prefix for the error column. The prefix will be used to add the errors |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| Computed Errors | dataset_error | dataset | Dataset containing the computed failure-strain error between the reference and simulation datasets, with the error value stored in the column named by err_col; one row per specimen or load case processed. |
Disciplines¶
- data.correlation
- data.dataset.transform
- engineering.material.calibration
- engineering.material.characterization
- engineering.material.failure
Runnable example¶
A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: /api/workflow/example?id=dataset_compute_failure_strain_error
Auto-generated from transformation schema. Worker id: dataset_compute_failure_strain_error. Schema hash: 57321e6613fc. Hand-curated docs in workerexamples/ override this page when present.