.. _auto_dic_sim_one_state:

*COMPARES DIC DATA CSV WITH SIMULATION*
=======================================

Compares a single DIC (Digital Image Correlation) CSV snapshot against the corresponding LS-DYNA simulation state by spatially aligning point clouds and computing displacement fields. Use this worker to validate simulation accuracy against physical full-field measurement data at one specific animation state.

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

Tagged: ``csv``, ``d3plot``, ``dic``, ``displacement``, ``ls-dyna``, ``one_state``, ``point_cloud``, ``sim_vs_test``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - DIC CSV File
     - dic_file_csv
     - file
     - —
     - ✓
     - CSV file exported from the DIC system containing full-field surface point coordinates and displacement measurements for the specimen.
   * - DTSDC
     - dic_time_state_disp_csv
     - textarea
     - —
     - ✓
     - Comma-separated mapping table (pasted as text) that relates DIC time steps to simulation states and displacement offsets; used to synchronise the two data sources.
   * - Simulation ID
     - simulation_id
     - remote_lookup
     - —
     - ✓
     - Platform simulation record ID (resolved via remote lookup) that identifies the LS-DYNA run whose d3plot data will be compared against the DIC snapshot.
   * - DIC Rotation Deg
     - rotation_deg
     - text
     - 90
     - 
     - In-plane rotation (degrees) applied to the DIC point cloud before alignment with the simulation mesh; default 90° corrects the typical camera-to-model orientation difference.
   * - Point Increment
     - point_increment
     - text
     - 4
     - 
     - Stride used when sub-sampling the DIC point cloud (every Nth point is retained); default 4 reduces memory and runtime while preserving spatial resolution for most specimens.
   * - Time Scale
     - time_scale
     - text
     - 1.0
     - 
     - Scalar multiplier applied to DIC timestamps to convert them to simulation time units (e.g. ms → s); leave at default 1.0 when both sources share the same time unit.
   * - DIC Top Percent
     - top_dic_percent
     - text
     - 1
     - 
     - Fraction (0–1) of the highest-strain DIC points retained for correlation; default 1 keeps all points, reduce to focus the comparison on the most-deformed region.
   * - D3PLOT Anim State
     - d3plot_anim_state
     - text
     - -1.0
     - 
     - Target d3plot animation state index to extract from the simulation for comparison; default -1.0 selects the final state, set to a positive integer to target a specific frame.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Js3d File
     - js3d_file
     - integer
     - Interactive 3-D JS3D attachment file rendering the overlaid DIC and simulation displacement fields side-by-side for visual correlation review in the platform viewer.

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

- ai_ml.vision
- cae.postprocessing.extraction
- cae.postprocessing.visualization
- data.correlation
- data.io.csv

.. raw:: html

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