.. _auto_curves_get_offset_by_slip:

*GET OFFSET DUE TO SLIP*
========================

Detects the x-axis slip offset (or dominant slope) in one or more curves by fitting piecewise linear segments to the digitized data and identifying the region that best matches a target modulus. Use this worker to correct for toe/slip artefacts in material test curves before further processing.

When to use
-----------

Classification: **process**.

Tagged: ``curve-fit``, ``digitize``, ``modulus``, ``offset``, ``piecewise-linear``, ``r2``, ``segment``, ``slip``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Choose Curves
     - curvestogettheslip-offset
     - vector
     - —
     - 
     - One or more input curves whose x-values contain a slip/toe artefact; each curve should carry physical (e.g. strain vs. stress) data. Leave empty to run with no curves (worker will return null results).
   * - Num Dig
     - num_dig
     - integer
     - 1000
     - 
     - Number of evenly-spaced points used to re-digitize each curve before segment fitting; default 1000. Increase for high-resolution curves, decrease to speed up processing.
   * - Segment Length Ratio
     - segment_length_ratio
     - integer
     - 0.1
     - 
     - Fraction of the total digitized points used as the sliding window length for each linear-segment fit (e.g. 0.1 = 10%); default 0.1. Smaller values detect shorter linear regions; larger values enforce longer, more stable fits.
   * - Min R2
     - r2_limit
     - integer
     - 0.95
     - 
     - Minimum R² coefficient of determination a segment must achieve to be considered a valid linear fit; default 0.95. Lower this threshold to accept noisier segments.
   * - Merge Ratio
     - merge_ratio
     - integer
     - 0.025
     - 
     - Two adjacent segments whose slopes differ by less than this ratio (e.g. 0.025 = 2.5%) are merged into one; default 0.025. Increase to merge more segments, decrease for finer slope discrimination.
   * - Return Type
     - return_type
     - scalar
     - offset
     - 
     - Selects what the worker returns: 'offset' returns the computed x-axis slip offset value; 'slope' returns the dominant segment slope. Defaults to 'offset'.
   * - Target Slope
     - target_slope
     - float
     - 210
     - 
     - Target modulus (slope) value used to identify the relevant linear segment; default 210 (GPa-scale). The worker selects the segment whose slope is closest to this value within the tolerance set by target_per.
   * - Target Percentage
     - target_percentage
     - float
     - 0.05
     - 
     - Slope within this tolerance will be considered

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - curves_get_offset_by_slip_output_1
     - curves_get_offset_by_slip_output_1
     - keyvalue
     - Key-value map where each key is a curve identifier and the corresponding value is either the computed x-axis slip offset or the dominant segment slope, depending on the selected return_type.

Disciplines
-----------

- data.curve.transform
- engineering.material.characterization

Runnable example
----------------

A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: `/api/workflow/example?id=curves_get_offset_by_slip <https://www.d3view.com/api/workflow/example?id=curves_get_offset_by_slip>`_

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>transformation</code> schema. Worker id: <code>curves_get_offset_by_slip</code>. Schema hash: <code>83faf070f767</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>