.. _auto_math_inspect:

*INSPECT THE VALUE AND RETURN PASS-FAIL*
========================================

Evaluates a scalar value against a configurable comparison criterion (lt, lte, eq, gt, gte, between) and returns a user-defined pass or fail token. Use this worker to gate workflow branches on numeric thresholds or to annotate KPI results with pass/fail labels.

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

Classification: **process**.

Tagged: ``comparison``, ``criteria``, ``gate``, ``inspect``, ``kpi``, ``pass-fail``, ``scalar``, ``threshold``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Value
     - value
     - scalar
     - —
     - 
     - The numeric scalar to be evaluated against the criterion; leave null if the value will be wired in dynamically from an upstream worker output.
   * - Criteria
     - criteria
     - string
     - gt
     - 
     - Comparison operator applied to the input value: lt (<), lte (≤), eq (=), gt (>), gte (≥), or between; defaults to gt.
   * - Criteriaval
     - criteriaval
     - float
     - 0
     - 
     - The reference threshold (float) against which the input value is compared; for the 'between' operator this should be the lower bound; defaults to 0.
   * - Fail Return Type
     - fail_return_type
     - string
     - no
     - 
     - Token returned when the value fails the criterion; choose from '0', 'no', or 'fail' to match downstream consumers; defaults to 'no'.
   * - Pass Return Type
     - pass_return_type
     - string
     - yes
     - 
     - Token returned when the value passes the criterion; choose from '1', 'yes', or 'pass' to match downstream consumers; defaults to 'yes'.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - math_inspect_output_1
     - math_inspect_output_1
     - scalar
     - Scalar string token indicating the evaluation result — the configured pass token (e.g. 'yes', '1', 'pass') if the criterion is satisfied, or the configured fail token (e.g. 'no', '0', 'fail') otherwise.

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

- data.statistics
- platform.workflow

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

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

.. raw:: html

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