.. _auto_curve_downsize:

*CURVE DOWNSIZE*
================

Reduces the number of points in a curve by iteratively removing samples whose derivative range falls within a configurable band threshold, preserving the essential shape while discarding low-information points. Use this worker to compress large time-history curves before downstream processing or storage.

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

Classification: **process**.

Tagged: ``curve``, ``decimation``, ``derivative_band``, ``downsize``, ``point_reduction``, ``resampling``, ``time_history``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve 1
     - curve1
     - vector
     - —
     - 
     - Input curve (X/Y vector) to be downsized; typically a time-history signal such as force, acceleration, or displacement.
   * - Band Size
     - band_size
     - scalar
     - 0.05
     - 
     - Derivative-range threshold (dimensionless, default 0.05) — points whose local derivative variation falls within this band are considered redundant and removed; increase to aggressively reduce point count, decrease to preserve more detail.
   * - Num Iterations
     - num_iterations
     - scalar
     - 1
     - 
     - Number of successive downsizing passes to apply (integer, default 1); increase for more aggressive reduction at the cost of potential shape distortion.
   * - Window Sizer
     - window_size
     - scalar
     - 0
     - 
     - Size of the sliding window used to compute the local derivative range (default 0 lets the algorithm choose automatically); interpreted as a physical interval or a point count depending on window_type.
   * - Window Sizer
     - window_type
     - scalar
     - value
     - 
     - Interpretation of window_size: 'value' treats it as a physical X-axis interval (e.g., time in seconds), 'length' treats it as a raw point count; default is 'value'.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_downsize_output_1
     - curve_downsize_output_1
     - vector
     - Downsized output curve (X/Y vector) containing only the retained points that preserve the essential shape of the input curve after the specified number of downsizing iterations.

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

- data.curve.transform
- data.signal_processing

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

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

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