.. _auto_curve_offset_by_slip:

*TRANSLATE THE CURVE TO REMOVE SLIP*
====================================

Translates a curve along the x-axis to remove initial slip by detecting the dominant linear region (e.g., elastic slope) and offsetting the curve so that region starts at the origin. Use this worker to correct test data where fixture compliance or grip slip introduces a spurious toe region before the true response begins.

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

Classification: **process**.

Tagged: ``curve``, ``digitization``, ``elastic-slope``, ``linear-region``, ``material-test``, ``offset``, ``slip``, ``toe-correction``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve To Be Offset
     - curvetobeoffset
     - vector
     - —
     - 
     - The input curve (e.g., force-displacement or stress-strain) that contains a slip/toe region to be removed; supplied as an x-y vector pair.
   * - Num Dig
     - num_dig
     - integer
     - 1000
     - 
     - Number of points used to re-digitize the curve before slope analysis; default is 1000 — increase for higher-resolution curves, decrease for speed.
   * - Segment Length Ratio
     - segment_length_ratio
     - integer
     - 0.1
     - 
     - Fraction of the total digitized points used as the sliding window length when fitting local linear segments; default is 0.1 (10 %) — smaller values detect shorter linear regions.
   * - Min R2
     - r2_limit
     - integer
     - 0.95
     - 
     - Minimum R² coefficient of determination required for a segment to be accepted as linear; default is 0.95 — lower values allow noisier fits.
   * - Merge Ratio
     - merge_ratio
     - integer
     - 0.025
     - 
     - Two adjacent segments whose slopes differ by less than this fractional ratio are merged into one; default is 0.025 (2.5 %) — reduce to keep more distinct segments.
   * - Target Slope
     - target_slope
     - integer
     - 210
     - 
     - Expected slope value of the target linear region (e.g., Young's modulus in GPa or stiffness in kN/mm); segments closest to this value are selected for the offset calculation — default is 210.
   * - Target Percentage
     - target_percentage
     - integer
     - 0.05
     - 
     - Fractional tolerance around target_slope within which candidate segments are considered a match; default is 0.05 (5 %) — widen if the measured slope deviates from the nominal.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_offset_by_slip_output_1
     - curve_offset_by_slip_output_1
     - vector
     - The slip-corrected curve translated so that the identified linear region originates at x = 0; returned as an x-y vector pair in the same units as the input.

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=curve_offset_by_slip <https://www.d3view.com/api/workflow/example?id=curve_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>curve_offset_by_slip</code>. Schema hash: <code>cf3eb2c2292f</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>