.. _auto_simulation_export_result_geometry:

*EXPORTS SIMULATION GEOMETRY INTO A DATASET*
============================================

Parses a 3D simulation geometry file (e.g., LS-DYNA d3plot) using LS-PrePost, extracts node coordinates, element connectivity, and per-component result fields (plastic strain, von-Mises stress, pressure) across selected states, and packages the data into a compressed JS3D archive. Use this worker to convert solver post-processing output into a structured 3D dataset for downstream visualization or analysis.

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

Tagged: ``3d_dataset``, ``connectivity``, ``d3plot``, ``dynain``, ``files``, ``geometry_export``, ``js3d``, ``ls-prepost``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - simulation_id
     - remote_lookup
     - —
     - ✓
     - d3VIEW simulation record ID used to locate attached geometry files and BOM graph; must reference a valid solver result set.
   * - Choose Geometry File for Export
     - primary_geometry_file
     - remote_lookup
     - —
     - ✓
     - Attachment ID (or name) of the primary geometry file attached to the simulation — for LS-DYNA this is typically the d3plot file; resolved via the simulation's attachment list.
   * - Parts
     - parts
     - textarea
     - all
     - ✓
     - Comma-separated part IDs whose geometry should be exported; use the special value 'all' (default) to include every part.
   * - Post-processor Binary Path
     - post_bin
     - textarea
     - —
     - 
     - Absolute path to a custom LS-PrePost binary; leave blank to use the platform-configured default executable.
   * - Commands
     - commands
     - textarea
     - —
     - 
     - Raw LS-PrePost command string to execute; if left empty the worker auto-generates commands based on the selected parts, components, and state range.
   * - Components to Export
     - components
     - select
     - 7
     - 
     - One or more result component IDs to export: 1 = pressure, 7 = Plastic Strain (default), 9 = von-Mises Stress; accepts a multi-select or comma-separated list.
   * - State Increment
     - increment
     - scalar
     - 10
     - 
     - State sampling interval — only states whose index is divisible by this integer are exported; default is 10.
   * - Last State
     - last_state
     - scalar
     - 1000
     - 
     - Index of the last simulation state to include in the export; default is 1000.
   * - Save 3D File to Simulation
     - save_file_to_sim
     - select
     - no
     - 
     - Whether to attach the generated JS3D ZIP file back to the source simulation record; set to 'yes' to persist the file, default is 'no'.
   * - Custom File Name
     - custom_file_name
     - text
     - —
     - 
     - Optional custom base filename for the output JS3D ZIP archive; if omitted, the simulation name is used and '.js3d.zip' is appended automatically.
   * - Connectivity command
     - con_cmd
     - textarea
     - 1:1000:1 4 0 1 0 0 0
     - 
     - Raw LS-PrePost 'output' command suffix for writing node/element connectivity (dynain); default '1:1000:1 4 0 1 0 0 0' — override only when non-standard state ranges or flags are needed.
   * - Component command
     - ccm_cmd
     - textarea
     - 1:1000:1 1 0 1 0 1 1 1 1 1 1 1 0 0 0 1.000000
     - 
     - Raw LS-PrePost 'output' command suffix for per-component result files; if empty, the worker constructs a default command using the state range and increment settings.
   * - Parse nodal info into datasets
     - parse_nodal_data
     - select
     - no
     - 
     - 
   * - Length for PID
     - pid_len
     - text
     - 8
     - 
     - In cases of non-D3PLOT this may need to be 9 or higher

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulation Id
     - simulation_id
     - scalar
     - Pass-through of the input simulation ID, enabling downstream workers to chain on the same simulation record.
   * - NodesAndConnectivity.js3d.zip
     - peacock_file
     - hyperlink
     - Hyperlink to the generated 'NodesAndConnectivity.js3d.zip' archive containing parsed node coordinates, element connectivity, and component result data ready for 3D visualization.
   * - Bill of Materials
     - bom
     - tree
     - Bill-of-Materials tree structure derived from the simulation's BOM graph, describing part hierarchy and assembly relationships associated with the exported geometry.

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

- cae.postprocessing.extraction
- cae.postprocessing.visualization
- data.io.archive
- data.io.file
- engineering.crash.dynamics

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