.. _auto_curve_engstress_stats: *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 ------ .. list-table:: :header-rows: 1 :widths: 20 20 20 20 20 20 * - 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 ------- .. list-table:: :header-rows: 1 :widths: 20 20 20 20 * - 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 `_ .. raw:: html

Auto-generated from transformation schema. Worker id: curve_engstress_stats. Schema hash: 1cc9f536da84. Hand-curated docs in workerexamples/ override this page when present.