.. _auto_study_verify_parameters:

*VERIFIES THE PARAMETERS IN THE STUDY*
======================================

Validates the parameters defined in a d3VIEW study against an expected dataset, identifying mismatches and errors. Use this worker to catch configuration drift or parameter inconsistencies before submitting a study for execution.

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

Tagged: ``diff``, ``parameters``, ``responses``, ``study``, ``validation``, ``verification``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Study Id
     - study_id
     - remote_lookup
     - —
     - ✓
     - Unique identifier of the target study, selected via remote lookup from the available studies registry; required to locate the parameter set to verify.
   * - Parameters
     - parameters
     - dataset
     - —
     - ✓
     - Dataset containing the expected parameter names and values to validate against the study's current configuration; each row represents one parameter entry.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Status
     - status
     - text
     - Overall verification result as a plain-text string (e.g. 'PASS' or 'FAIL'), summarising whether all parameters matched successfully.
   * - Dataset with Differences
     - diff_dataset
     - dataset
     - Tabular dataset listing every parameter with a detected discrepancy, including the expected value, actual value, and error type for each mismatch.
   * - Total Errors by Name
     - diff_sum
     - keyvalue
     - Key-value map grouping the total number of errors by parameter name, useful for quickly identifying the most problematic parameters.
   * - Statuses
     - statuses
     - keyvalue
     - Key-value map of per-parameter verification statuses (e.g. 'OK', 'MISSING', 'MISMATCH'), providing fine-grained pass/fail detail for each checked parameter.

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

- cae.postprocessing.response
- platform.workflow

.. raw:: html

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