.. _auto_simulation_verify_parameters:

*VERIFIES THE PARAMETERS IN THE SIMULATION*
===========================================

Verifies the parameters of a simulation by comparing them against a reference parameter dataset and reporting any discrepancies. Use this worker to validate that a simulation's configured parameters match expected values before or after a run.

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

Tagged: ``diff``, ``parameter_check``, ``responses``, ``simulation``, ``validation``, ``verification``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation Id
     - simulation_id
     - remote_lookup
     - —
     - ✓
     - Unique identifier for the target simulation, resolved via remote lookup (primary key: remote_lookup_simulations); required to locate the simulation whose parameters will be verified.
   * - Reference Parameters
     - parameters
     - dataset
     - —
     - ✓
     - Reference parameter dataset (tabular) containing the expected parameter names and values against which the simulation's actual parameters will be compared; required.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Status
     - status
     - text
     - Plain-text summary of the verification outcome (e.g., 'PASS' or 'FAIL with N differences'), indicating whether all parameters matched.
   * - Dataset with Differences
     - diff_dataset
     - dataset
     - Tabular dataset listing every parameter that differs between the simulation and the reference, including both the expected and actual values for each discrepancy.
   * - Total Errors by Name
     - diff_sum
     - keyvalue
     - Key-value map aggregating the total number of errors grouped by parameter name, useful for quickly identifying which parameters are most frequently mismatched.
   * - Parameters that are difference
     - diff_parameters
     - keyvalue
     - Key-value map enumerating each individual parameter that differs, with its name as the key and the observed discrepancy as the value.

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