.. _auto_curves_get_optimum_dig_points:

*GET OPTIMUM DIG POINTS*
========================

Evaluates a set of candidate digitisation (dig) point counts against one or more input curves and returns the single optimum number of dig points that best represents each curve's shape. Use this worker when you need to determine the most efficient point-count for curve re-sampling or data reduction.

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

Classification: **process**.

Tagged: ``curve_sampling``, ``data_reduction``, ``dig_points``, ``optimum_points``, ``resampling``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve
     - curve
     - vector
     - —
     - ✓
     - One or more input curves (X/Y vector pairs) to be evaluated; supply at least one curve — multiple curves are accepted for batch optimisation.
   * - Dig Points evaluate
     - points
     - text
     - 1,10,100
     - ✓
     - Comma-separated list of candidate dig-point counts to evaluate (e.g. '1,10,100'); defaults to '1,10,100' — extend or refine this list to narrow the search range.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Optimum Point
     - optimum_point
     - dataset
     - Dataset containing the optimum dig-point count(s) selected from the candidate list — one result row per input curve, indicating the point count that best preserves the curve's shape with minimum redundancy.

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=curves_get_optimum_dig_points <https://www.d3view.com/api/workflow/example?id=curves_get_optimum_dig_points>`_

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