.. _auto_lsdyna_d3plot_per_part_csv:

*LSDYNA D3PLOT PER-PART WIDE TIME-HISTORY CSV*
==============================================

Produces a 21-column wide CSV keyed by (time, part_id) with max plastic strain, max von Mises, internal / kinetic / hourglass energies, centroid xyz, mass*velocity, and rigid-body displacement / velocity / acceleration xyz. Three pluggable engines (Peacock C++, LS-PrePost cfile, BINOUT-only). Outputs the CSV attachment plus a provenance block (elapsed time, command, stdout, stderr, assembly status, summary log), an ontology graph (parts / assemblies / diagnoses), and a time-dependent Peacock js3d scene. Drives the Root Cause Analyzer's D3PLOT per-part adapter (R0-3691). Reference LSPP cfile: samples/lsdyna/extractors/d3view_perpart_csv.cfile.

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

Tagged: ``d3plot``, ``matsum``, ``per_part``, ``time_history``, ``wide_csv``, ``plastic_strain``, ``von_mises``, ``rigid_body``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - simulation_id
     - remote_lookup
     - —
     - 
     - Reference to the LS-DYNA simulation.
   * - Extraction method
     - method
     - string
     - auto
     - 
     - Engine used to populate the d3plot pieces. 'auto' tries Peacock C++, then BINOUT, then LSPP. 'binout' is matsum-only (max_eps_p / max_vm left null). 'lspp' returns the cfile when LS-PrePost is not on the host.
   * - Decimate to N states
     - decimate
     - integer
     - 200
     - 
     - Cap on the number of states emitted to the CSV and to the js3d scene. Even-spaced sampling, always includes state 0 and the last state.
   * - Max parts
     - max_parts
     - integer
     - 200
     - 
     - Hard cap on parts after filters and sort are applied.
   * - Assemblies (JSON)
     - assemblies
     - text
     - —
     - 
     - JSON array '[{"name":"Front Rail","part_ids":[101,103]}, ...]'. Drives the assembly_status block in provenance and the assembly grouping in the ontology + js3d outputs.
   * - Exclude part IDs
     - exclude_part_ids
     - text
     - —
     - 
     - Comma-separated part IDs to drop before extraction (e.g. '101,205').
   * - Exclude part names (glob)
     - exclude_part_names
     - text
     - —
     - 
     - Comma-separated glob patterns matched against part_name (e.g. 'rigid_*, *_dummy'). Case-insensitive.
   * - Min peak IE (% of total)
     - min_ie_pct_total
     - float
     - 0.0
     - 
     - Drop parts whose peak internal energy is below this percent of the model-total peak IE. 0 = no filter.
   * - Min peak IE (J)
     - min_ie_abs
     - float
     - 0.0
     - 
     - Drop parts whose peak internal energy is below this absolute J. 0 = no filter.
   * - Min peak KE (J)
     - min_ke_abs
     - float
     - 0.0
     - 
     - Drop parts whose peak kinetic energy is below this absolute J. 0 = no filter.
   * - Sort by
     - sort_by
     - string
     - ie
     - 
     - Column used to rank parts (by peak across time). The 'max_parts' cap is applied after this sort.
   * - Sort order
     - sort_order
     - string
     - desc
     - 
     - Ranking direction for sort_by.
   * - js3d scene — color by
     - scene_color_by
     - string
     - ie
     - 
     - Per-state metric mapped to color in the time-dependent js3d scene.
   * - js3d scene — size by
     - scene_size_by
     - string
     - max_eps_p
     - 
     - Per-state metric mapped to node size in the time-dependent js3d scene.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - CSV
     - csv
     - dataset
     - { columns, units, row_count, part_count, parts_kept, parts_dropped: { by_exclude_id, by_exclude_name, by_min_ie_pct, by_min_ie_abs, by_min_ke_abs }, sort_by, sort_order, state_decimate, csv_path, attachment_id, preview: [first 3 rows] }
   * - Provenance
     - provenance
     - dataset
     - { method (resolved), method_log: [str], elapsed_ms, command, stdout, stderr, assembly_status: [{ name, part_ids, parts_kept, parts_dropped, total_ie_J, pct_of_model_ie, peak_ie_part_id, peak_eps_p_part_id, diagnosis }], summary_log: [str] }
   * - Ontology Graph
     - ontology
     - dataset
     - { nodes: [{ id, type ('simulation'/'assembly'/'part'/'diagnosis'), label, attrs }], edges: [{ source, target, rel: 'BELONGS_TO'/'OBSERVED_ON' }], rule_library_version }. Drops straight into the Response Extractor's Ontology tab.
   * - Peacock js3d Scene (time-dependent)
     - scene_3d
     - dataset
     - { attachment_id, url, scene_format: 'peacock-js3d/1.0', scene_type: 'time_series_graph', frame_count, t_start, t_end, color_by, color_scale, size_by, preview_thumb_url }. Full scene body is the attachment (type 'peacock_scene_perpart_t'), consumable by js3d-loader-peacock-v3.js.

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

- cae.postprocessing.extraction
- cae.postprocessing.response

.. raw:: html

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