.. _auto_curves_get_cyclic_data:

*CURVES GET CYCLIC DATA*
========================

Extracts cyclic (loading/unloading) segment data from one or more input curves, optionally filtering by a specific cycle number and data direction. Use this worker to isolate individual or all loading, unloading, or combined cycles from hysteresis-type curves, with optional axis scaling and negative-x suppression before extraction.

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

Classification: **process**.

Tagged: ``cycle extraction``, ``cyclic``, ``fatigue``, ``hysteresis``, ``loading``, ``material testing``, ``unloading``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve In
     - curves_in
     - vector
     - —
     - 
     - One or more input curves (vector) from which cyclic data will be extracted; typically force-displacement or stress-strain hysteresis curves.
   * - Scale X
     - scale_x
     - scalar
     - 1
     - 
     - Multiplicative scale factor applied to the x-axis values before cycle extraction; default is 1.0 (no scaling). Use to convert units (e.g., ms → s).
   * - Scale Y
     - scale_y
     - scalar
     - 1
     - 
     - Multiplicative scale factor applied to the y-axis values before cycle extraction; default is 1.0 (no scaling). Use to convert units (e.g., N → kN).
   * - Skip Negative
     - ignore_negative_x
     - scalar
     - yes
     - 
     - When set to 'yes' (default), x-axis data points with negative values are skipped after scaling before cycle detection; set to 'no' to retain all x values.
   * - CN-WBAC
     - cyclenumber
     - scalar
     - -1
     - 
     - Integer index of the specific cycle to extract; set to -1 (default) to extract all detected cycles from the curve.
   * - Type Of Data To Extract
     - type_of_data_to_extract
     - scalar
     - loading_unloading
     - 
     - Selects which portion of each cycle to return: 'loading_unloading' (default, full cycle), 'loading' (ascending segment only), or 'unloading' (descending segment only).

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_get_cyclic_data_output_1
     - curves_get_cyclic_data_output_1
     - vector
     - Collection of extracted cyclic curve segments (vector), one entry per detected cycle (or the selected cycle), each containing only the requested loading/unloading portion after axis scaling.

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

- data.curve.pair
- data.curve.transform
- engineering.durability
- 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_cyclic_data <https://www.d3view.com/api/workflow/example?id=curves_get_cyclic_data>`_

.. 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_cyclic_data</code>. Schema hash: <code>23459841be43</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>