.. _auto_math_inspect_dual:

*INSPECT THE DUAL VALUES AND RETURN PASS-FAIL*
==============================================

Combines two scalar values using a dual arithmetic operation (add, subtract, divide, or power), optionally scales the result, then evaluates a comparison criterion to return a configurable pass or fail string. Use this worker whenever you need a two-operand numeric check with a single pass/fail outcome.

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

Classification: **process**.

Tagged: ``comparison``, ``criteria``, ``dual``, ``inspect``, ``math``, ``pass-fail``, ``scalar``, ``scale``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Value
     - value
     - scalar
     - —
     - 
     - First scalar operand (dimensionless numeric); paired with the second value before the dual operation is applied — leave null if not yet available.
   * - Value
     - value
     - scalar
     - —
     - 
     - First scalar operand (dimensionless numeric); paired with the second value before the dual operation is applied — leave null if not yet available.
   * - Dualcriteria
     - dualcriteria
     - string
     - d_sub
     - 
     - Arithmetic operation applied to the two input values before threshold comparison: d_add (value1 + value2), d_sub (value1 − value2, default), d_divide (value1 / value2), or d_power (value1 ^ value2).
   * - Scale Factor
     - scalefactor
     - scalar
     - 1.0
     - 
     - Multiplicative scale factor applied to the dual-operation result before the threshold comparison; defaults to 1.0 (no scaling); set to 0 to fall back to 1.0.
   * - Criteria
     - criteria
     - string
     - gt
     - 
     - Comparison operator used to evaluate the scaled dual result against criteriaval: lt, lte, eq, gt (default), gte, or between.
   * - Criteriaval
     - criteriaval
     - float
     - 0
     - 
     - Threshold value (float) against which the scaled dual result is compared; defaults to 0.
   * - Fail Return Type
     - fail_return_type
     - string
     - no
     - 
     - String token returned when the comparison fails (e.g. '0' or 'no'); configure to match downstream pass/fail labelling conventions.
   * - Pass Return Type
     - pass_return_type
     - string
     - yes
     - 
     - 

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - math_inspect_dual_output_1
     - math_inspect_dual_output_1
     - scalar
     - Scalar pass/fail result string: returns the configured pass string when the scaled dual result satisfies the criterion, or the configured fail string otherwise.

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

- data.curve.transform
- 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_dual <https://www.d3view.com/api/workflow/example?id=math_inspect_dual>`_

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