.. _auto_js3d_write_file:

*THIS FUNCTION EXTRACTS THE FRINGE VARIABLES FROM D3PLOTS AND RETURNS THEM IN A 3D COMPACT FORM THAT CAN BE VIEWED IN A WEB BROWSER*
====================================================================================================================================

Extracts fringe variables (e.g. von Mises stress, effective plastic strain, triaxiality, displacement) from LS-DYNA d3plot binary databases and converts them into a compact JS3D file for interactive 3D visualization in a web browser. Use this worker to generate browser-viewable 3D contour/fringe animations directly from d3plot results.

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

Classification: **process**.

Tagged: ``3d_visualization``, ``contour``, ``d3plot``, ``displacement``, ``eps``, ``fringe``, ``js3d``, ``ls-dyna``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - File Name
     - filename
     - string
     - d3plot
     - 
     - Base name of the d3plot file to read (default: 'd3plot'); used with the File Condition to locate the correct result file on disk.
   * - File Condition
     - file_condition
     - string
     - eq
     - 
     - String-matching rule applied to the file name when searching for d3plot files; options are 'eq' (exact match, default), 'starts_with', 'ends_with', or 'anywhere'.
   * - Output Filename Name
     - outputfilenamename
     - string
     - output.js3d
     - 
     - Name of the output JS3D file that will be written (default: 'output.js3d'); must include the .js3d extension.
   * - First State
     - first_state
     - scalar
     - 1
     - 
     - Integer index of the first d3plot state (time step) to include in the extraction (default: 1, i.e. the first available state).
   * - Last State
     - last_state
     - scalar
     - 9999
     - 
     - Integer index of the last d3plot state to include; set to a large sentinel value (default: 9999) to capture all available states.
   * - Increment
     - increment
     - scalar
     - 1
     - 
     - Step increment between extracted states (default: 1); increase to sub-sample states and reduce output file size.
   * - Fringe Variables
     - fringe_variables
     - scalar
     - eps
     - 
     - Fringe quantity to embed in the JS3D file; choose from 'vm' (von Mises stress), 'eps' (effective plastic strain, default), 'triaxiality', or 'disp' (resultant displacement).
   * - Parts
     - parts
     - text
     - —
     - 
     - 

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - js3d_write_file_output_1
     - js3d_write_file_output_1
     - view
     - Browser-renderable JS3D view file containing the extracted 3D fringe contour data for all requested states; open directly in d3VIEW's web 3D viewer.

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

- cae.postprocessing.extraction
- cae.postprocessing.visualization

.. raw:: html

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