.. _auto_simulation_export_js3d:

*SIMULATION EXPORT JS3D*
========================

Exports a JS3D visualization archive from a simulation's d3plot results by running peacock (d3plot_input task), together with a per-part CSV bill of materials (per_part_csv task). Returns the JS3D zip for download plus the per-part BOM as a dataset.

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

Tagged: ``js3d``, ``d3plot``, ``peacock``, ``export``, ``bom``, ``per_part``, ``visualization``, ``post_processing``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - simulation_id
     - remote_lookup
     - —
     - ✓
     - The simulation whose d3plot results will be exported.
   * - File pattern
     - file_pattern
     - text
     - d3plot
     - 
     - Substring used to pick the result files among the simulation's files. Defaults to d3plot, which matches the whole d3plot family.
   * - Peacock tasks
     - tasks
     - text
     - d3plot_input,per_part_csv
     - 
     - Comma-separated peacock tasks to run. Defaults to the JS3D export plus the per-part BOM.
   * - Threads
     - threads
     - integer
     - 4
     - 
     - Number of threads peacock uses.
   * - Extra flags
     - extra_flags
     - text
     - —
     - 
     - Optional extra command-line flags passed to peacock.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - JS3D Archive
     - js3d_archive
     - file
     - Zip archive of the generated JS3D (click to download).
   * - Per-Part BOM
     - bom
     - dataset
     - Per-part rows from perpart.csv (one row per part per state).
   * - BOM Rows
     - bom_rows
     - scalar
     - Number of BOM rows.
   * - Status
     - status
     - string
     - What was exported, or why nothing was.

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

- platform.post_processing
- data.visualization

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