COMPUTES KEY VALUES SUCH AS YIELD, NECKING ETC.¶
Analyzes an engineering stress-strain curve to extract key material characterization statistics including Young’s modulus, yield stress (via offset method), ultimate tensile strength, and necking point. Use this worker to automatically derive standard coupon-level material KPIs from a raw engineering stress-strain dataset.
When to use¶
Classification: process.
Tagged: UTS, coupon, engstress, failure_removal, material_stats, necking, offset_method, slip_detection.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Eng Stress Strain Curve | eng_stress_strain_curve | vector | — | Engineering stress-strain curve (stress in MPa or psi vs. dimensionless strain) to be analyzed; this is the primary input and must be a paired x-y vector. | |
| Youngs Modulus | slope | scalar | 0 | Young’s modulus (elastic slope) in stress units consistent with the curve; leave at default 0 to let the worker automatically detect the best-fit initial slope from the data. | |
| Yield Offset | yield_offset | scalar | 0.002 | Strain offset used for the 0.2 % (or custom) offset method to determine yield stress; default is 0.002 (0.2 % offset), change only if a non-standard offset is required. | |
| True Necking Intersection Type | true_intersection_type | list | last | Strategy for locating the necking point as the intersection of the true-stress curve and its derivative — ‘last’ (default, most robust for metals), ‘first’, ‘avg’, or ‘auto’ (algorithm-selected). | |
| Treat Slip | treat_slip | list | no | Whether to detect and correct for grip-slip artefacts in the initial portion of the curve before computing statistics; set to ‘yes’ if the curve shows an anomalous toe region. | |
| Remove Failure | remove_failure | list | no | Whether to truncate the curve at the failure/fracture drop-off before computing statistics; set to ‘yes’ when the trailing fracture region would otherwise bias UTS or necking calculations. | |
| Yield Detection Type | yield_type | list | offset | Yield determination type | |
| Type Of Fit To Compute Slope | slope_fit | list | offset | When slope = 0, this option is used to compute the slope | |
| Peak Window Fraction | peak_window_fraction | scalar | 0.1 | Fraction below the ultimate stress that defines the near-peak window for the Duration of Localization output. 0.10 means within 10% of the ultimate stress: the strain range over which sigma is greater than or equal to (1 - fraction) * sigma_ultimate is reported as duration_of_localization in the keyvalue output. Also adds energy_yield_to_ultimate and energy_ultimate_to_failure (areas under the engineering curve in those strain spans). Default 0.10. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curve_engstress_stats_output_1 | curve_engstress_stats_output_1 | keyvalue | Key-value collection of computed material statistics (e.g., Young’s modulus, yield stress, UTS, necking strain/stress) returned as a list of name–value pairs for downstream reporting or model calibration. |
Disciplines¶
- data.curve.transform
- data.statistics
- engineering.material.characterization
- engineering.material.specimen
Runnable example¶
A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: /api/workflow/example?id=curve_engstress_stats
Auto-generated from transformation schema. Worker id: curve_engstress_stats. Schema hash: 1cc9f536da84. Hand-curated docs in workerexamples/ override this page when present.